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

# Estimate number of companies

> Estimate the number of companies matching specific search criteria.

## Use Case:

Evaluate market size for strategic planning.


## OpenAPI

````yaml post /api/linkedin/companies/by_icp/get_count/
openapi: 3.0.3
info:
  title: Generect API
  description: >-
    Welcome to the Generect API documentation. Here we will help you integrate
    and use our API.


    API base url: `https://api.generect.com` — every path below is relative to
    this host. Newer endpoints live under `/api/v1/...`, legacy endpoints under
    `/api/...`; use each path exactly as documented.

    Protocol: `HTTPS`


    # Authentication


    Get your API token from the Generect app settings and send it in the
    `Authorization` header with the required `Token` prefix.


    Example: `Authorization: Token xxxxxxxxx`


    # Rate limits


    There is no monthly request quota. What you can run is bounded by your
    account balance and by the parallel-request caps on the Limits page. Pricing
    depends on the operation and the number of results returned, and may
    increase with additional data flags. For exact pricing, see each endpoint's
    Pricing section or your billing settings:
    https://app.generect.com/settings/billing


    # Note


    _Every endpoint must include the trailing `/`. Requests without the trailing
    slash may fail._
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.generect.com
security:
  - apiKey: []
tags:
  - name: 1. Auth
    description: Login and get user info
  - name: 2. Transactions
    description: List of latest transactions in your account
  - name: 3. Leads
    description: Fetch information about leads by _link/name/ICP_.
  - name: 4. Companies
    description: Fetch information about companies by link/name/ICP.
  - name: 5. Preview
    description: Search masked database leads for preview and reveal workflows.
  - name: 6. Enrich
    description: Enrich leads and companies by internal or external identifiers.
  - name: 7. Email
    description: Find and validate email addresses.
  - name: 8. Accounts
    description: Account profile, usage, and transactions.
  - name: 9. Search
    description: Database and realtime lead, company, and company-lead search.
  - name: 10. Phone
    description: Find phone numbers for leads.
  - name: 11. Webhooks
    description: Register and manage async job notifications.
paths:
  /api/linkedin/companies/by_icp/get_count/:
    post:
      tags:
        - 4. Companies
      summary: Count companies by ICP
      description: Estimate the number of companies matching specific search criteria.
      operationId: countCompaniesByIcp
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                get_max_companies:
                  type: boolean
                  example: true
                headcounts:
                  type: array
                  items:
                    type: string
                    example: 1-10
                  example:
                    - 1-10
                industries:
                  type: array
                  items:
                    type: string
                    example: Media Production
                  example:
                    - Media Production
                locations:
                  type: array
                  items:
                    type: string
                    example: Ontario, Canada
                  example:
                    - Ontario, Canada
                num_of_followers:
                  type: array
                  items:
                    type: string
                    example: 1-50
                  example:
                    - 1-50
                revenues_range:
                  type: object
                  properties:
                    max:
                      type: number
                      example: 5
                    min:
                      type: number
                      example: 1
            examples:
              Count companies by ICP:
                value:
                  get_max_companies: true
                  headcounts:
                    - 1-10
                  industries:
                    - Media Production
                  locations:
                    - Ontario, Canada
                  num_of_followers:
                    - 1-50
                  revenues_range:
                    max: 5
                    min: 1
      responses:
        '200':
          description: '200'
          headers:
            Allow:
              schema:
                type: string
                example: POST, OPTIONS
            Content-Length:
              schema:
                type: string
                example: '32'
            Cross-Origin-Opener-Policy:
              schema:
                type: string
                example: same-origin
            Date:
              schema:
                type: string
                example: Mon, 02 Dec 2024 22:19:04 GMT
            Referrer-Policy:
              schema:
                type: string
                example: same-origin
            Server:
              schema:
                type: string
                example: WSGIServer/0.2 CPython/3.11.10
            Vary:
              schema:
                type: string
                example: Accept, Origin
            X-Content-Type-Options:
              schema:
                type: string
                example: nosniff
            X-Frame-Options:
              schema:
                type: string
                example: DENY
          content:
            application/json:
              schema:
                type: object
                properties:
                  amount:
                    type: number
                    example: -1
                  results_count:
                    type: number
                    example: 46
              examples:
                '200':
                  value:
                    amount: -1
                    results_count: 46
      deprecated: true
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
      description: 'Use the required Token prefix. Example: Authorization: Token xxxxxxxxx'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.