Brouky Startups Raising Next API

openapi: 3.2.0
info:
  title: Brouky Startups Raising Next 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: Startups Raising Next
paths:
  /v1/startups_raising_next:
    post:
      operationId: startups_raising_next
      summary: Startups about to raise (deal flow)
      description: 'For investors: startups in the fund''s stage focus that are approaching their next round, with the round they should raise next and why (time since last round, momentum, team, filed revenue against the benchmark for that round, runway). Same as Next-round predictions on the website: shows what the fund already unlocked; `unlock_more: true` reveals 5 more for 10 credits (paid plans see up to 200 without credits). Ask the user before unlocking.


        Credits per call: 10. Scope: finder.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                stages:
                  type: array
                  items:
                    type: string
                    enum:
                    - pre-seed
                    - seed
                    - series-a
                    - series-b
                    - series-c-plus
                  description: Stage focus. Defaults to the fund's saved focus.
                country:
                  type: string
                  description: Only startups based here (exact country name, e.g. "Czech Republic").
                min_raised_eur:
                  type: number
                  description: Only startups that raised at least this much in total.
                filed_accounts_only:
                  type: boolean
                  description: Only startups with filed financial statements.
                unlock_more:
                  type: boolean
                  description: Spend 10 credits to reveal 5 more startups. Only when the user asked for it.
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
                  default: 20
                  description: How many to return (best scored first).
      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:
      - Startups Raising Next
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_...).