{"openapi":"3.1.0","info":{"title":"Whizbrew","version":"1","summary":"Live marketing data tools for AI agents, paid per call that returns data.","description":"Whizbrew is one MCP server and one API for 893 live marketing data tools in 25 groups, paid per call: a typical call costs $0.002 ($2 per 1,000 calls), prices run from $0.001 to $0.52 a call, only a call that returns data is charged (an empty or failed call is free), and there is no subscription. A new account starts with $2 of free credit, about 1,000 typical calls, with no card. Errors: https://whizbrew.com/errors.md?a=75c77ce44cc3. The catalogue is not listed here tool by tool: read it at /v1/tools."},"servers":[{"url":"https://whizbrew.com"}],"externalDocs":{"description":"Docs","url":"https://whizbrew.com/docs?a=75c77ce44cc3"},"paths":{"/v1/tools":{"get":{"operationId":"listTools","summary":"The catalogue: every tool with inputs, output, price, health and measured success rate. No key.","security":[],"responses":{"200":{"description":"The catalogue.","content":{"application/json":{"schema":{"type":"object","properties":{"tools":{"type":"array","items":{"$ref":"#/components/schemas/Tool"}}}}}}}}}},"/v1/call/{tool}":{"parameters":[{"name":"tool","in":"path","required":true,"schema":{"type":"string"},"example":"tiktok.profile","description":"A tool name from /v1/tools."}],"post":{"operationId":"callTool","summary":"Calls one tool. Charged the tool's price only when it returns data.","security":[{"bearer":[]}],"parameters":[{"name":"X-Tapi-Max-Cost-Micros","in":"header","schema":{"type":"integer"},"description":"Refuse the call, free, when its price is above this many millionths of a dollar."},{"name":"Idempotency-Key","in":"header","schema":{"type":"string"},"description":"A name of your own for this call: sent again with the same key, a charged call answers from store, free, for 24 hours."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"The tool's arguments (its `input` in /v1/tools)."},"example":{"handle":"nasa"}}}},"responses":{"200":{"description":"The answer. `meta.outcome` is hit (data, charged) or miss (nothing found, free).","headers":{"X-Tapi-Cost-Micros":{"schema":{"type":"integer"},"description":"What this call cost, in millionths of a dollar."},"X-Tapi-Balance-Micros":{"schema":{"type":"integer"}},"X-Tapi-Outcome":{"schema":{"type":"string","enum":["hit","miss","error"]}},"X-Tapi-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"callToolGet","summary":"The same call with the arguments in the query string.","security":[{"bearer":[]}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/balance":{"get":{"operationId":"getBalance","summary":"The credit that is left. Free.","security":[{"bearer":[]}],"responses":{"200":{"description":"The balance in millionths of a dollar.","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/usage":{"get":{"operationId":"getUsage","summary":"The account's latest calls with outcome and price. Free.","security":[{"bearer":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":50}}],"responses":{"200":{"description":"The calls.","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/limits":{"get":{"operationId":"getLimits","summary":"The spending caps of the account and of this key, and what was spent. Free.","security":[{"bearer":[]}],"responses":{"200":{"description":"Caps and spending.","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/requests":{"post":{"operationId":"requestTool","summary":"Tells the team what the user asked for that no tool serves. Free.","security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["request"],"properties":{"request":{"type":"string"},"platform":{"type":"string"},"searched":{"type":"string"}}}}}},"responses":{"200":{"description":"Stored.","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/guide":{"get":{"operationId":"getQuote","summary":"A free quote for a task in plain words: the tools that do it, the calls in order, the price, the cash needed. No key. Never spends.","security":[],"parameters":[{"name":"goal","in":"query","required":true,"schema":{"type":"string"},"description":"The task in plain words."},{"name":"quantity","in":"query","schema":{"type":"integer","default":1},"description":"How many calls you expect."},{"name":"budget_usd","in":"query","schema":{"type":"number"},"description":"What your human allows."},{"name":"format","in":"query","schema":{"type":"string","enum":["md"]},"description":"md: the same as Markdown."}],"responses":{"200":{"description":"`matched`, `tools`, `calls`, `estimate`, `next`.","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/start":{"post":{"operationId":"startAgent","summary":"An account without an email and a key that works at once with the free credit. No key needed. The agent's human claims it later.","security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agent":{"type":"string","description":"The agent's name."}}}}}},"responses":{"201":{"description":"`api_key` (shown once), `claimed`, `balance_usd`, `expires_at`, `next`.","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/topup":{"post":{"operationId":"addMoney","summary":"A hosted card checkout link for the agent's human, and a status address to poll.","security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount_usd"],"properties":{"amount_usd":{"type":"number"}}}}}},"responses":{"200":{"description":"`checkout_url`, `status_url`, `min_usd`, `max_usd`, `next`.","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent/claim":{"post":{"operationId":"claimAccount","summary":"The agent's human takes the account over: `{email}` answers a link for the human, `{code}` (what the page showed them) finishes it.","security":[{"bearer":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"code":{"type":"string"}}}}}},"responses":{"200":{"description":"`status`, `claim_url` or the finished claim, `next`.","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/pair/start":{"post":{"operationId":"startPairing","summary":"An agent without a key starts a pairing. No key. Its user opens the link and approves.","security":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agent":{"type":"string","description":"The agent's name, shown to the user."},"client":{"type":"string"}}}}}},"responses":{"200":{"description":"`user_code`, `verification_url_complete` (give it to the user), `device_code` (secret, for polling), `interval`, `expires_in`.","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/pair/poll":{"post":{"operationId":"pollPairing","summary":"Polls a pairing. `approved` carries the new `api_key`, once.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["device_code"],"properties":{"device_code":{"type":"string"}}}}}},"responses":{"200":{"description":"`pending` or `approved`.","content":{"application/json":{"schema":{"type":"object"}}}},"default":{"description":"An error. Never charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"An API key, or an OAuth access token of the MCP door."}},"schemas":{"Tool":{"type":"object","properties":{"name":{"type":"string"},"group":{"type":"string"},"description":{"type":"string"},"input":{"type":"object","description":"Argument name to {type, description, required, default, enum, min, max}."},"output":{"type":"string"},"price_micros":{"type":"integer"},"price_usd":{"type":"number"},"price_by":{"type":"object","description":"Set when the price depends on one argument."},"available":{"type":"boolean"},"state":{"type":"string","enum":["up","degraded","down","temporarily_unavailable"]},"stats":{"type":"object","description":"From real calls, per window: calls, works_pct, hit_pct, median_ms, p90_ms."}}},"Answer":{"type":"object","properties":{"data":{"description":"The tool's answer."},"meta":{"type":"object","properties":{"outcome":{"type":"string","enum":["hit","miss","error"]},"price_micros":{"type":"integer"},"balance_micros":{"type":"integer"},"request_id":{"type":"string"}}}}},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"kind":{"type":"string"},"message":{"type":"string"},"blame":{"type":"string","enum":["caller","us","source"]},"hint":{"type":"string"},"retry_after_s":{"type":"integer"}}}}}}}}