Companies
v1

Search Company Signals

Changed on

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

Request

  • Base URL
    https://api.leadfeeder.com
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization codehttps://api.leadfeeder.com/v1/oauth/authorize
      Token URLhttps://api.leadfeeder.com/v1/oauth/token
      Scopescompanies: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

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"
  ],
  "event_date": {
    "from": "2023-01-01",
    "to": "2023-12-31"
  },
  "publication_date": {
    "from": "2023-01-01",
    "to": "2023-12-31"
  }
}

Response

Success

Example response

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

Changes

    • breaking

      the response property data/items/attributes/source_url became nullable for the status

    • warning

      added the new employee_count_changes enum value to the data/items/attributes/category response property for the response status

    • warning

      added the new revenue_changes enum value to the data/items/attributes/category response property for the response status

    2 more changes in this revision