v1

latestOpenAPI 3.1.02026-07-26103879.6 KB

Search company

Search for companies based on various filters. Multiple filters within the same field are combined with AND logic.

post/company/search

Request body

offsetinteger

Number of companies to skip (use this for pagination). Maximum value is 10,000. To paginate beyond 10,000 results, use search_after instead.

limitinteger

Number of companies to return (default: 10, max: 100)

search_afterstring

Cursor-based pagination. Pass the search_after value from the previous response to get the next page. Works at any point in the result set, but is required to access results beyond the 10,000 offset limit. The search_after token does not have any expiration date. However, when the database is updated (every month), if the position of a company changes, the same search_after token might display different results.

Example request

{
  "offset": 20,
  "limit": 20,
  "search_after": "WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0=",
  "names": [
    {
      "value": "Microsoft",
      "exact_match": true,
      "exclude": false
    }
  ],
  "domains": [
    {
      "value": "microsoft.com",
      "exact_match": true,
      "exclude": false
    }
  ],
  "professional_network_ids": [
    {
      "value": 1234,
      "exact_match": true,
      "exclude": false
    }
  ],
  "professional_network_urls": [
    {
      "value": "https://www.linkedin.com/company/fullenrich",
      "exact_match": true,
      "exclude": false
    }
  ],
  "keywords": [
    {
      "value": "innovative and practical products",
      "exact_match": false,
      "exclude": false
    }
  ],
  "specialties": [
    {
      "value": "AI safety",
      "exact_match": false,
      "exclude": false
    }
  ],
  "industries": [
    {
      "value": "Software Development",
      "exact_match": false,
      "exclude": false
    },
    {
      "value": "Computer Hardware Manufacturing",
      "exact_match": false,
      "exclude": false
    }
  ],
  "types": [
    {
      "value": "Public Company",
      "exact_match": true,
      "exclude": false
    }
  ],
  "headquarters_locations": [
    {
      "value": "San Francisco",
      "exact_match": false,
      "exclude": false
    }
  ],
  "founded_years": [
    {
      "min": 2015,
      "max": 2024,
      "exclude": false
    }
  ],
  "headcounts": [
    {
      "min": 100,
      "max": 500,
      "exclude": false
    }
  ],
  "company_ids": [
    {
      "value": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "exact_match": true
    }
  ]
}

Response

Example response

{
  "companies": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Anthropic",
      "domain": "anthropic.com",
      "description": "AI safety and research company building reliable, interpretable, and steerable AI systems.",
      "year_founded": 2021,
      "headcount": 2610,
      "headcount_range": "1001-5000",
      "company_type": "Privately Held",
      "locations": {
        "headquarters": {
          "line1": "548 Market St",
          "line2": "San Francisco, CA 94105, US",
          "city": "San Francisco",
          "region": "California",
          "country": "United States",
          "country_code": "US"
        },
        "offices": [
          {
            "line1": "111 8th Ave",
            "line2": "New York, NY 10011, US"
          }
        ]
      },
      "social_profiles": {
        "professional_network": {
          "id": 1234,
          "url": "https://www.linkedin.com/company/anthropic",
          "handle": "anthropic",
          "connection_count": 125000
        }
      },
      "specialties": [
        "artificial intelligence",
        "machine learning",
        "AI safety"
      ],
      "industry": {
        "main_industry": "Software Development"
      }
    }
  ],
  "metadata": {
    "total": 20523,
    "credits": 22.5,
    "search_after": "WzE1LjUzNDU2MywiYjQ5MDBiYmQtOTg5MS01Mzk1LWIyODUtOWEyOGNiZThjOTM3Il0="
  }
}