Sign in

v3

OpenAPI 3.1.1mit2026-07-3165481.5 MB
Companies
v1

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",
        "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"
  }
}