> ## Documentation Index
> Fetch the complete documentation index at: https://api.tryspecter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI search

> Search Specter with a plain-English query. Describe what you're looking for,
such as "high-growth fintech companies in Germany founded after 2022" or "VC
investors focused on climate", and the endpoint turns it into a structured
search and returns the matching records.

<Note>
Costs 1 credit per result. A page of 25 results uses 25
credits. To check how many records match before fetching them, send the
query with `limit=1` and read `total_count` (or the `X-Total-Count` header).
You'll only be charged for that one result.
</Note>

## What you need

A plain-English query. Optionally set `product` to force which product to
search; omit it and Specter infers the best product from your query. No IDs
or prior setup are required.

## Supported products and return types

All eight products are searchable, and each result is the same object that
product's own endpoints return, so you parse it the same way. Pass a
`product` value to get the matching object:

| `product` | Returns |
| --- | --- |
| `company` | [Company](/api-reference/companies/get-company-by-id) |
| `people` | [Person](/api-reference/people/get-person-by-id) |
| `investors` | [Investor](/api-reference/investors/get-investor-by-id) |
| `talent_signals` | [Talent signal](/api-reference/talent-signals/get-talent-signal-by-id) |
| `interest_signals` | [Investor-interest signal](/api-reference/investor-interest-signals/get-investor-interest-signal-by-id) |
| `funding_rounds` | [Funding round](/api-reference/transactions/get-funding-round-by-id) |
| `acquisitions` | [Acquisition](/api-reference/transactions/get-acquisition-by-id) |
| `ipos` | [IPO](/api-reference/transactions/get-ipo-by-id) |

## Supported filters

Any filter a product supports can be expressed in the query: geography,
sector, growth stage, funding, headcount, revenue, seniority, dates,
"similar to" a company, and "backed by" an investor.

<Warning>
User-scoped filters aren't supported. The API runs at the organization level, not per user, so filters like "your network," "your CRM," or "your saved lists" won't work. Requests using them return a `422` error. Remove these filters and use standard attributes instead.
</Warning>

## Behaviour

- The search is organization-scoped. It is not saved as a saved search, but the
  response returns a `query_id` that identifies the structured filters the query
  resolved to (identical queries share an id).
- Paginate with the `page` and `limit` query parameters. Totals are returned both
  on the body (`total_count`) and via the `X-Total-Count` and `Link` response
  headers.
- `query` must be non-empty, and an unknown `product` value is rejected with a
  `422`.

## What you do next

- **Get the full record.** Every result carries its ID. Pass it to that
  product's by-ID endpoint: a `company` result to
  [Get company by ID](/api-reference/companies/get-company-by-id), an
  `investors` result to
  [Get investor by ID](/api-reference/investors/get-investor-by-id).
- **Save results to a list.** Add companies with
  [Create company list](/api-reference/company-lists/create-company-list),
  or people with
  [Create people list](/api-reference/people-lists/create-people-list).




## OpenAPI

````yaml /api-ref/bundle_api.yaml post /search
openapi: 3.0.0
info:
  title: Specter API
  termsOfService: https://tryspecter.com/terms/
  contact:
    name: API support
    email: api-support@tryspecter.com
  version: 1.0.0
servers:
  - description: Production
    url: https://app.tryspecter.com/api/v1
security:
  - ApiKeyAuth: []
tags:
  - name: Enrich
    description: >
      Look up a company, person, or investor and, if Specter does not already
      hold it, fetch it on demand. Includes email-based person enrichment.
  - name: Search
    description: |
      Find records across every product from a single plain-English query.
  - name: Companies
    description: >
      Company profiles, funding, headcount, traction, the per-company signals
      and sub-resources attached to a single company, and identifier resolution.
  - name: People
    description: >
      Specter people records: profile data, contact details, and per-person
      lookups for a known person ID.
  - name: Investors
    description: >
      Specter investor records: profile, activity, targeting, funds, portfolio
      companies, and the funding rounds they have participated in.
  - name: Transactions
    description: |
      Transaction detail by ID: funding rounds, acquisitions, and IPOs.
  - name: News Signals
    description: |
      Company-level news signals: by ID, and for a saved list or company search.
  - name: Revenue Signals
    description: >
      Revenue and profitability signals: by ID, by date, and for a saved list or
      company search.
  - name: Talent Signals
    description: |
      Talent signals: by ID and in bulk by ID.
  - name: Investor Interest Signals
    description: |
      Investor interest signals: by ID and in bulk by ID.
  - name: Company Lists
    description: |
      Create, query, and maintain lists of companies, including their results.
  - name: Investor Lists
    description: |
      Create, query, and maintain lists of investors, including their results.
  - name: People Lists
    description: |
      Create, query, and maintain lists of people, including their results.
  - name: Saved Searches
    description: |
      List and delete searches saved via tryspecter.com.
  - name: Company Saved Searches
    description: |
      Details and results for saved company searches.
  - name: People Saved Searches
    description: |
      Details and results for saved people searches.
  - name: Investor Saved Searches
    description: |
      Details and results for saved investor searches.
  - name: Talent Signals Saved Searches
    description: |
      Details and results for saved Talent Signals searches.
  - name: Investor Interest Saved Searches
    description: |
      Details and results for saved Investor Interest Signals searches.
  - name: Network
    description: >
      Your team's LinkedIn network: the people and companies your teammates are
      connected to, and your reach into a given company.
  - name: Account
    description: >
      Organisation-level resources: your team's members, API call logs, and
      credit balance.
paths:
  /search:
    post:
      tags:
        - Search
      summary: AI search
      description: >
        Search Specter with a plain-English query. Describe what you're looking
        for,

        such as "high-growth fintech companies in Germany founded after 2022" or
        "VC

        investors focused on climate", and the endpoint turns it into a
        structured

        search and returns the matching records.


        <Note>

        Costs 1 credit per result. A page of 25 results uses 25

        credits. To check how many records match before fetching them, send the

        query with `limit=1` and read `total_count` (or the `X-Total-Count`
        header).

        You'll only be charged for that one result.

        </Note>


        ## What you need


        A plain-English query. Optionally set `product` to force which product
        to

        search; omit it and Specter infers the best product from your query. No
        IDs

        or prior setup are required.


        ## Supported products and return types


        All eight products are searchable, and each result is the same object
        that

        product's own endpoints return, so you parse it the same way. Pass a

        `product` value to get the matching object:


        | `product` | Returns |

        | --- | --- |

        | `company` | [Company](/api-reference/companies/get-company-by-id) |

        | `people` | [Person](/api-reference/people/get-person-by-id) |

        | `investors` | [Investor](/api-reference/investors/get-investor-by-id)
        |

        | `talent_signals` | [Talent
        signal](/api-reference/talent-signals/get-talent-signal-by-id) |

        | `interest_signals` | [Investor-interest
        signal](/api-reference/investor-interest-signals/get-investor-interest-signal-by-id)
        |

        | `funding_rounds` | [Funding
        round](/api-reference/transactions/get-funding-round-by-id) |

        | `acquisitions` |
        [Acquisition](/api-reference/transactions/get-acquisition-by-id) |

        | `ipos` | [IPO](/api-reference/transactions/get-ipo-by-id) |


        ## Supported filters


        Any filter a product supports can be expressed in the query: geography,

        sector, growth stage, funding, headcount, revenue, seniority, dates,

        "similar to" a company, and "backed by" an investor.


        <Warning>

        User-scoped filters aren't supported. The API runs at the organization
        level, not per user, so filters like "your network," "your CRM," or
        "your saved lists" won't work. Requests using them return a `422` error.
        Remove these filters and use standard attributes instead.

        </Warning>


        ## Behaviour


        - The search is organization-scoped. It is not saved as a saved search,
        but the
          response returns a `query_id` that identifies the structured filters the query
          resolved to (identical queries share an id).
        - Paginate with the `page` and `limit` query parameters. Totals are
        returned both
          on the body (`total_count`) and via the `X-Total-Count` and `Link` response
          headers.
        - `query` must be non-empty, and an unknown `product` value is rejected
        with a
          `422`.

        ## What you do next


        - **Get the full record.** Every result carries its ID. Pass it to that
          product's by-ID endpoint: a `company` result to
          [Get company by ID](/api-reference/companies/get-company-by-id), an
          `investors` result to
          [Get investor by ID](/api-reference/investors/get-investor-by-id).
        - **Save results to a list.** Add companies with
          [Create company list](/api-reference/company-lists/create-company-list),
          or people with
          [Create people list](/api-reference/people-lists/create-people-list).
      operationId: aiSearch
      parameters:
        - $ref: '#/components/parameters/PaginationPage'
        - name: limit
          in: query
          required: false
          description: The number of results to return per page (default 25, max 100).
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - query
              additionalProperties: false
              properties:
                product:
                  type: string
                  nullable: true
                  description: |
                    The product to search for. Omit to infer it from the query.
                  enum:
                    - company
                    - people
                    - talent_signals
                    - interest_signals
                    - investors
                    - funding_rounds
                    - acquisitions
                    - ipos
                  example: company
                query:
                  type: string
                  minLength: 1
                  description: A natural-language description of what to search for.
                  example: high-growth fintech companies in Germany founded after 2022
            example:
              product: company
              query: high-growth fintech companies in Europe
      responses:
        '200':
          $ref: '#/components/responses/SearchResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          description: >
            The request could not be processed: `query` is empty, `product` is
            unknown, or the query resolved to an unsupported user-scoped filter
            (your network, CRM, or saved lists). Remove the user-scoped
            constraint and search by attributes instead.
        '429':
          $ref: '#/components/responses/RateLimits'
components:
  parameters:
    PaginationPage:
      in: query
      name: page
      schema:
        type: number
      required: false
      description: The page number of results to return, base 0, default is 0.
  responses:
    SearchResponse:
      description: >
        The matching results. `product` reports the product that was actually
        searched: the request's `product` when one was provided, or the product
        inferred from the query otherwise. Every object in `items` is of the
        type that matches `product`.
      content:
        application/json:
          schema:
            type: object
            required:
              - items
              - product
              - query_id
              - total_count
              - web_url
            properties:
              query_id:
                type: integer
                description: >
                  Identifies the structured filters this natural-language query
                  resolved to. Identical queries share an id. The search itself
                  is not stored as a saved search.
                example: 254476
              total_count:
                type: integer
                description: >
                  Total number of matches across all pages (also returned as the
                  `X-Total-Count` response header).
                example: 56
              items:
                type: array
                description: >
                  The current page of results. Each item's type matches
                  `product`.
                items:
                  oneOf:
                    - $ref: '#/components/schemas/Company'
                    - $ref: '#/components/schemas/Person'
                    - $ref: '#/components/schemas/Talent'
                    - $ref: '#/components/schemas/InvestorInterest'
                    - $ref: '#/components/schemas/Investor'
                    - $ref: '#/components/schemas/PublicFundingRound'
                    - $ref: '#/components/schemas/PublicAcquisition'
                    - $ref: '#/components/schemas/PublicIpo'
              product:
                type: string
                enum:
                  - company
                  - people
                  - talent_signals
                  - interest_signals
                  - investors
                  - funding_rounds
                  - acquisitions
                  - ipos
                description: >-
                  The product that was searched - the requested `product`, or
                  the one inferred from the query when it was omitted. Every
                  object in `items` is of this type.
              web_url:
                type: string
                description: >-
                  Deep-link that opens this search in the Specter web app, with
                  the resolved filters pre-applied. Open it to refine, save,
                  export, or push the results to a CRM.
          example:
            product: company
            query_id: 84213
            total_count: 128
            items:
              - id: 1a2b3c4d5e6g1a2b3c4d5e6g
                organization_name: Hedgehog Analytics
                domain: hedgehog_analytics.com
                hq:
                  city: Berlin
                  country: Germany
                founded_year: 2022
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            oneOf:
              - $ref: '#/components/schemas/ApiKeyMissing'
              - $ref: '#/components/schemas/ApiKeyNotValid'
    Forbidden:
      description: Forbidden - There is no permissions to use the endpoint
      content:
        application/json:
          schema:
            type: object
            properties:
              errorCode:
                description: NOT_PERMITTED
                type: string
                example: NOT_PERMITTED
              message:
                type: string
                description: You do not have permission to access this resource.
                example: You do not have permission to access this resource.
            required:
              - errorCode
              - message
    RateLimits:
      description: Too Many Requests - API Rate limit exceeded
      content:
        application/json:
          schema:
            type: object
            required:
              - errorCode
              - message
            properties:
              errorCode:
                type: string
                description: RATE_LIMITED
              message:
                type: string
                description: You have been rate-limited
      headers:
        X-RateLimit-Limit:
          schema:
            type: integer
          description: The total rate limit allowed for this endpoint
        X-RateLimit-Remaining:
          schema:
            type: integer
          description: The number of requests remaining
        X-RateLimit-Reset:
          schema:
            type: number
            format: float
          description: The number of seconds until the rate limit resets
  schemas:
    Company:
      properties:
        id:
          description: The Specter ID for this company, can be used in other endpoints
          type: string
          example: 5e3bc2b700c8f4c966ad2bbd
        organization_name:
          description: The main public name for the organization.
          type: string
          example: Stripe
        organization_rank:
          description: The Specter rank for this company.
          type: number
          example: 459
        organization_name_aliases:
          description: A list of company names that are associated with this company.
          items:
            type: string
            example: Porcupine Analytics
          type: array
          example:
            - Porcupine, Analytics
            - Procupine AI
        primary_role:
          $ref: '#/components/schemas/Role'
          description: The primary role that this company has.
        roles:
          description: Other roles that the company may have.
          items:
            $ref: '#/components/schemas/Role'
          type: array
        description:
          description: A description for what the company does, and who they are.
          type: string
          example: >-
            Stripe provides programmable financial infrastructure that lets
            businesses accept payments, manage billing, and embed financial
            services into their products. It delivers this via
            developer-friendly APIs and products including Checkout, Elements,
            Payment Links, and the Stripe Dashboard, plus integrations for
            platforms and marketplaces. The platform supports a range of billing
            models, global payment methods and currencies, and fraud-prevention
            tools. Stripe is offered as cloud software for companies from
            startups to large enterprises and is used to power online and
            in-person commerce worldwide.
        tagline:
          description: A concise description that highlights what the company does.
          type: string
          example: >-
            Stripe provides financial infrastructure for businesses to accept
            payments and grow revenue.
        customer_focus:
          $ref: '#/components/schemas/CustomerFocus'
          description: The type of customers the company deals with.
        business_models:
          description: |
            The business models that the company operates under. 
            There can be up to 3 business models assigned to the same company.
          type: array
          items:
            type: string
          example:
            - usage-based
            - financial-services
            - saas
        certifications:
          description: Industry certifications like **HIPAA, GDPR**, and more.
          type: array
          items:
            type: string
          example:
            - HIPAA
            - GDPR
            - SOC 2
            - B Corp
            - ISO 27001
        customer_profile:
          description: |
            The company's typical customer profile to help understand the ideal
            customers for each company.
          type: string
          example: Companies accepting payments and managing revenue
        traction_highlights:
          description: >-
            Impact data reported by the clients on their growth, highlights,
            etc.
          type: string
          example: >-
            500M+ API requests per day,  99.999% uptime,  47+ countries,  135+
            currencies
        reported_clients:
          description: >
            A list of clients the company works with-these are Specter IDs that
            link 

            to other companies in our system.
          type: array
          items:
            type: string
          example:
            - 67fd9884fdd1ef17d57ce8e8
            - 6436a9450e469875f36d1bfa
            - 63217577ee34accf6616e328
            - 60424b664ddab8d8bf3cc359
            - 5f0c06d50eb04dccca13868b
            - 5e3bc29600c8f4c966acbdd9
            - 5e3bc25700c8f4c966abda2f
            - 5e3bc11000c8f4c966a72d6f
            - 5e3bc07400c8f4c966a4fdd5
            - 5e3bc07300c8f4c966a4f552
        last_updated:
          description: |
            A date for when the company was last updated in Specter.
            Uses the format YYYY-MM-DD.
          type: string
          format: date
          example: '2026-06-30'
        tags:
          description: |
            Tags taken from different sorts that are related to the company its 
            industry and what it does.
          items:
            type: string
          type: array
          example:
            - API
            - Billing
            - Connect
            - Financial Infrastructure
            - Fraud Prevention
            - Payments
            - Revenue Automation
            - SaaS
        industry:
          $ref: '#/components/schemas/Industry'
        tech_verticals:
          $ref: '#/components/schemas/TechVertical'
        operating_status:
          $ref: '#/components/schemas/OperatingStatus'
          description: The status of the company.
        highlights:
          $ref: '#/components/schemas/Highlights'
          description: All highlights (growth, funding, news, etc)
          example:
            - headcount_surge
            - no_recent_funding
            - strong_headcount_growth
            - strong_social_growth
            - strong_web_traffic_growth
            - top_tier_investors
        new_highlights:
          $ref: '#/components/schemas/Highlights'
          description: Highlights new to this month (growth, funding, news, etc)
          example:
            - headcount_surge
            - strong_headcount_growth
            - strong_social_growth
            - strong_web_traffic_growth
            - top_tier_investors
        regions:
          description: A list of regions that the company operates in.
          items:
            type: string
          type: array
          example:
            - North America
        founded_year:
          description: The year that the company was founded.
          type: number
          example: 2010
        founders:
          deprecated: true
          description: |
            The names of the founders. Deprecated, use the founder_info instead.
          items:
            type: string
          type: array
          example:
            - Asta L.
            - David Li
            - Liz Fitzgerald
        founder_info:
          description: Information about the founders.
          items:
            $ref: '#/components/schemas/CompanyFounders'
          type: array
        founder_count:
          description: The number of founders, equal to the length of the founders list.
          type: number
          example: 3
        employee_count:
          description: The number of employees the company currently has.
          type: number
          example: 15841
        employee_count_range:
          description: A range for how many the employees the company has.
          type: string
          enum:
            - 1-10
            - 11-50
            - 51-200
            - 201-500
            - 501-1000
            - 1001-5000
            - 5001-10000
            - 10001+
          example: 10001+
        investors:
          description: The list of investors who have invested in the company, can be none.
          items:
            type: string
          type: array
          example:
            - AXA Group
            - Aaron Levie
            - Abstract Labs LLC
            - All Blue Capital
            - Allen & Company
            - Allianz X
            - Alto
            - Alven
            - Amex Ventures
            - Andreessen Horowitz
        investor_count:
          description: >-
            The number of investors, same as the length of the list of
            investors.
          type: number
          example: 72
        patent_count:
          description: The number of patents that the company owns.
          type: number
          example: 292
        trademark_count:
          description: The number of trademarks the company has.
          type: number
          example: 104
        website:
          $ref: '#/components/schemas/Website'
          description: The website information related to the company.
        hq:
          $ref: '#/components/schemas/HQ'
          description: Location information about the companies HQ.
        contact:
          $ref: '#/components/schemas/Contact'
          description: General contact information for the company.
        acquisition:
          $ref: '#/components/schemas/Acquisition'
          description: >-
            If the company has been acquired, information about the acquisition
            is here.
        ipo:
          description: List of IPOs if there have been any.
          items:
            $ref: '#/components/schemas/IpoDetails'
          type: array
        growth_stage:
          $ref: '#/components/schemas/GrowthStage'
          description: Indicates what growth stage the company is in.
        funding:
          $ref: '#/components/schemas/Funding'
          description: Information about funding the company has received.
        web:
          $ref: '#/components/schemas/Web'
          description: Metrics related to the web, user visits, popularity, etc.
        technologies:
          description: A list of technologies that the company uses.
          items:
            type: string
          type: array
          example:
            - CDN JS
            - Cloudflare JS
            - CrUX Top 50m
            - DNSSEC
            - Font Awesome
            - Google Font API
            - Google Maps
            - IPv6
            - Mobile Non Scaleable Content
            - jsDelivr
        it_spend:
          description: The annual amount in USD ($) that the company spends on IT.
          type: number
          example: 418200000
        awards:
          description: A list of awards the company has received.
          items:
            $ref: '#/components/schemas/Awards'
          type: array
        award_count:
          description: >
            The number of awards the company has, same as the length of the
            awards 

            field.
          type: number
          example: 6
        news:
          description: >-
            A list of new items about the company. At current, this may not
            resemble what you see on the front end as it reflects News v1. The
            latest (Specter News v2) endpoints are coming soon.
          items:
            $ref: '#/components/schemas/News'
          type: array
        reviews:
          description: >
            Information about reviews of the website, and products that the
            company 

            has received through different sites (G2, Trustpilot, Chrome
            Extensions, etc)
          properties:
            g2:
              $ref: '#/components/schemas/G2Reviews'
            trustpilot:
              $ref: '#/components/schemas/TrustpilotReviews'
            chrome_extensions:
              $ref: '#/components/schemas/ChromeExtensionReviews'
            glassdoor:
              $ref: '#/components/schemas/GlassdoorReviews'
          required:
            - g2
          additionalProperties: false
          type: object
        socials:
          $ref: '#/components/schemas/Socials'
        traction_metrics:
          $ref: '#/components/schemas/TractionMetrics'
        specter_strategic_signal_ids:
          description: |
            List of Specter's strategic signal IDs
          type: array
          items:
            type: string
            example: adced32f-8a8b-495f-a8f3-333449769736
        founder_highlights:
          type: array
          description: >
            Notable attributes of the founding team - e.g. prior exits, prior
            VC-backed experience, strong technical background.
          items:
            type: string
          example:
            - fortune_500_experience
            - major_tech_experience
            - prior_vc_backed_experience
            - prior_vc_backed_founder
            - serial_founder
            - strong_technical_background
            - top_university
            - vc_backed_founder
        team_department_breakdown:
          type: array
          description: >
            Share of employees in each department. `percentage` is a fraction
            between 0 and 1.
          items:
            type: object
            additionalProperties: false
            properties:
              department:
                type: string
                example: BD & Marketing
              percentage:
                type: number
                example: 0.16
        team_location_breakdown:
          type: array
          description: Employee headcount by country.
          items:
            type: object
            additionalProperties: false
            properties:
              country:
                type: string
                example: Algeria
              employee_count:
                type: integer
                example: 1
      required:
        - contact
        - funding
        - hq
        - id
        - reviews
        - socials
        - web
        - website
      additionalProperties: false
      title: Company
      type: object
    Person:
      title: Person
      properties:
        person_id:
          description: >-
            The Specter person ID for this person, can be used in people
            endpoints.
          type: string
          example: per_34f8a8ad1f7497b83e821345
        talent_signal_ids:
          description: Talent signal IDs for this person, can be used in talent endpoints
          nullable: true
          items:
            type: string
            example: 02d32673-f1ab-40a1-93c5-a3a36a10d342
          type: array
          example:
            - 58323b85-153b-4d3d-8c0c-62dbf41198dc
        investor_signal_ids:
          nullable: true
          items:
            description: >
              Investor signal IDs for this person, will be usable in investor
              endpoints when available.
            type: string
            example: 0340bac8-bcee-46a2-94bf-cf77e0c34253
          type: array
        profile_picture_url:
          description: A url for a profile picture if there is one.
          nullable: true
          type: string
          example: >-
            https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_34f8a8ad1f7497b83e821345.jpg
        first_name:
          description: First name
          type: string
          example: Cosmin
        last_name:
          description: Last Name
          type: string
          example: Urdea
        full_name:
          description: Full name
          type: string
          example: Cosmin Urdea
        linkedin_url:
          description: URL for LinkedIn account.
          type: string
          example: https://www.linkedin.com/in/cosmin-urdea-0848973
        linkedin_num_id:
          description: The numeric ID for the LinkedIn account.
          type: number
          example: 11147428
        linkedin_urn:
          description: The URN from LinkedIn for the account.
          type: string
          example: ACoAAEULqT0BasKeraebkQhLfmIwxpxTlNThQjE
        twitter_url:
          description: URL for Twitter account.
          nullable: true
          type: string
          example: https://x.com/moissinac
        github_url:
          description: URL for Github account.
          nullable: true
          type: string
          example: https://github.com/sarahchen9776
        about:
          description: A description of the person.
          nullable: true
          type: string
          example: >-
            IT Software Consultant / Contractor 20+ years of experience in
            software development - Systems and Applications Architecture -
            Product Design / Management - Coach and mentorship Experience in
            various industries, but mostly in electronic payments. After a full
            carrier as a full stack developer and, later on, architect, I have
            decided to put my experience to use from a different perspective as
            Product Owner/Manager and it has been already 3 years and I am
            enjoying very much this new role.
        tagline:
          description: A shorter tagline for the person.
          nullable: true
          type: string
          example: Software Consultant / Contractor
        location:
          description: Where the person is located.
          nullable: true
          type: string
          example: Bucharest, București, Romania, Europe
        region:
          description: Main region where the person is located.
          nullable: true
          type: string
          example: Europe
        highlights:
          items:
            type: string
            example: prior_exit
          type: array
          description: |
            Type of highlight, the full list will be added shortly.
          example:
            - major_tech_experience
            - prior_vc_backed_experience
            - strong_technical_background
            - vc_backed_experience
        level_of_seniority:
          description: Top level of seniority the person has achieved.
          nullable: true
          type: string
          example: Senior Level
        years_of_experience:
          description: Years of experience the person has worked for.
          nullable: true
          type: number
          example: 21
        education_level:
          description: Top level of education that the person has.
          nullable: true
          type: string
          example: ''
        experience:
          type: array
          description: Companies that the person has worked for.
          items:
            $ref: '#/components/schemas/Experience'
        current_position_title:
          description: Title of the person's current position
          nullable: true
          type: string
          example: Senior Consultant Fintech & Digital Payment
        current_position_company_name:
          description: Name of the company where the person currently works.
          nullable: true
          type: string
          example: valantic (vormals mm1)
        current_position_company_website:
          description: Website for the company where the person currently works.
          nullable: true
          type: string
          example: mm1.com
        past_position_title:
          description: Title of the person's last position
          nullable: true
          type: string
          example: Product Owner (Contracted)
        past_position_company_name:
          description: Name of the company where the person last left.
          nullable: true
          type: string
          example: Riverty
        past_position_company_website:
          description: Website for the company where the person last left.
          nullable: true
          type: string
          example: riverty.com
        current_tenure:
          description: Length of time the person has been in their current job.
          nullable: true
          type: number
          example: 15
        average_tenure:
          description: Average length of time in a position.
          nullable: true
          type: number
          example: 22
        education:
          type: array
          description: Educational background for the person
          items:
            $ref: '#/components/schemas/Education'
        languages:
          description: Languages that the person speaks
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Language'
          example:
            - name: English
              proficiency_level: Native Or Bilingual Proficiency
            - name: Mandarin Chinese
              proficiency_level: Limited Working Proficiency
        skills:
          items:
            type: string
            example: Machine Learning
          description: List of skills that the person has.
          type: array
          example:
            - API Development
            - Agentic AI
            - Agentic Orchestration
            - Algorithmic Trading
            - Algorithms
            - Apache Spark
            - C#
            - C++
            - CORS
            - Communication
        linkedin_followers:
          description: Number of followers the person has on LinkedIn.
          type: number
          example: 904
        linkedin_connections:
          description: Number of connections the person has on LinkedIn.
          type: number
          example: 500
        last_updated:
          description: |
            A date for when the person was last updated in Specter.
            Uses the format YYYY-MM-DD HH:MM:SS.
          type: string
          example: '2026-07-13 17:37:30'
      required:
        - last_updated
        - person_id
      additionalProperties: false
      type: object
    Talent:
      properties:
        talent_signal_id:
          title: Talent.talent_signal_id
          description: Unique identifier for this talent signal
          type: string
          example: 2ac47f14-47d5-467d-bfde-4d903ebe9d59
        person_id:
          description: >-
            The Specter person ID for this person, can be used in people
            endpoints.
          type: string
          example: per_5a8db8da85166db285f6f15a
        signal_date:
          title: Talent.signal_date
          description: Date when the talent signal was detected
          type: string
          example: '2026-06-12'
        signal_score:
          title: Talent.signal_score
          description: Confidence score for this talent signal (1-10 scale)
          type: number
          example: 7
        signal_summary:
          description: A short summary of the signal
          type: string
          example: >-
            Ashish founded Mettle Capital for venture investments in Indian tech
            startups. Ashish was previously a Managing Director at Sequoia
            Capital and Peak XV Partners. Ashish has a strong track record of
            investing in companies like Groww, Zomato, and Oyo.
        signal_type:
          title: Talent.signal_type
          description: Type of talent signal detected
          type: string
          example: New Fund
        signal_status:
          title: Talent.signal_status
          description: Current status of the talent signal
          type: string
          example: Live
        out_of_stealth_advantage:
          title: Talent.out_of_stealth_advantage
          description: Advantage in months of detecting talent before public announcement
          nullable: true
          type: number
          example: 119
        announcement_delay_months:
          title: Talent.announcement_delay_months
          description: Number of months before the move was publicly announced
          nullable: true
          type: number
          example: 1
        talent_last_signal:
          title: Talent.talent_last_signal
          description: Whether this is the most recent signal for this person
          type: boolean
          example: true
        new_position_title:
          title: Talent.new_position_title
          description: Job title at the new position
          nullable: true
          type: string
          example: Founder
        new_position_company_id:
          title: Talent.new_position_company_id
          description: Company ID for the new position
          nullable: true
          type: string
          example: 6a30e77e25a5ea5395eb905a
        new_position_company_name:
          title: Talent.new_position_company_name
          description: Company name for the new position
          nullable: true
          type: string
          example: Mettle Capital
        new_position_company_website:
          title: Talent.new_position_company_website
          description: Website of the new position company
          nullable: true
          type: string
          example: mettlecap.com
        new_position_company_tagline:
          title: Talent.new_position_company_tagline
          description: Tagline or description of the new position company
          nullable: true
          type: string
          example: >-
            Wind River Capital Strategies offers independent advisory services
            for endowments and foundations.
        new_position_industry:
          $ref: '#/components/schemas/Industry'
        new_position_tech_verticals:
          $ref: '#/components/schemas/TechVertical'
        is_new_position_industry_estimated:
          type: boolean
          description: Whether the industry is estimated
          example: true
        past_position_company_id:
          title: Talent.past_position_company_id
          description: Company ID for the previous position
          nullable: true
          type: string
          example: 67daaaaa0b91647a62395992
        tags:
          title: Talent.tags
          description: Tags describing the new position, when available
          nullable: true
          type: array
          items:
            type: string
            example: saas
        talent_signal_ids:
          description: Talent signal IDs for this person, can be used in talent endpoints
          nullable: true
          items:
            type: string
            example: 02d32673-f1ab-40a1-93c5-a3a36a10d342
          type: array
          example:
            - 2ac47f14-47d5-467d-bfde-4d903ebe9d59
            - 3ad39797-da0e-4870-af89-14e1bdf8e105
        investor_signal_ids:
          nullable: true
          items:
            description: >
              Investor signal IDs for this person, will be usable in investor
              endpoints when available.
            type: string
            example: 0340bac8-bcee-46a2-94bf-cf77e0c34253
          type: array
        profile_picture_url:
          description: A url for a profile picture if there is one.
          nullable: true
          type: string
          example: >-
            https://peopledb-public.s3.eu-west-2.amazonaws.com/assets/profile-pictures/per_5a8db8da85166db285f6f15a.jpg
        first_name:
          description: First name
          type: string
          example: Ashish
        last_name:
          description: Last Name
          type: string
          example: Agrawal
        full_name:
          description: Full name
          type: string
          example: Ashish Agrawal
        linkedin_url:
          description: URL for LinkedIn account.
          type: string
          example: https://www.linkedin.com/in/ashish-agrawal-ba3a706
        twitter_url:
          description: URL for Twitter account.
          nullable: true
          type: string
          example: https://x.com/dvbydt
        github_url:
          description: URL for Github account.
          nullable: true
          type: string
          example: https://github.com/sarahchen9776
        about:
          description: A description of the person.
          nullable: true
          type: string
          example: >-
            Focussed on venture investments in tech startups in India. Select
            investments -Lead - Groww (NSE: GROWW), Leap, Progcap, GoKwik,
            Pristyn Care, Stanza Living, Toddle, PayGlocal, Metropolitan Stock
            Exchange, Zanskar Research, Lightmetrics, Plum, Ambak, Osfin, Agrani
            Labs, C2i Semiconductors, Orbitshift, Eduvanz, Pagarbook,
            Clarisights, Onfinance, Wobot, DezyCo-lead/support - Zomato (NSE:
            ETERNAL), Oyo (partially exited in a private transaction), Porter
            (fully exited in a private transaction), Go-Jek (IDX: GOTO), Ola
            Cabs (fully exited in a private transaction), Rebel Foods (partially
            exited in a private transaction), Blinkit (Acquired by ETERNAL),
            Blackbuck (NSE: BLACKBUCK)
        tagline:
          description: A shorter tagline for the person.
          nullable: true
          type: string
          example: Founder, Mettle Capital
        location:
          description: Where the person is located.
          nullable: true
          type: string
          example: Bengaluru, Karnataka, India, Asia
        region:
          description: Main region where the person is located.
          nullable: true
          type: string
          example: Asia
        highlights:
          items:
            type: string
            example: prior_exit
          type: array
          description: |
            Type of highlight, the full list will be added shortly.
          example:
            - fortune_500_experience
            - hyper_connector
            - influencer
            - prior_vc_backed_experience
            - serial_founder
            - top_university
        level_of_seniority:
          description: Top level of seniority the person has achieved.
          nullable: true
          type: string
          example: Executive Level
        years_of_experience:
          description: Years of experience the person has worked for.
          nullable: true
          type: number
          example: 21
        education_level:
          description: Top level of education that the person has.
          nullable: true
          type: string
          example: Bachelor's Degree
        experience:
          type: array
          description: Companies that the person has worked for.
          items:
            $ref: '#/components/schemas/Experience'
        past_position_title:
          description: Title of the person's last position
          nullable: true
          type: string
          example: Managing Director
        past_position_company_name:
          description: Name of the company where the person last left.
          nullable: true
          type: string
          example: Peak XV Partners
        past_position_company_website:
          description: Website for the company where the person last left.
          nullable: true
          type: string
          example: peakxv.com
        current_tenure:
          description: Length of time the person has been in their current job.
          nullable: true
          type: number
          example: 2
        average_tenure:
          description: Average length of time in a position.
          nullable: true
          type: number
          example: 30
        education:
          type: array
          description: Educational background for the person
          items:
            $ref: '#/components/schemas/Education'
        languages:
          description: Languages that the person speaks
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/Language'
          example:
            - name: English
              proficiency_level: Native Or Bilingual Proficiency
            - name: Mandarin Chinese
              proficiency_level: Limited Working Proficiency
        skills:
          nullable: true
          items:
            type: string
            example: Machine Learning
          description: List of skills that the person has.
          type: array
          example:
            - Business Analysis
            - Business Strategy
            - Cloud Computing
            - Computer Vision
            - E-commerce
            - Entrepreneurship
            - Financial Modeling
            - Management
            - Management Consulting
            - Mobile
        linkedin_followers:
          description: Number of followers the person has on LinkedIn.
          type: number
          example: 47896
        linkedin_connections:
          description: Number of connections the person has on LinkedIn.
          type: number
          example: 29540
      required:
        - person_id
        - signal_score
        - signal_status
        - signal_type
        - talent_last_signal
        - talent_signal_id
      additionalProperties: false
      title: Talent Signal
      type: object
    InvestorInterest:
      properties:
        signal_id:
          description: Unique identifier for this investor interest signal
          type: string
          example: f7e8e33a-ea66-40e4-a567-e2afc8638bd2
        signal_date:
          description: Date when the talent signal was detected
          type: string
          example: '2026-07-10'
        signal_score:
          description: Confidence score for this talent signal (1-10 scale)
          type: number
          example: 8
        signal_summary:
          description: Summary of the signal
          type: string
          example: >-
            A Partner at General Catalyst and Evantic Capital are both exploring
            BORN amid early-stage fundraising. BORN creates AI friends that
            provide companionship and connection through AI and consumer social
            experiences.
        signal_type:
          description: Type of talent signal detected
          type: string
          enum:
            - Company
            - Talent
          example: Company
        source_types:
          description: The course of the signal
          type: string
          enum:
            - influencer
            - journalist
            - investor
            - insider
            - angel
            - investment_bank
            - venture_capital
            - private_equity
          example:
            - venture_capital
        signal_total_funding_usd:
          description: The total funding in USD when the signal was triggered
          type: number
          example: 15000000
        signal_last_funding_date:
          description: The total funding date when the signal was triggered
          type: string
          example: '2025-09-01'
        signal_investors:
          description: The investors for this signal
          type: array
          items:
            type: object
            description: Information about the investor
            properties:
              name:
                type: string
                description: The full name of the investor
                example: Accel
        entity_id:
          description: >
            Unique identifier of the entity that this signal is for, if it's a
            Company signal then this is the company id, if it's a Talent signal
            then this is the person id.

            Note that this may not exist, in which case for company signals the
            `domain` can be used and for talent signals the linkedin_url can be
            used.
          type: string
          example: 5e3a7f110aa7a3270a54b92e
        company:
          type: object
          description: Information about the company if it is a company signal.
          properties:
            name:
              description: Name of the company
              type: string
              example: BORN
            description:
              description: A description for what the company does, and who they are.
              type: string
              example: >-
                Born creates AI friends-companions that enter people's lives at
                the right moment and stay for a lifetime. These friends are
                always there when needed most, making conversations, play, and
                connection fun. At the intersection of AI and consumer social,
                Born is building experiences that feel natural, joyful, and
                lasting.
            website:
              description: >-
                The website url, will contain the protocol, and may contain
                `www.`.
              type: string
              example: http://born.com/
            linkedin_url:
              description: Linkedin URL (if any) of the company
              type: string
              example: https://www.linkedin.com/company/born-dot-com
            twitter_url:
              description: Twitter URL (if any) of the company
              type: string
              example: None
            founded_year:
              description: The year that the company was founded.
              type: number
              example: 2022
            hq:
              $ref: '#/components/schemas/HQ'
              description: Location information about the companies HQ.
            industry:
              $ref: '#/components/schemas/Industry'
            tech_verticals:
              $ref: '#/components/schemas/TechVertical'
            is_industry_estimated:
              description: Whether the industry is estimated or not.
              type: boolean
              example: false
            customer_focus:
              $ref: '#/components/schemas/CustomerFocus'
              description: The type of customers the company deals with.
          required:
            - name
          additionalProperties: false
        person:
          type: object
          description: Information about the person if it is a talent signal.
          properties:
            full_name:
              description: Full name
              type: string
              example: Gudmundur Bjarni Olafsson
            description:
              description: A description of the person.
              nullable: true
              type: string
              example: >-
                AI/ML researcher and entrepreneur with a focus on computer
                vision applications. Previously led ML teams at Google and
                founded an AI startup.
            website:
              description: Website (if any) of the company the person may be related to.
              type: string
            linkedin_url:
              description: URL for LinkedIn account.
              type: string
              example: https://www.linkedin.com/in/gudmundurbjarni
            twitter_url:
              description: URL for Twitter account.
              nullable: true
              type: string
              example: https://x.com/gudmundur
            founded_year:
              description: The year that the company the person is related to was founded.
              type: number
              example: 2026
            location:
              $ref: '#/components/schemas/HQ'
              description: Location information about the person
            industry:
              $ref: '#/components/schemas/Industry'
            tech_verticals:
              $ref: '#/components/schemas/TechVertical'
            is_industry_estimated:
              description: Whether the industry is estimated or not.
              type: boolean
              example: true
          required:
            - full_name
          additionalProperties: false
        signal_last_funding_usd:
          nullable: true
          type: integer
          description: >-
            The company's most recent funding round amount in USD, as of the
            signal date.
        signal_source:
          type: array
          items:
            type: string
          description: >-
            The sources this signal was derived from (e.g. the article or filing
            references that triggered it).
      required:
        - company
        - entity_id
        - person
        - signal_date
        - signal_id
        - signal_investors
        - signal_last_funding_date
        - signal_last_funding_usd
        - signal_score
        - signal_source
        - signal_summary
        - signal_total_funding_usd
        - signal_type
        - source_types
      additionalProperties: false
      title: Investor Interest Signal
      type: object
    Investor:
      title: Investor
      type: object
      required:
        - investor_id
        - investor_name
      additionalProperties: false
      properties:
        investor_id:
          type: string
          description: The Specter ID for this investor, can be used in other endpoints.
          example: inv_84f563826c689ceb42aff52a
        strategic_signal_ids:
          type: array
          description: >-
            All Interest Signals IDs associated with this investor. Empty when
            none are active.
          items:
            type: string
            format: uuid
            example: ddea4a84-ffdc-459d-bb10-3d7db9c6c193
          example:
            - 9d7dea32-d8f2-46ab-a794-562dd5775877
            - e4f05086-8862-4f05-b871-b7485d84e996
            - e63e5f0b-2d02-491d-9f7f-6f4cb7c141e1
            - ce1dc8a4-4a53-49e9-ad79-7e741d8f4eca
            - 2cb275ef-463f-4102-85af-4674e72502f7
            - 41da8f9f-947f-4c37-a054-cc056d8fe8aa
            - a59913fa-4fe3-4426-9e02-e661e50d659c
            - 1b5d35c7-b553-4589-a7e0-8f2bfebdce0c
            - 3512c9d6-dc5d-448f-8aa3-83688f90c6f1
            - ce0fb6bb-04de-4d1c-93ea-6da5c724bf6c
        person_id:
          type: string
          nullable: true
          description: >-
            The Specter person ID this investor is linked to, when the investor
            is an individual (e.g. an angel). `null` for firms.
          example: 5e3b9281137e998b5aea67f4
        company_id:
          type: string
          nullable: true
          description: >-
            The Specter company ID of the company associated with this investor,
            when applicable (e.g. the firm behind a VC fund).
          example: 5e3bbc2600c8f4c966983640
        investor_name:
          type: string
          description: The legal or brand name of the investor or investment firm.
          example: Sequoia Capital
        investor_rank:
          type: integer
          nullable: true
          description: The Specter rank for this investor.
          example: 12
        company_size:
          type: string
          nullable: true
          description: >-
            The size bracket of the investor's organization (employee count
            band).
          example: 201-500
        operating_status:
          type: string
          nullable: true
          description: The operating status of the investor (e.g. `active`, `closed`).
          example: active
        domain:
          type: string
          nullable: true
          description: The investor's primary web domain.
          example: sequoiacap.com
        hq_location:
          type: string
          nullable: true
          description: The investor's headquarters location.
          example: Menlo Park, California, United States, North America
        founded_year:
          type: integer
          nullable: true
          description: The year the investor was founded.
          example: 1972
        investor_types:
          type: array
          description: >-
            The investor types this investor falls under, as lowercase
            snake_case (e.g. `venture_capital`, `angel_group`).
          items:
            type: string
            example: venture_capital
          example:
            - venture_capital
        linkedin_url:
          type: string
          nullable: true
          description: The investor's LinkedIn profile URL.
          example: linkedin.com/company/sequoia
        twitter_url:
          type: string
          nullable: true
          description: The investor's Twitter / X profile URL.
          example: x.com/sequoia
        description:
          type: string
          nullable: true
          description: >-
            Brief textual overview of the investor's activities, history, or
            focus.
          example: >-
            Sequoia Capital is a venture capital firm founded by Don Valentine
            in 1972, with a mission to help daring founders build legendary
            companies from idea to IPO and beyond. They invest in a select few
            outliers each year, providing hands-on support throughout the
            company's lifecycle. Sequoia's expertise is drawn from 50 years of
            partnering with iconic founders. Their backing has resulted in
            companies accounting for over 25% of NASDAQ's total value. A
            significant portion of their investments is made on behalf of
            nonprofits and schools, directing returns to these organizations.
        number_of_exits:
          type: integer
          nullable: true
          description: Total number of portfolio company exits attributed to this investor.
          example: 453
        number_of_lead_investments:
          type: integer
          nullable: true
          description: Total number of investments where the investor led the round.
          example: 884
        number_of_investments:
          type: integer
          nullable: true
          description: Total number of investments made by the investor.
          example: 2392
        number_of_funds:
          type: integer
          nullable: true
          description: Total number of separate funds managed or raised by the firm.
          example: 36
        investment_stage:
          type: array
          description: >-
            Typical funding round stages in which the investor participates
            (e.g., Seed, Series A).
          items:
            type: string
            example: Series A
          example:
            - Angel
            - Convertible Note
            - Corporate Round
            - Debt Financing
            - Equity Crowdfunding
            - Grant
            - Initial Coin Offering
            - Post Ipo Debt
            - Post Ipo Equity
            - Pre Seed
        industry_target:
          type: array
          description: Industries or verticals in which the investor typically specializes.
          items:
            type: string
            example: Software
          example:
            - Administrative Services
            - Advertising
            - Agriculture and Farming
            - Biotechnology
            - Blockchain and Crypto
            - Clothing and Apparel
            - Commerce and Shopping
            - Community and Lifestyle
            - Construction
            - Consumer Products
        specter_industry_target:
          type: array
          description: >-
            Only top level. Classifies companies by their economic activity -
            the market they serve and the products or services they deliver.
            E.g. Construction, Utilities, Wholesale. There is one industry per
            company, with up to three levels.
          items:
            type: string
            example: Enterprise Software
          example:
            - Accommodation Services
            - Accounting
            - Administrative and Support Services
            - Advertising Services
            - Agricultural Technology
            - Airlines and Aviation
            - Appliances, Electrical, and Electronics Manufacturing
            - Architecture and Planning
            - Artists and Writers
            - Automation Machinery Manufacturing
        specter_tech_verticals_target:
          type: array
          description: >-
            Only top level. Classifies companies by the technology domain they
            operate in - the technical capability or space they're building
            around. E.g. AI & Machine Learning, Cybersecurity, FinTech. There
            can be up to 5 tech verticals per company, with 2 levels each.
          items:
            type: string
            example: AI / Machine Learning
          example:
            - AI & Machine Learning
            - AI Agents and Process Copilots
            - AI Evaluation and Benchmarking
            - AI Media and Virtual Creators
            - AI Platforms, SDKs and APIs
            - AI Safety and Governance
            - AI Sales Copilots, Conversation Intelligence, and Assistants
            - AI Security and Model Protection
            - AI Tutors and Adaptive Learning
            - AI and Analytics for Supply Chain Optimization
        fund_details:
          type: array
          description: >-
            The named funds this investor has raised, with announce date and
            amount when available.
          items:
            $ref: '#/components/schemas/InvestorFund'
        portfolio_companies:
          type: array
          description: Specter company IDs for portfolio companies of this investor.
          items:
            type: string
            example: 5e3bbf6b00c8f4c966a1e53d
          example:
            - 5e3a8f1b040ca7b0c6f06a3c
            - 6495263511c3a8c65a7c742d
            - 67b7765cc3099373c3e3803a
            - 5e3b927f137e998b5aea5e93
            - 5e3b65e8ab6348f63cd9e5df
            - 60422e064ddab8d8bf2b6338
            - 5ed1cf8b4ae879e7872a002c
            - 5e3bc0f900c8f4c966a6ded6
            - 5e3a8f1b040ca7b0c6f07476
            - 5e3b9fe6137e998b5aee9c4b
    PublicFundingRound:
      title: Funding Round
      type: object
      required:
        - company_name
        - funding_round_id
        - name
      additionalProperties: false
      properties:
        funding_round_id:
          type: string
          description: The Specter funding round ID.
          example: fnr_6ac8f4058536c08a85f052e7
        name:
          type: string
          description: The display name of the funding round.
          example: Angel Round - Best Apps Market
        company_id:
          type: string
          nullable: true
          description: The Specter company ID of the company that raised this round.
          example: 5e3a8fc7040ca7b0c6f35b14
        company_name:
          type: string
          description: The name of the company that raised this round.
          example: Best Apps Market
        investment_type:
          type: string
          nullable: true
          description: The investment type for this round.
          enum:
            - Angel
            - Convertible Note
            - Corporate Round
            - Debt Financing
            - Equity Crowdfunding
            - Grant
            - Initial Coin Offering
            - Non Equity Assistance
            - Post Ipo Debt
            - Post Ipo Equity
            - Post Ipo Secondary
            - Pre Seed
            - Private Equity
            - Product Crowdfunding
            - Secondary Market
            - Seed
            - Series A
            - Series B
            - Series C
            - Series D
            - Series E
            - Series F
            - Series G
            - Series H
            - Series I
            - Series J
            - Series Unknown
            - Undisclosed
          example: Angel
        announced_on:
          type: string
          format: date
          nullable: true
          description: The date (YYYY-MM-DD) the round was announced.
          example: '2011-05-10'
        raised_amount_usd:
          type: number
          nullable: true
          description: The amount raised in USD.
          example: 65000000
        pre_money_valuation_usd:
          type: number
          nullable: true
          description: The reported pre-money valuation in USD.
          example: 3400000000
        post_money_valuation_usd:
          type: number
          nullable: true
          description: The reported post-money valuation in USD.
          example: 3800000000
        investors:
          type: array
          description: All investors that participated in this round.
          items:
            $ref: '#/components/schemas/BasicInvestorInfo'
    PublicAcquisition:
      properties:
        acquisition_id:
          description: |
            The Specter ID for this acquisition.
          type: string
          example: acq_fd583a1b99d5c85635a56283
        acquirer_company_id:
          description: >
            The Specter company ID of the **acquirer**. Use with `GET
            /companies/{companyId}` to fetch the full company record.
          type: string
          example: 6576fa02f5c870dd55a4982a
        acquirer_name:
          description: The acquirer company's name.
          type: string
          example: Uber
        acquirer_domain:
          description: The acquirer's primary domain.
          type: string
          nullable: true
          example: uber.com
        acquiree_company_id:
          description: >
            The Specter company ID of the **acquiree**. Use with `GET
            /companies/{companyId}` to fetch the full company record.
          type: string
          example: 5e3ba36800c8f4c9668e5b8f
        acquiree_name:
          description: The acquiree company's name.
          type: string
          example: Delivery Hero
        acquiree_domain:
          description: The acquiree's primary domain.
          type: string
          nullable: true
          example: deliveryhero.com
        acquisition_type:
          description: >
            The type of deal. One of `acquisition`, `merge`, `lbo`, `acquihire`,
            or `management_buyout`. Null when Specter could not classify the
            deal.
          type: string
          nullable: true
          enum:
            - acquisition
            - merge
            - lbo
            - acquihire
            - management_buyout
          example: acquisition
        price_usd:
          description: Deal value in USD, if disclosed.
          type: integer
          nullable: true
          example: 14564220183
        acquisition_date:
          description: Date the acquisition was announced or closed (YYYY-MM-DD).
          type: string
          format: date
          nullable: true
          example: '2026-07-16'
      required:
        - acquisition_id
        - acquirer_company_id
        - acquirer_name
        - acquiree_company_id
        - acquiree_name
      additionalProperties: false
      title: Acquisition
      type: object
    PublicIpo:
      properties:
        ipo_id:
          description: >
            The Specter ID for this IPO. Stable across deliveries and usable on
            `GET /ipos/{ipo_id}`.
          type: string
          example: ipo_dff0947b71f841d30d9d083c
        company_id:
          description: >
            The Specter company ID of the issuing company. Use with [Get company
            by ID](/api-reference/companies/get-company-by-id) to fetch the full
            company record.
          type: string
          example: 5fc743c1bf7e53924df4359d
        company_name:
          description: The issuing company's name.
          type: string
          example: Hamilton Beach Brands Inc.
        company_domain:
          description: The issuing company's primary domain, if known.
          type: string
          nullable: true
          example: hamiltonbeachbrands.com
        stock_exchange_symbol:
          description: >-
            The exchange the company listed on (lowercase, e.g. `nasdaq`,
            `nyse`).
          type: string
          nullable: true
          example: nyse
        stock_symbol:
          description: Ticker symbol of the company.
          type: string
          nullable: true
          example: HBB
        went_public_on:
          description: Date the company went public (YYYY-MM-DD).
          type: string
          format: date
          nullable: true
          example: '2017-09-29'
        share_price_usd:
          description: Initial offering share price in USD.
          type: number
          nullable: true
          example: 22
        valuation_price_usd:
          description: Implied valuation at listing in USD.
          type: number
          nullable: true
          example: 1192737304
        money_raised_usd:
          description: Total proceeds from the offering in USD.
          type: integer
          nullable: true
          example: 101200000
      required:
        - ipo_id
        - company_id
        - company_name
      additionalProperties: false
      title: IPO
      type: object
    ApiKeyMissing:
      properties:
        errorCode:
          description: API_KEY_MISSING
          example: API_KEY_MISSING
          type: string
        message:
          description: No API Key was presented on the header X-API-KEY
          example: No API Key was presented on the header X-API-KEY
          type: string
    ApiKeyNotValid:
      properties:
        errorCode:
          description: API_KEY_NOT_VALID
          example: API_KEY_NOT_VALID
          type: string
        message:
          description: API key present, but not valid
          example: API key present, but not valid
          type: string
    Role:
      type: string
      enum:
        - company
        - investor
        - school
      example: company
    CustomerFocus:
      type: string
      enum:
        - b2b
        - b2c
        - b2b_b2c
        - b2c_b2b
      example: b2c
    Industry:
      type: array
      items:
        type: string
        example: Financial Services
      example:
        - Financial Services
        - Financial Technology
      description: >
        Classifies companies by their economic activity - the market they serve
        and the products or services they deliver.

        E.g: Construction, Utilities, Wholesale.

        There is one industry per company, with up to three levels.
      nullable: true
    TechVertical:
      type: array
      items:
        type: array
        items:
          type: string
          example: Blockchain, Crypto & Web3
      example:
        - - Blockchain, Crypto & Web3
          - Crypto Exchanges and Trading Infrastructure
      title: Experience.tech_verticals
      description: >
        Classifies companies by the technology domain they operate in - the
        technical capability or space they're building around.

        E.g: AI & Machine Learning, Cybersecurity, FinTech.

        There can be up to 5 tech verticals per company, with 2 levels each.
      nullable: true
    OperatingStatus:
      type: string
      enum:
        - active
        - acquired
        - closed
        - ipo
      example: active
    Highlights:
      type: array
      items:
        description: |
          The type of highlight, the full list will be added shortly, these are 
          based on growth, news, funding and other aspects of the company.
        type: string
      example:
        - early_stage
    CompanyFounders:
      properties:
        specter_person_id:
          description: The person Id for the founder to be used with the people API.
          type: string
          example: per_485764e6c22d1ace874937fa
        full_name:
          description: Full name of the founder.
          type: string
          example: Liz Fitzgerald
        title:
          description: Title of the founder.
          type: string
          example: Equate Lead & Co-founder
        departments:
          description: List of the departments the founder is in.
          type: array
          items:
            type: string
            example: Senior Leadership
          example:
            - Senior Leadership
        seniority:
          description: Seniority of the founder.
          type: string
          example: Executive Level
      additionalProperties: false
      title: CompanyFounders
      type: object
    Website:
      properties:
        domain:
          description: The domain of the website, can have a sub-domain.
          type: string
          example: stripe.com
        url:
          description: The website url, will contain the protocol, and may contain `www.`.
          type: string
          example: https://stripe.com
        domain_aliases:
          description: Any other domains that are associated with the company.
          items:
            type: string
          type: array
          example:
            - revolut.me
      required:
        - domain
        - url
        - domain_aliases
      additionalProperties: false
      type: object
    HQ:
      properties:
        city:
          description: City for the location.
          type: string
          example: South San Francisco
        state:
          description: >-
            State for the location, outside of America will relate to the
            country and region.
          type: string
          example: California
        country:
          description: Country for the location.
          type: string
          example: United States
        region:
          description: Use `continent` instead.
          type: string
          example: North America
          deprecated: true
        continent:
          description: The continent the HQ is in.
          type: string
          example: North America
        regions:
          description: Any regions that the HQ is in.
          type: array
          items:
            type: string
          example:
            - San Francisco Bay Area
      required:
        - city
        - state
        - country
        - region
      additionalProperties: false
      title: HQ
      type: object
    Contact:
      properties:
        phone_number:
          type: string
          example: +1 555 000 0000
        email:
          type: string
          example: jane.doe@example.com
      required:
        - phone_number
        - email
      additionalProperties: false
      title: Contact
      type: object
    Acquisition:
      properties:
        acquirer:
          description: The acquiring party.
          type: string
          example: Stripe
        date:
          description: Date when the acquisition took place.
          type: string
          example: '2019-04-17'
        amount_usd:
          description: How much in USD ($) the acquisition was for.
          type: number
          example: 500000
      required:
        - acquirer
        - date
        - amount_usd
      additionalProperties: false
      title: Acquisition
      type: object
    IpoDetails:
      properties:
        wentPublicOn:
          description: The date in the form YYYY-MM-DD that the IPO took place.
          type: string
          example: '2023-04-26'
        stockExchange:
          description: The stock exchange the company went public on.
          type: string
          example: bvmf
        stockSymbol:
          description: The stock symbol for the company.
          type: string
          example: AIRB34
        sharePrice:
          description: The IPO stock price (not the current stock price)
          type: number
          example: 68
        valuationPrice:
          description: The valuation price upon IPO.
          type: number
          example: 40626000000
        raisedAmount:
          description: How much was raised USD ($) in the IPO.
          type: number
          example: 3488400000
      additionalProperties: false
      title: IpoDetails
      type: object
    GrowthStage:
      type: string
      enum:
        - bootstrapped
        - seed_stage
        - early_stage
        - growth_stage
        - late_stage
        - exit_stage
      example: growth_stage
    Funding:
      properties:
        total_funding_usd:
          description: |
            The total aggregated amount in USD ($) that the company has raised 
            in all funding rounds.
          type: number
          example: 10440247725
        last_funding_usd:
          description: The last amount in USD ($) that the company raised.
          type: number
          example: 2500000000
        last_funding_date:
          description: The date in the format YYYY-MM-DD that the last funding took place.
          type: string
          example: '2026-03-09'
        last_funding_type:
          $ref: '#/components/schemas/FundingType'
          description: The last type of funding the company had, "series_a", "angel", etc
        round_count:
          description: How many funding rounds the company has had.
          type: number
          example: 26
        round_details:
          description: Details from each of the funding rounds the company has had.
          items:
            $ref: '#/components/schemas/FundingRound'
          type: array
        post_money_valuation_usd:
          description: The post money valuation in USD ($).
          type: number
          example: 159000000000
      required:
        - total_funding_usd
        - last_funding_usd
        - last_funding_date
        - last_funding_type
        - round_count
        - round_details
        - post_money_valuation_usd
      additionalProperties: false
      title: Funding
      type: object
    Web:
      properties:
        visits:
          type: number
          example: 121170099
        popularity_rank:
          type: number
          example: 327
        top_country:
          type: string
          example: United States
        bounce_rate:
          type: number
          example: 55.49
        bounce_rate_3mo_change:
          type: number
          example: 1
        pages_per_visit:
          type: number
          example: 3.2623982429504395
        pages_per_visit_3mo_change:
          type: number
          example: 0
        session_duration:
          type: number
          example: 166
        session_duration_3mo_change:
          type: number
          example: -9
        traffic_source:
          description: >
            The sources of web traffic in a semi-colon delimited list:

            `Direct: 38.0%; Referrals: 8.8%; Search: 45.2%; Social: 5.9%; Mail:
            0.1%`
          type: string
          example: 'Mail: 3.0%; Direct: 38.0%; Referrals: 39.0%'
        country_breakdown:
          type: string
          example: >-
            United States 29.61023449897766%; United Kingdom 7.961041480302811%;
            India 4.983578994870186%; France 4.563024640083313%; Canada
            3.6161303520202637%
      required:
        - visits
        - popularity_rank
        - top_country
        - bounce_rate
        - bounce_rate_3mo_change
        - pages_per_visit
        - pages_per_visit_3mo_change
        - session_duration
        - session_duration_3mo_change
        - traffic_source
        - country_breakdown
      additionalProperties: false
      title: Web
      type: object
    Awards:
      properties:
        award_name:
          description: Name of the award.
          type: string
          example: CNBC Disruptor 50
        award_details:
          description: >-
            Extra details about the award, the rank that it was received at for
            instance.
          type: string
          example: Rank 3
        award_year:
          description: The year the award was received.
          type: string
          example: 2024
        award_org:
          description: The organization that gives out the award.
          type: string
          example: CNBC
        award_link:
          description: A link to the award information.
          type: string
          example: >-
            https://www.cnbc.com/2024/05/14/these-are-the-2024-cnbc-disruptor-50-companies.html
        logo_url:
          description: >-
            A logo for the award, often a badge to show what the award is in a
            visual form.
          type: string
          example: https://specter-company-logo.s3.amazonaws.com/cnbc.com.jpeg
      additionalProperties: false
      title: CompanyAwards
      type: object
    News:
      properties:
        date:
          description: Date in YYYY-MM-DD form that the news was published.
          type: string
          example: '2025-01-01'
        title:
          description: A title related to the news.
          type: string
          example: >-
            Hedgehog Analytics set to transform data-driven decision making in
            2025
        url:
          description: A link to the news.
          type: string
          example: https://technews.com/2025/hedgehog-analytics-vision
        publisher:
          description: The outlet that published the news.
          type: string
          example: TechNews Ltd
      required:
        - date
        - title
        - url
        - publisher
      additionalProperties: false
      title: News
      type: object
    G2Reviews:
      description: Information about all G2 reviews with an aggregated rating.
      properties:
        products:
          items:
            $ref: '#/components/schemas/G2ProductData'
          type: array
        rating_avg:
          description: An average rating across all products.
          type: number
          example: 4.27
        review_count:
          description: The total number of G2 reviews across all products.
          type: number
          example: 977
      required:
        - products
        - rating_avg
        - review_count
      additionalProperties: false
      type: object
    TrustpilotReviews:
      description: Reviews for a company or website from Trustpilot
      properties:
        url:
          description: The Trustpilot review link.
          type: string
          example: https://www.trustpilot.com/review/stripe.com
        review_count:
          description: The total number of reviews on Trustpilot.
          type: number
          example: 17200
        review_avg:
          description: The average rating for the company or website on Trustpilot.
          type: number
          example: 1.7
      required:
        - url
      additionalProperties: false
      title: TrustpilotReviews
      type: object
    ChromeExtensionReviews:
      description: Information about Chrome extension reviews and ratings for the company.
      properties:
        products:
          items:
            $ref: '#/components/schemas/ChromeExtensionData'
          type: array
        rating_avg:
          description: An average rating across all chrome extensions.
          type: number
          example: 0
        review_count:
          description: The total number of reviews across all Chrome extensions.
          type: number
          example: 0
        user_count:
          description: The total number of users across all Chrome extensions.
          type: number
          example: 0
      required:
        - products
        - rating_avg
        - review_count
      additionalProperties: false
      type: object
    GlassdoorReviews:
      description: Information about Glassdoor reviews and ratings for the company.
      properties:
        url:
          description: The URL of the company's Glassdoor page.
          type: string
          example: >-
            https://www.glassdoor.com/Overview/Working-at-Stripe-EI_IE671932.11,17.htm
        rating:
          description: >
            The Glassdoor rating for the company, reflecting their employee
            satisfaction

            and workplace reputation.
          type: number
          example: 3.7
        reviews:
          description: The number of views the company has received on Glassdoor.
          type: number
          example: 1479
        leadership_approval:
          description: The leadership approval rating for the company.
          type: number
          example: 0.82
      additionalProperties: false
      type: object
    Socials:
      description: Information about different social sites.
      properties:
        twitter:
          $ref: '#/components/schemas/Twitter'
        facebook:
          $ref: '#/components/schemas/Facebook'
        linkedin:
          $ref: '#/components/schemas/Linkedin'
        itunes:
          $ref: '#/components/schemas/ITunes'
        googleplay:
          $ref: '#/components/schemas/GooglePlay'
        instagram:
          $ref: '#/components/schemas/Instagram'
        crunchbase:
          $ref: '#/components/schemas/Crunchbase'
        pitchbook:
          $ref: '#/components/schemas/Pitchbook'
      required:
        - twitter
        - facebook
        - linkedin
        - itunes
        - googleplay
        - instagram
        - crunchbase
      additionalProperties: false
      title: Socials
      type: object
    TractionMetrics:
      description: >
        Gain deeper insights into a company's **traction and growth trends**
        across key 

        areas, including website traffic, social media presence, app engagement,
        and 

        employee expansion.  


        This dataset reveals how a company's metrics have evolved over time,
        allowing 

        you to track momentum and make **data-driven decisions**.  


        Each traction metric highlights the **difference between the current
        value and 

        past values**, providing clear visibility into growth patterns over:  

        - 📆 1mo: 1-month growth  

        - 📆 2mo: 2-month growth  

        - 📆 3mo: 3-month growth  

        - 📆 4mo: 4-month growth  

        - 📆 5mo: 5-month growth  

        - 📆 6mo: 6-month growth  

        - 📆 12mo: 12-month growth  

        - 📆 24mo: 24-month growth  
      properties:
        web_visits:
          $ref: '#/components/schemas/TractionMetric'
          description: |
            📊 Tracks website visit trends over time, helping you assess 
            **online engagement and visibility**.
        popularity_rank:
          $ref: '#/components/schemas/TractionMetric'
          description: |
            🚀 Monitors shifts in website **popularity ranking**, showing how a 
            company compares to competitors.
        employee_count:
          $ref: '#/components/schemas/TractionMetric'
          description: |
            👥 Analyzes workforce expansion or reduction, helping gauge 
            **company growth and stability**.
        linkedin_followers:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            🔗 Measures **LinkedIn follower trends**, revealing corporate
            influence 

            and brand reach.
        twitter_followers:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            🐦 Tracks **Twitter follower fluctuations**, offering insights into
            social 

            engagement and audience growth.
        instagram_followers:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            📸 Evaluates **Instagram follower trends**, highlighting brand
            awareness 

            and social traction.
        itunes_reviews:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            ⭐ Measures **customer feedback on iTunes**, showing user sentiment
            and 

            app reception.
        googleplay_reviews:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            📱 Tracks **Google Play review trends**, providing insights into
            mobile 

            app performance and reputation.
        app_downloads:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            📈 Measures **app download growth** across platforms like iTunes
            and 

            Google Play, reflecting adoption rates.
        g2_reviews:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            💼 Monitors **G2 review growth**, showing how businesses are
            perceived in 

            the B2B market.
        trustpilot_reviews:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            🏆 Tracks **Trustpilot reviews**, providing a pulse on customer
            trust and 

            brand credibility.
        chrome_extensions_reviews:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            🌐 Measures **Chrome extension review growth**, offering insights
            into 

            extension usability and satisfaction.
        chrome_extensions_users:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            🔥 Tracks **Chrome extension user growth**, revealing adoption
            trends and 

            product demand.
        glassdoor_rating:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            🌟 Monitors **Glassdoor ratings**, reflecting employee
            satisfaction, 

            company culture, and workplace reputation.
        glassdoor_reviews:
          $ref: '#/components/schemas/TractionMetric'
          description: >
            📝 Tracks **Glassdoor reviews**, providing qualitative insights into
            employee experiences, 

            feedback, and organizational strengths or weaknesses.
      additionalProperties: false
      type: object
    Experience:
      properties:
        company_name:
          title: Experience.company_name
          description: The name of the company or organization
          type: string
          example: valantic (vormals mm1)
        company_id:
          title: Experience.company_id
          description: Unique identifier for the company in the system
          nullable: true
          type: string
          example: 6744b47c776432406530a72b
        domain:
          title: Experience.domain
          description: The company's website domain
          nullable: true
          type: string
          example: mm1.com
        linkedin_url:
          title: Experience.linkedin_url
          description: LinkedIn URL for the company
          nullable: true
          type: string
          example: https://www.linkedin.com/company/mm1
        description:
          title: Experience.description
          description: Details about the role, responsibilities, and achievements
          nullable: true
          type: string
          example: >-
            As an Implementation Engineer at valantic, I play a pivotal role in
            the technical execution of Stripe integration projects, ensuring
            precision, efficiency, and robust infrastructure in every
            implementation. Leveraging deep technical expertise and payments
            industry experience, I design and deploy custom payment solutions
            that enhance operational efficiency and customer satisfaction.
        company_size:
          title: Experience.company_size
          description: The size category of the company
          nullable: true
          type: string
          example: 51-200
        industry:
          $ref: '#/components/schemas/Industry'
        tech_verticals:
          $ref: '#/components/schemas/TechVertical'
        title:
          title: Experience.title
          description: Job title or position held
          type: string
          example: Senior Consultant Fintech & Digital Payment
        departments:
          anyOf:
            - items:
                title: Experience.departments.[]
                type: string
                example: Engineering
              title: Experience.departments.[]
              type: array
              example:
                - Senior Leadership
                - Engineering
            - title: Experience.departments
              nullable: true
          title: Experience.departments
          description: Departments or teams the person worked in
          example:
            - Finance
        start_date:
          title: Experience.start_date
          description: Start date of the position
          nullable: true
          type: string
          example: '2025-04-01'
        end_date:
          title: Experience.end_date
          description: End date of the position (null if current)
          nullable: true
          type: string
          example: '2025-03-01'
        location:
          title: Experience.location
          description: Location where the work was performed
          nullable: true
          type: string
          example: Stuttgart, Baden-Wurttemberg, Germany, Europe
        is_current:
          title: Experience.is_current
          description: Whether this is the person's current position
          type: boolean
          example: true
        founded_year:
          title: Experience.founded_year
          description: The year the company was founded
          nullable: true
          type: number
          example: 1997
        job_order:
          title: Experience.job_order
          description: >-
            Sequential order of this job in the person's career (higher numbers
            for more recent positions)
          type: number
          example: 13
      required:
        - company_name
        - linkedin_url
        - title
        - departments
        - start_date
        - is_current
        - job_order
      additionalProperties: false
      title: Experience
      type: object
    Education:
      properties:
        name:
          title: Education.name
          description: The name of the educational institution
          nullable: true
          type: string
          example: Stanford University
        linkedin_url:
          title: Education.linkedin_url
          description: LinkedIn URL for the educational institution
          nullable: true
          type: string
          example: https://www.linkedin.com/school/stanford-university
        field_of_study:
          title: Education.field_of_study
          description: The academic field or major area of study
          nullable: true
          type: string
          example: Computer Science (AI track) and Statistics
        degree_title:
          title: Education.degree_title
          description: The type of degree or qualification obtained
          nullable: true
          type: string
          example: Bachelor of Science - BS
        description:
          title: Education.description
          description: >-
            Additional details about the educational experience, research focus,
            or achievements
          nullable: true
          type: string
          example: |-
            <p class="show-more-less-text__text--less">
                    Krieger School of Arts and Sciences<br>Bloomberg School of Public Health<br>(joint degree program)
            <!---->      </p>
        start_date:
          title: Education.start_date
          description: The start date of the educational program
          nullable: true
          type: string
          example: '2024-01-01'
        end_date:
          title: Education.end_date
          description: The end date or graduation date of the educational program
          nullable: true
          type: string
          example: '2028-01-01'
        location:
          title: Education.location
          description: The location of the educational institution
          nullable: true
          type: string
          example: Stanford, California, United States, North America
      required:
        - name
        - linkedin_url
        - field_of_study
        - degree_title
        - description
        - start_date
        - end_date
        - location
      additionalProperties: false
      title: Education
      type: object
    Language:
      properties:
        name:
          title: Language.name
          description: The name of the language
          nullable: true
          type: string
          example: Romanian
        proficiency_level:
          title: Language.proficiency_level
          description: The level of proficiency in the language
          nullable: true
          type: string
          example: Native Or Bilingual Proficiency
      required:
        - name
        - proficiency_level
      additionalProperties: false
      title: Language
      type: object
    InvestorFund:
      title: InvestorFund
      type: object
      description: A single fund raised by an investor.
      additionalProperties: false
      properties:
        name:
          type: string
          nullable: true
          description: The fund's name.
          example: Sequoia Capital Venture Fund II
        announced_on:
          type: string
          format: date
          nullable: true
          description: ISO date (YYYY-MM-DD) the fund was announced.
          example: '2025-10-27'
        raised_amount_usd:
          type: string
          nullable: true
          description: Amount raised in USD.
          example: '750000000'
    BasicInvestorInfo:
      title: BasicInvestorInfo
      type: object
      description: A single investor's participation in a funding round.
      required:
        - investor_id
        - investor_name
        - is_lead_investor
      additionalProperties: false
      properties:
        investor_id:
          type: string
          description: The Specter investor ID.
          example: inv_5b4918f3cbdcda9dbf829bc3
        investor_name:
          type: string
          description: The legal or brand name of the investor or investment firm.
          example: Anurag (Anu) Nigam
        is_lead_investor:
          type: boolean
          description: Whether this investor led the funding round.
          example: false
    FundingType:
      type: string
      enum:
        - angel
        - pre_seed
        - seed
        - equity_crowdfunding
        - product_crowdfunding
        - non_equity_assistance
        - convertible_note
        - grant
        - series_a
        - series_b
        - series_c
        - series_d
        - series_e
        - series_f
        - series_g
        - series_h
        - series_i
        - series_j
        - undisclosed
        - series_unknown
        - corporate_round
        - private_equity
        - debt_financing
        - initial_coin_offering
        - secondary_market
        - post_ipo_debt
        - post_ipo_equity
        - post_ipo_secondary
        - venture
      example: angel
    FundingRound:
      properties:
        type:
          $ref: '#/components/schemas/FundingType'
          description: The type of funding for this round ("angel", "series_a", etc)
        date:
          description: The date in the form YYYY-MM-DD that the round occurred.
          type: string
          example: '2009-08-22'
        raised:
          description: How much was raised in USD ($) for this round.
          type: number
          example: 2000000
        investors:
          description: The investors that participated in the funding round.
          items:
            type: string
          type: array
          example:
            - Y Combinator
      required:
        - date
        - investors
      additionalProperties: false
      title: FundingRound
      type: object
    G2ProductData:
      description: Product data about the G2 product being reviewed.
      properties:
        product_name:
          description: Name of the product.
          type: string
          example: Recko
        url:
          description: Link to the G2 reviews for the product.
          type: string
          example: https://www.g2.com/products/recko-io-recko/reviews
        review_count:
          description: Number of reviews that the product has received.
          type: number
          example: 1
        rating:
          description: The rating out of 5 for the product.
          type: number
          example: 2.5
      required:
        - product_name
        - url
      additionalProperties: false
      type: object
    ChromeExtensionData:
      description: Information about a specific Chrome extension.
      properties:
        name:
          description: Name of the extension.
          type: string
          example: Hedgehog Customer Extension
        url:
          description: Link to the Chrome web store
          type: string
          example: >-
            https://chromewebstore.google.com/detail/hedgehog-customer-extension/fdafneoiangoeinaeoigneon
        review_count:
          description: >
            Number of reviews that the extension has received. If not present
            then 

            there are no reviews.
          type: number
          example: 15
        rating:
          description: |
            The rating out of 5 for the extension. If there are no reviews the 
            extension won't have a rating.
          type: number
          example: 3.5
        user_count:
          description: The current number of users of the extension.
          type: number
          example: 3.5
        overall_rank:
          description: A rank for the extension from all the extensions on the store.
          type: number
          example: 120
        is_featured:
          description: Tells if the extension is featured on the web store or not.
          type: boolean
          example: false
      required:
        - url
      additionalProperties: false
      type: object
    Twitter:
      properties:
        url:
          type: string
          example: x.com/stripe
        follower_count:
          type: number
          example: 285274
      required:
        - url
        - follower_count
      additionalProperties: false
      title: Twitter
      type: object
    Facebook:
      properties:
        url:
          type: string
          example: facebook.com/stripehq
      required:
        - url
      additionalProperties: false
      title: Facebook
      type: object
    Linkedin:
      properties:
        url:
          type: string
          example: linkedin.com/company/stripe
        follower_count:
          type: number
          example: 1493677
      required:
        - url
        - follower_count
      additionalProperties: false
      title: Linkedin
      type: object
    ITunes:
      properties:
        url:
          type: string
          example: apps.apple.com/sa/app/hedgehog_analytics/id34454543
        app_id:
          type: string
          example: hh3242533
        review_count:
          type: number
          example: 98686
        rating:
          type: number
          example: 4.650000095367432
      required:
        - url
        - app_id
        - review_count
        - rating
      additionalProperties: false
      title: ITunes
      type: object
    GooglePlay:
      properties:
        url:
          type: string
          example: play.google.com/store/apps/details?id=com.hedgehog_analytics
        app_id:
          type: string
          example: hedgehog_analytics
        review_count:
          type: number
          example: 32800
        rating:
          type: number
          example: 4.400000095367432
        install_count:
          type: number
          example: 5000
      required:
        - url
        - app_id
        - review_count
        - rating
        - install_count
      additionalProperties: false
      title: Google Play
      type: object
    Instagram:
      properties:
        url:
          type: string
          example: instagram.com/stripehq
        follower_count:
          type: number
          example: 0
        following_count:
          type: number
          example: 0
      required:
        - url
        - follower_count
        - following_count
      additionalProperties: false
      title: Instagram
      type: object
    Crunchbase:
      properties:
        url:
          type: string
          example: crunchbase.com/organization/stripe
      required:
        - url
      additionalProperties: false
      title: Crunchbase
      type: object
    Pitchbook:
      properties:
        url:
          type: string
          example: pitchbook.com/profiles/company/54782-29
      required:
        - url
      additionalProperties: false
      title: Pitchbook
      type: object
    TractionMetric:
      properties:
        latest:
          description: The current value of the metric.
          type: number
          example: 121170099
        1mo:
          $ref: '#/components/schemas/ChangeMetric'
        2mo:
          $ref: '#/components/schemas/ChangeMetric'
        3mo:
          $ref: '#/components/schemas/ChangeMetric'
        4mo:
          $ref: '#/components/schemas/ChangeMetric'
        5mo:
          $ref: '#/components/schemas/ChangeMetric'
        6mo:
          $ref: '#/components/schemas/ChangeMetric'
        12mo:
          $ref: '#/components/schemas/ChangeMetric'
        24mo:
          $ref: '#/components/schemas/ChangeMetric'
      required:
        - latest
      additionalProperties: false
      title: TractionMetric
      type: object
    ChangeMetric:
      properties:
        value:
          description: The value at this period.
          type: number
          example: 118181324
        change:
          description: The difference between the latest value and this value.
          type: number
          example: 2988775
        percentage:
          description: The percentage change based on the latest value.
          type: number
          example: 2.53
      required:
        - value
        - change
      additionalProperties: false
      title: ChangeMetric
      type: object
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````