Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Brouky Ask API
version: 1.0.0
description: 'Venture intelligence for investors and startups: an AI data agent over Brouky''s database, the AI VC Finder, and investor, startup and market data. The same operations are available as an MCP server.'
contact:
url: https://brouky.tech/dashboard/developers
servers:
- url: https://api.brouky.tech/functions/v1/brouky-api
security:
- bearer: []
tags:
- name: Ask
paths:
/v1/ask:
post:
operationId: ask
summary: Ask Brouky
description: 'Answer any question about investors, startups, funding rounds and markets in plain language. Brouky''s data agent writes and runs the queries over its database of investors, startups and funding rounds since 2020, and returns the answer, the result rows and ready-made charts. Use for counts, rankings, trends and lists, e.g. "seed rounds in the Czech Republic by year" or "most active fintech investors in Germany in 2025". Paid plans: 1 credit per question.
Credits per call: 1. Scope: ask.'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
query:
type: string
description: The question, 3-500 characters.
minLength: 3
maxLength: 500
required:
- query
responses:
'200':
description: Result
content:
application/json:
schema:
$ref: '#/components/schemas/Result'
'400':
description: Invalid input
'401':
description: Missing or invalid key
'402':
description: Not enough credits
'403':
description: Key lacks the scope, or plan required
'429':
description: Rate limited
tags:
- Ask
components:
schemas:
Result:
type: object
properties:
success:
type: boolean
operation:
type: string
data:
type: object
description: Operation-specific structured result.
summary:
type: string
description: A short readable answer.
charts:
type: array
description: 'Chart specs (RichChartSpec: type, title, xKey, series, data, unit).'
items:
type: object
url:
type:
- string
- 'null'
description: The full interactive view on brouky.tech.
credits:
type:
- object
- 'null'
properties:
charged:
type: integer
remaining:
type:
- integer
- 'null'
securitySchemes:
bearer:
type: http
scheme: bearer
description: Your key from /dashboard/developers (brk_live_...).