LEleadfeeder
Companies
v1

Search Companies

Changed on

Perform search queries using criteria like name, location, industry, size or filters like has_phone. Returns matching company IDs and basic company information. Important: At least one search criterion must be provided: search_terms, locations, industries, employee_ranges, revenue, icp_ids, or filters. Each entry in locations must likewise carry at least one of street, postal_code, city, country_code, region_code, or geo. 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

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/companies/search
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: companies:read

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

OR
OR
OR
OR
OR
OR

Example request

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

Response

Success

Example response

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

Changes

  • 03bad8f3c93dRevision changes
    • info

      added subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 subschema #6 subschema #7 to the request body anyOf list

    • info

      added subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 subschema #6 to the / request property anyOf list

  • 1a2c2b1d560fRevision changes
    • breaking

      the response property /////// became nullable for the status