Companies

Search Companies

Perform search queries using criteria like name, location, industry, size or filters like has_phone. Returns matching company IDs and basic company information. Credit Note: Searches do not consume credits. Credits are only used if you subsequently retrieve deep data for a company not accessed within the last 12 months.

:::info Requires the companies:read OAuth2 scope. :::

post/v1/companies/search

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

page[cursor]string

Cursor for pagination. Use this value to fetch the next page of results.

page[size]integer

The number of items per page. Maximum is 100.

Request body

search_termsstring[]

List of strings to match against company name, alternative names, trade name and domain(s).

employee_rangesstring[]

List of employee count ranges (e.g. 1-10, 51-200) to filter companies by size.

icp_idsstring[]

List of Ideal Customer Profile (ICP) IDs to use as a filter. The search will return companies that match the criteria of at least one of the referenced ICPs (multiple ICPs are combined using OR).

ICP IDs can be retrieved from the Retrieve Ideal Customer Profiles endpoint. Unknown or invalid IDs are ignored; if none of the supplied IDs exist or have valid filters, the search returns no results.

Example request

{
  "search_terms": [
    "Leadfeeder"
  ],
  "locations": [
    {
      "street": "Durlacher Allee 73",
      "postal_code": "76131",
      "city": "Karlsruhe",
      "country_code": "DE",
      "region_code": "DE1",
      "geo": {
        "latitude": 49.01,
        "longitude": 8.43,
        "distance": 20
      }
    }
  ],
  "industries": {
    "classification": "internal",
    "codes": [
      "1594"
    ]
  },
  "employee_ranges": [
    "101-500",
    "501-1.000"
  ],
  "revenue": {
    "min": 1000000,
    "max": 5000000
  },
  "icp_ids": [
    "6080",
    "6081"
  ]
}

Response

Success

Example response

{
  "data": [
    {
      "type": "company_summary",
      "id": "129011",
      "attributes": {
        "name": "Dealfront Group GmbH",
        "url": "https://www.leadfeeder.com/welcome",
        "logo_url": "https://app.dealfront.com/logos/200/694ad7b1-lf-logo-2026-04-16.jpg",
        "address": {
          "city": "Karlsruhe",
          "country": "Germany",
          "country_code": "DE"
        },
        "industries": {
          "industry": [
            {
              "name": "Software Development",
              "code": "1594.6.4"
            }
          ]
        },
        "employee_range": "101-500",
        "revenue": {
          "currency": "EUR",
          "year": 2020,
          "value": 9694333,
          "value_eur": 9694333
        },
        "role": "group_member",
        "register": {
          "status": "active"
        },
        "meta": {
          "has_phones": true,
          "has_mail": true,
          "has_social_accounts": true,
          "has_register_id": true,
          "has_vat_id": true,
          "has_financials_revenue": true,
          "has_financials_earnings": true,
          "has_financials_net_worth": true,
          "has_ip_addresses": true
        }
      },
      "relationships": {
        "group_company": {
          "id": "129011"
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "next_cursor": "dXNlcjpVMEc5V0ZYTlo",
      "total_count": 1450
    },
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

Changed in 4 of the 19 revisions of this API.112

Sep 3, 2026ac752c6c2be06See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Sep 2, 20267a571092a3081See the full diff
- ▲
  the response property /////// became nullable for the status
  response-property-became-nullable
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Aug 4, 2026e036d9337a941See the full diff
- ○
  added the required property //// to the response with the status
  response-required-property-added
Jul 26, 20267f61434b15da5See the full diff
- ○
  added the required property //// to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added
- ○
  added the required property //// to the response with the status
  response-required-property-added

Of the 19 revisions, 1 has no diff computed.

Full history