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 Premium Report 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: Premium Report
paths:
/v1/premium_report:
post:
operationId: premium_report
summary: Premium country or topic report
description: 'Brouky''s premium reports: a full country report (market, rounds, investors, sectors, cohorts) or a topic report (e.g. spacetech, climate: sub-topics, geography, active investors, stages). Returns whether this account can open it and the link. Free on paid plans; otherwise 10 credits per report, charged once, and `unlock: true` spends them. Ask the user before unlocking. Leave `name` out with kind "topic" to list the topics. For the numbers inside a chat, country_overview is free.
Credits per call: 10. Scope: finder.'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
kind:
type: string
enum:
- country
- topic
name:
type: string
description: The country ("Czech Republic") or topic ("spacetech", "climate tech").
unlock:
type: boolean
description: Spend the credits to unlock it. Only when the user asked for it.
required:
- kind
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:
- Premium Report
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_...).