Search Companies

POST

/v1/companies/search

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.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Success

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429Too Many Requests

🔴500Server Error

🔴504Gateway Timeout

Request Example

Shell

JavaScript

Java

Swift

cURL

Simple search by company nameSearch by location and industryComprehensive search with multiple criteria

curl --location -g --request POST 'https://api.leadfeeder.com/v1/companies/search?account_id=123456&page[cursor]=WyAzNzAwMCwgIjIzNTYyMCJd&page[size]=20' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "search_terms": [
        "Microsoft"
    ]
}'

Response Example

200 - Example 1

{
    "data": [
        {
            "type": "company_summary",
            "id": "129011",
            "attributes": {
                "name": "Dealfront Group GmbH",
                "role": "single_entity",
                "register": {
                    "status": "active"
                },
                "meta": {
                    "do_not_contact": false,
                    "has_updated_id": false,
                    "has_phones": true,
                    "has_fax": false,
                    "has_mail": true,
                    "has_contacts": false,
                    "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",
                    "type": "company"
                }
            }
        }
    ],
    "meta": {
        "credits": {
            "charged": 0
        },
        "pagination": {
            "next_cursor": "dXNlcjpVMEc5V0ZYTlo",
            "total_count": 1450
        },
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

Modified at 2026-04-14 13:35:01

Search Company Signals

Match Companies