v3

latestOpenAPI 3.1.1mit2026-07-3165481.5 MB
Companies
v1

Search Company Signals

Retrieve signals for a specified set of company IDs. The response returns the signals linked to the provided companies. Credit Node: You are charged 1 credit per company if the company has signals and there was no active deep data access within the last 12 months. The number of signals returned does not affect credit usage — no additional credits are charged per signal.

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

post/v1/companies/signals

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

categoriesstring[]

Filter to search for signals in specific categories

company_idsstring[] required

Array of company IDs to filter signals for (mandatory)

Example request

{
  "categories": [
    "business_expansion",
    "investment_activity"
  ],
  "company_ids": [
    "159001425",
    "129011"
  ],
  "publication_date": {
    "from": "2023-01-01",
    "to": "2023-12-31"
  },
  "event_date": {
    "from": "2023-01-01",
    "to": "2023-12-31"
  }
}

Response

Success

Example response

{
  "data": [
    {
      "type": "signal",
      "id": "574654454",
      "attributes": {
        "category": "business_expansion",
        "signal_type": "expands_facilities",
        "title": "TS Conductor invests $134M in South Carolina for new manufacturing facility",
        "content": "B2B sales intelligence platform Dealfront has raised a €30 million investment from AshGrove Capital...",
        "event_date": "2024-12-10T15:57:25Z",
        "publication_date": "2024-11-24T11:50:00Z",
        "source_url": "https://tech.eu/2024/12/10/dealfront-secures-30m-from-ashgrove-capital-for-b2b-sales-intelligence",
        "language_code": "EN"
      },
      "relationships": {
        "company": {
          "id": "129011"
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "next_cursor": "dXNlcjpVMEc5V0ZYTlo",
      "total_count": 1450
    },
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}