{"openapi":"3.1.0","info":{"title":"Vela Breakout API","version":"1.0.0","description":"What is growing in tech, measured daily. Every figure arrives in words with its unit, window and caveat. From your account's credit, a company lookup costs $0.01 and a ranked list $0.02; the group list is free; failed calls, not-found calls and empty answers (a 200 whose list is empty) cost nothing. Rate card: https://breakout.vela.partners/pricing (Markdown: https://breakout.vela.partners/pricing.md)."},"servers":[{"url":"https://breakout.vela.partners/api/v1"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"A key from https://breakout.vela.partners/account"}}},"paths":{"/groups":{"get":{"operationId":"list_groups","summary":"Groups and what they measure","description":"Every group you can rank, with its unit, caveat and usual window. Free.","responses":{"200":{"description":"The answer as JSON; free when its list is empty"},"400":{"description":"Bad input"},"401":{"description":"Missing or unknown key"},"402":{"description":"Out of credit"},"404":{"description":"No such company or group; not charged"},"429":{"description":"Over 120 calls a minute"}},"parameters":[]}},"/breakouts":{"get":{"operationId":"find_breakouts","summary":"Fastest growers in one group","description":"The fastest-growing items of one group (AI apps, AI models, open models, agent tools and skills, editor and browser extensions, business software, web technologies, hiring and more) over a window, each with its growth, before and now values, peer percentile and a link to its chart. Only items at least the group's median size by default, so tiny starts do not dominate.","responses":{"200":{"description":"The answer as JSON; free when its list is empty"},"400":{"description":"Bad input"},"401":{"description":"Missing or unknown key"},"402":{"description":"Out of credit"},"404":{"description":"No such company or group; not charged"},"429":{"description":"Over 120 calls a minute"}},"parameters":[{"name":"group","in":"query","required":true,"schema":{"type":"string","enum":["ai_apps","ai_models","ai_labs","ai_work","open_models","editor_extensions","open_editor_extensions","workplace_add_ons","browser_extensions","agent_skills","agent_tools","company_packages","business_software","web_technologies","company_hiring","company_buzz"]}},{"name":"window_days","in":"query","required":false,"schema":{"anyOf":[{"type":"number","const":7},{"type":"number","const":30},{"type":"number","const":90},{"type":"number","const":365}]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25}},{"name":"min_size","in":"query","required":false,"schema":{"type":"string","enum":["median","p75","none"]}},{"name":"steady","in":"query","required":false,"schema":{"type":"boolean"}}]}},"/company":{"get":{"operationId":"get_company","summary":"One company, every signal","description":"Everything measured about one company by name or web domain: each signal's growth and how it compares with its peers.","responses":{"200":{"description":"The answer as JSON; free when its list is empty"},"400":{"description":"Bad input"},"401":{"description":"Missing or unknown key"},"402":{"description":"Out of credit"},"404":{"description":"No such company or group; not charged"},"429":{"description":"Over 120 calls a minute"}},"parameters":[{"name":"name_or_domain","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":120}}]}},"/ideas":{"get":{"operationId":"research_ideas","summary":"Research ideas gaining or losing ground","description":"AI research ideas by change in their share of all new papers, last 3 months against the 3 before, with the companies publishing on each.","responses":{"200":{"description":"The answer as JSON; free when its list is empty"},"400":{"description":"Bad input"},"401":{"description":"Missing or unknown key"},"402":{"description":"Out of credit"},"404":{"description":"No such company or group; not charged"},"429":{"description":"Over 120 calls a minute"}},"parameters":[{"name":"direction","in":"query","required":true,"schema":{"type":"string","enum":["rising","fading"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25}}]}},"/rising-companies":{"get":{"operationId":"rising_companies","summary":"Companies rising on several measures","description":"Companies growing faster than 90% of their peers on two or more measures at once, ranked by how much.","responses":{"200":{"description":"The answer as JSON; free when its list is empty"},"400":{"description":"Bad input"},"401":{"description":"Missing or unknown key"},"402":{"description":"Out of credit"},"404":{"description":"No such company or group; not charged"},"429":{"description":"Over 120 calls a minute"}},"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25}}]}},"/ask":{"post":{"operationId":"ask","summary":"Ask what's growing","description":"Answer a plain-language question about what is growing in tech with checked figures, charts as data and links. Costs the language model's bill plus 20%, from credit.","responses":{"200":{"description":"The answer as JSON; free when its list is empty"},"400":{"description":"Bad input"},"401":{"description":"Missing or unknown key"},"402":{"description":"Out of credit"},"404":{"description":"No such company or group; not charged"},"429":{"description":"Over 120 calls a minute"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"question":{"type":"string","minLength":3,"maxLength":300}},"required":["question"],"additionalProperties":false}}}}}}}}