Documentation
AI Power Ups documentation
Two ways in: connect an assistant you already use, or build an application that calls explicit search capabilities with typed requests, documented response envelopes and explicit costs.
Connect an assistant
Claude, ChatGPT, Gemini, command-line clients and IDEs connect over MCP. The assistant discovers capabilities itself and follows results with you.
Connect an assistantBuild with the API
One REST call per capability, a typed request body per capability, a stable response envelope with documented record keys, explicit costs, and follow-ups by id. Generate a client from the public OpenAPI document; no model in the loop.
Start with the quickstartHow the API works
- Pick a capability from the reference (for example
hotels.search) and build its request body from the documented schema. - Execute with
POST /v1/capabilities/<id>/execute. You get asearch_id, result records withrecord_ids, the charge and your balance. - Follow up with
POST /v1/follow-up: the next page, a changed query, or a record action such asdetails.
The machine-readable contract is https://api.powerups-ai.store/v1/openapi.public.json (OpenAPI 3.1, one operation per capability, contract revision 2026-09-22). These pages are generated from the same contracts.
Capabilities
Web and news
- web.search — Web search
- web.read — Read a web page
- news.search — News
Research and reading
- academic.search — Academic search
- scripture.search — Scripture search
- classics.search — Classic texts
- books.search — Book search
- patents.search — Patents
- github.search — GitHub search
- companies.financials — Company filings
- legal.search — Legal sources
- legal.read — Original legal texts
Media and social
- music.search — Music search
- youtube.search — YouTube search
- social.search — Social search
Travel and places
- weather.forecast — Weather forecast
- navigation.route — Route
- navigation.matrix — Distance matrix
- hotels.search — Hotel search
- flights.search — Flight search
- places.search — Places
- transit.routes — Public transport
Commerce and markets
- shopping.search — Shopping
- markets.quote — Markets & companies
- jobs.search — Jobs
- realestate.search — Real estate
- trends.search — Trends
Food and fitness
- recipes.search — Food & recipes
- fitness.exercises — Fitness
Read next
- Sessions, paging and records: what a
search_idholds, how long it lives, whatupdatedoes. - Credits and limits: what a call costs, the one-call-at-a-time rule, rate limits and timeouts.
- Errors and retries: the envelope, every code, and when a retry is safe or billed.
- Stability and versioning: which parts of a response are contract and which are provider-shaped.
- Types and HTTP clients: generate TypeScript types and use openapi-fetch, curl or standard-library Python.