{"openapi":"3.1.0","info":{"title":"Austin AI Live API","version":"1.0.0","summary":"Read-only data on AI companies in Austin, Texas, plus Austin AI events and jobs.","description":"Public, read-only, no key needed. Only verified (active) companies are included. Responses are cached for about 5 minutes. When you use this data, please cite the company's Austin AI Live page (its `url` field) or https://austinai.live. An MCP server with the same data is at https://austinai.live/mcp.","contact":{"name":"Austin AI Live","url":"https://austinai.live/developers"}},"externalDocs":{"description":"Developer guide","url":"https://austinai.live/developers"},"servers":[{"url":"https://austinai.live/api/v1"}],"paths":{"/overview":{"get":{"operationId":"getOverview","summary":"Headline counts for the Austin AI ecosystem","responses":{"200":{"description":"Counts.","content":{"application/json":{"schema":{"type":"object","required":["generated_at","source","overview"],"properties":{"generated_at":{"type":"string","format":"date-time","description":"When this response was built."},"source":{"$ref":"#/components/schemas/Source"},"overview":{"$ref":"#/components/schemas/Overview"}}}}}},"503":{"description":"Database temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/status":{"get":{"operationId":"getStatus","summary":"Whether the MCP server is on, its limits, and usage counts for this server instance","responses":{"200":{"description":"Status.","content":{"application/json":{"schema":{"type":"object","required":["generated_at","source","mcp"],"properties":{"generated_at":{"type":"string","format":"date-time","description":"When this response was built."},"source":{"$ref":"#/components/schemas/Source"},"mcp":{"type":"object"}}}}}}}}},"/companies":{"get":{"operationId":"listCompanies","summary":"List active Austin AI companies","description":"Sorted by name. Filters match the map's. By default only companies on the map; on_map=false lists companies Austin AI Live tracks only for their Austin AI jobs (no tier, no offices), on_map=all both.","parameters":[{"name":"on_map","in":"query","schema":{"type":"string","enum":["true","false","all"],"default":"true"},"description":"true = on the Austin AI Live map; false = listed only for their AI jobs; all = both."},{"name":"tier","in":"query","schema":{"type":"string","enum":["native","powered"]},"description":"native = would not exist without AI; powered = AI is real and material, but the business is not AI."},{"name":"layer","in":"query","schema":{"type":"string","enum":["builds","applies"]},"description":"builds = sells AI itself (models, chips, tools, infra); applies = sells an outcome AI powers."},{"name":"hq","in":"query","schema":{"type":"boolean"},"description":"true = headquartered in Austin; false = Austin office, HQ elsewhere."},{"name":"new","in":"query","schema":{"type":"boolean"},"description":"true = added to Austin AI Live in the last 7 days."},{"name":"q","in":"query","schema":{"type":"string","maxLength":100},"description":"Free text matched against name, description, classification note, and domain."},{"name":"limit","in":"query","description":"Page size (default 50, max 200).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","description":"Items to skip. Follow `next` instead of computing it yourself.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"A page of companies.","content":{"application/json":{"schema":{"type":"object","required":["generated_at","source","items","total","limit","offset","next"],"properties":{"generated_at":{"type":"string","format":"date-time","description":"When this response was built."},"source":{"$ref":"#/components/schemas/Source"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Company"}},"total":{"type":"integer","description":"Matching items across all pages."},"limit":{"type":"integer"},"offset":{"type":"integer"},"next":{"type":["string","null"],"format":"uri","description":"URL of the next page, or null on the last page."}}}}}},"400":{"description":"Invalid parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Database temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/companies/{slug}":{"get":{"operationId":"getCompany","summary":"Get one company by slug (on the map, or listed for its AI jobs)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The company.","content":{"application/json":{"schema":{"type":"object","required":["generated_at","source","company"],"properties":{"generated_at":{"type":"string","format":"date-time","description":"When this response was built."},"source":{"$ref":"#/components/schemas/Source"},"company":{"$ref":"#/components/schemas/Company"}}}}}},"404":{"description":"No active company with that slug.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Database temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/events":{"get":{"operationId":"listUpcomingEvents","summary":"Upcoming Austin AI events, soonest first","description":"Cached daily from the public feed of https://austinai.events. Each event has its own page (page_url).","parameters":[{"name":"company","in":"query","description":"Only items for this company slug.","schema":{"type":"string"}},{"name":"limit","in":"query","description":"Page size (default 50, max 200).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","description":"Items to skip. Follow `next` instead of computing it yourself.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"A page of events.","content":{"application/json":{"schema":{"type":"object","required":["generated_at","source","items","total","limit","offset","next"],"properties":{"generated_at":{"type":"string","format":"date-time","description":"When this response was built."},"source":{"$ref":"#/components/schemas/Source"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Event"}},"total":{"type":"integer","description":"Matching items across all pages."},"limit":{"type":"integer"},"offset":{"type":"integer"},"next":{"type":["string","null"],"format":"uri","description":"URL of the next page, or null on the last page."}}}}}},"400":{"description":"Invalid parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Database temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/jobs":{"get":{"operationId":"listJobs","summary":"Jobs on the Austin AI Live board, newest first","description":"Two views, like the board's \"Pick your view\". view=ai_companies (default): jobs at Austin AI companies on the map, meaning every Austin role at AI-native companies and AI roles only at AI-powered ones. view=all: AI roles only, at any Austin company, on the map or not (company.on_map). Open jobs by default, newest first by first_seen_at (when Austin AI Live first saw them). Closed jobs only with status=closed or status=all. The same filters as https://austinai.live/jobs.","parameters":[{"name":"view","in":"query","schema":{"type":"string","enum":["ai_companies","all"],"default":"ai_companies"},"description":"ai_companies = jobs at Austin AI companies; all = AI roles at any Austin company."},{"name":"company","in":"query","description":"Only items for this company slug.","schema":{"type":"string"}},{"name":"role","in":"query","schema":{"type":"string","enum":["engineering","research","data","product","design","sales_marketing","operations","other"]},"description":"Role type."},{"name":"seniority","in":"query","schema":{"type":"string","enum":["intern_new_grad","mid","senior","lead_staff","leadership"]},"description":"Seniority."},{"name":"workplace","in":"query","schema":{"type":"string","enum":["onsite","hybrid","remote"]},"description":"onsite = in Austin; hybrid; remote."},{"name":"industry","in":"query","schema":{"type":"string","examples":["health","defense_government","energy","finance","chips_hardware","robotics","enterprise_software","consumer","education","other"]},"description":"An industry the company serves: health, defense_government, energy, finance, chips_hardware, robotics, enterprise_software, consumer, education, other."},{"name":"tier","in":"query","schema":{"type":"string","enum":["native","powered"]},"description":"The company's AI tier."},{"name":"layer","in":"query","schema":{"type":"string","enum":["builds","applies"]},"description":"The company's AI layer."},{"name":"skill","in":"query","schema":{"type":"string","examples":["llms_agents","computer_vision","robotics","speech","ml_infra","data_analytics","chips_hardware","research","other"]},"description":"An AI skill area: llms_agents, computer_vision, robotics, speech, ml_infra, data_analytics, chips_hardware, research, other."},{"name":"pay","in":"query","schema":{"type":"boolean"},"description":"true = only postings that list pay."},{"name":"hq","in":"query","schema":{"type":"boolean"},"description":"true = company headquartered in Austin; false = Austin office, HQ elsewhere."},{"name":"status","in":"query","schema":{"type":"string","enum":["open","closed","all"],"default":"open"},"description":"Closed jobs are listed only when asked for."},{"name":"limit","in":"query","description":"Page size (default 50, max 200).","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","description":"Items to skip. Follow `next` instead of computing it yourself.","schema":{"type":"integer","minimum":0,"default":0}}],"responses":{"200":{"description":"A page of jobs.","content":{"application/json":{"schema":{"type":"object","required":["generated_at","source","items","total","limit","offset","next"],"properties":{"generated_at":{"type":"string","format":"date-time","description":"When this response was built."},"source":{"$ref":"#/components/schemas/Source"},"items":{"type":"array","items":{"$ref":"#/components/schemas/Job"}},"total":{"type":"integer","description":"Matching items across all pages."},"limit":{"type":"integer"},"offset":{"type":"integer"},"next":{"type":["string","null"],"format":"uri","description":"URL of the next page, or null on the last page."}}}}}},"400":{"description":"Invalid parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Database temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/jobs/{id}":{"get":{"operationId":"getJob","summary":"Get one job by id, open or closed","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"The job.","content":{"application/json":{"schema":{"type":"object","required":["generated_at","source","job"],"properties":{"generated_at":{"type":"string","format":"date-time","description":"When this response was built."},"source":{"$ref":"#/components/schemas/Source"},"job":{"$ref":"#/components/schemas/Job"}}}}}},"404":{"description":"No job on the board with that id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Database temporarily unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Source":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"},"docs":{"type":"string","format":"uri"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","properties":{"status":{"type":"integer"},"message":{"type":"string"}}}}},"Office":{"type":"object","required":["lat","lng","is_hq"],"properties":{"label":{"type":["string","null"]},"building_name":{"type":["string","null"]},"address":{"type":["string","null"]},"lat":{"type":"number","description":"WGS84 degrees."},"lng":{"type":"number","description":"WGS84 degrees."},"is_hq":{"type":"boolean"},"opened_year":{"type":["integer","null"]},"closed_year":{"type":["integer","null"],"description":"Set when the office has closed."}}},"Company":{"type":"object","required":["slug","name","url","logo","austin_hq","new_this_week","listed_at","offices"],"properties":{"slug":{"type":"string","description":"Stable id; never changes once a company is listed."},"name":{"type":"string"},"url":{"type":"string","format":"uri","description":"The company's Austin AI Live page. Cite this."},"website":{"type":["string","null"],"format":"uri"},"domain":{"type":["string","null"]},"logo":{"type":"string","format":"uri"},"description":{"type":["string","null"]},"ai_tier":{"type":["string","null"],"enum":["native","powered",null]},"ai_layer":{"type":["string","null"],"enum":["builds","applies",null]},"classification_note":{"type":["string","null"],"description":"One line on why it got its tier and layer."},"austin_hq":{"type":"boolean","description":"Headquartered in Austin."},"austin_since_year":{"type":["integer","null"],"description":"Year the company came to Austin."},"new_this_week":{"type":"boolean"},"listed_at":{"type":"string","format":"date-time","description":"When Austin AI Live first listed it."},"on_map":{"type":"boolean","description":"False for a company listed only for its Austin AI jobs (no tier, no offices)."},"has_public_office":{"type":"boolean","description":"True when an Austin office is listed (an address and a pin on the map). False for a company that is based in Austin or has a team here but publishes no office address (no pin), and for companies off the map."},"offices":{"type":"array","items":{"$ref":"#/components/schemas/Office"}}}},"Event":{"type":"object","required":["id","page_url","title","start_time","venue","companies"],"properties":{"id":{"type":"string"},"page_url":{"type":"string","format":"uri","description":"This event's page on Austin AI Live. Cite this link."},"title":{"type":"string"},"description":{"type":["string","null"]},"start_time":{"type":"string","format":"date-time"},"end_time":{"type":["string","null"],"format":"date-time"},"url":{"type":["string","null"],"format":"uri","description":"Registration link."},"source_url":{"type":["string","null"],"format":"uri","description":"Austin AI Events (austinai.events), the calendar it comes from."},"organizer":{"type":["string","null"]},"venue":{"type":"object","properties":{"name":{"type":["string","null"]},"address":{"type":["string","null"]},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]}}},"is_free":{"type":["boolean","null"]},"audience_type":{"type":["array","null"],"items":{"type":"string"}},"technical_level":{"type":["string","null"]},"companies":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["host","sponsor","speaker","venue"]},"url":{"type":"string","format":"uri"}}}}}},"Job":{"type":"object","required":["id","page_url","title","url","company","skill_areas","locations","first_seen_at","status"],"properties":{"id":{"type":"string","format":"uuid"},"page_url":{"type":"string","format":"uri","description":"This job's page on Austin AI Live. Cite this link."},"title":{"type":"string"},"url":{"type":"string","format":"uri","description":"The posting on the company's site, tagged with Austin AI Live as the source."},"company":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri","description":"The company's Austin AI Live page."},"page_url":{"type":"string","format":"uri","description":"Same as url."},"on_map":{"type":"boolean","description":"False for a company listed only for its Austin AI jobs."}}},"summary":{"type":["string","null"],"description":"2-3 lines in Austin AI Live's own words."},"role_type":{"type":["string","null"],"enum":["engineering","research","data","product","design","sales_marketing","operations","other",null]},"seniority":{"type":["string","null"],"enum":["intern_new_grad","mid","senior","lead_staff","leadership",null]},"skill_areas":{"type":"array","items":{"type":"string"}},"workplace":{"type":["string","null"],"enum":["onsite","hybrid","remote",null]},"locations":{"type":"array","items":{"type":"string"},"description":"Every place the posting lists."},"location_text":{"type":["string","null"]},"department":{"type":["string","null"],"description":"Team or department."},"pay":{"type":["object","null"],"description":"Null when the posting lists no pay.","properties":{"min":{"type":["number","null"]},"max":{"type":["number","null"]},"currency":{"type":["string","null"]},"period":{"type":["string","null"],"enum":["year","month","hour",null]}}},"first_seen_at":{"type":"string","format":"date-time","description":"When Austin AI Live first saw the posting."},"posted_at":{"type":["string","null"],"format":"date-time","description":"The source's own posting date; an estimate."},"status":{"type":"string","enum":["open","closed"]},"closed_at":{"type":["string","null"],"format":"date-time"}}},"Overview":{"type":"object","properties":{"companies":{"type":"integer"},"with_public_office":{"type":"integer","description":"Companies with an Austin office listed (a pin on the map)."},"by_tier":{"type":"object","properties":{"native":{"type":"integer"},"powered":{"type":"integer"},"unclassified":{"type":"integer"}}},"by_layer":{"type":"object","properties":{"builds":{"type":"integer"},"applies":{"type":"integer"},"unclassified":{"type":"integer"}}},"austin_hq":{"type":"integer"},"new_this_week":{"type":"integer"},"upcoming_events":{"type":"integer"},"open_jobs":{"type":"integer","description":"Open roles at Austin AI companies on the map (the board's default view)."},"open_ai_jobs_all_companies":{"type":"integer","description":"Open AI roles at any Austin company (view=all)."}}}}}}