Brouky Find Investors API

openapi: 3.2.0
info:
  title: Brouky Find Investors 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: Find Investors
paths:
  /v1/find_investors:
    post:
      operationId: find_investors
      summary: Find investors for a startup (AI VC Finder)
      description: 'Brouky AI VC Finder (investor matcher): ranks the investors that best fit a startup, by their real investment history: sector and tag overlap, stage, geography, check size and portfolio twins. Give the startup''s website, or describe it. Returns up to 50 ranked investors with a fit % and the reasons, match-overview charts (their deal activity in your sector, stages, locations) and a link to the full report. Free accounts get one run with the top 5 matches; paid plans get up to 50 matches for 3 credits a run. Brouky classifies the startup itself; `sector`, `subsectors` and `tags` override that classification.


        Credits per call: 3. Scope: finder.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                website:
                  type: string
                  description: The startup's website, e.g. https://example.com. Leave out (with description) to use the user's own startup on Brouky.
                startup:
                  type: string
                  description: Which of the user's own startups, if they have several and give no website.
                description:
                  type: string
                  description: What the startup does, if there is no website (1-3 sentences).
                raising_stage:
                  type: string
                  enum:
                  - pre-seed
                  - seed
                  - series-a
                  - series-b
                  - series-c-plus
                  description: The round being raised now.
                investor_region:
                  type: string
                  description: 'Where investors should be based: europe, eu, cee, dach, nordics, north america, n america, us, uk, apac, asia, latam, mena, africa, global.'
                investor_countries:
                  type: array
                  items:
                    type: string
                  description: Explicit investor HQ countries (wins over investor_region).
                sector:
                  type: string
                  enum:
                  - Artificial Intelligence & Data
                  - Commerce & Marketing
                  - Consumer, Lifestyle & Services
                  - Energy, Environment & Mobility
                  - Finance & Blockchain
                  - Healthcare & Life Sciences
                  - Industry & Hardware
                  - Software & Developer Tools
                  description: Primary sector of the startup. Overrides the Brouky classification.
                subsectors:
                  type: array
                  items:
                    type: string
                  description: Subsectors, e.g. ["generative media", "adtech"].
                tags:
                  type: array
                  items:
                    type: string
                  description: Specific themes, e.g. ["generative video", "advertising", "film production"].
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
                  default: 20
      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:
      - Find Investors
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_...).