LEleadfeeder
Campaigns
v1

Retrieve Campaign Stats

Changed on

Retrieve statistics for a specific campaign over a defined time period. Use frequency, start_period, and end_period to control how the campaign performance data is grouped and returned.

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

get/v1/campaigns/{id}/stats

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/campaigns/{id}/stats
  • 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: campaigns:read

Path parameters

idstring required

The campaign ID.

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

frequency'day' | 'week' | 'month' required

Bucket granularity for the returned stats series.

start_periodstring date required

Inclusive start of the reporting window (ISO 8601 calendar date, YYYY-MM-DD). Must be on or before end_period.

end_periodstring date required

Inclusive end of the reporting window (ISO 8601 calendar date, YYYY-MM-DD). Must be on or after start_period.

page[num]integer

Page of results to fetch.

page[size]integer

The number of items per page. Maximum is 100.

Response

Success

Example response

{
  "data": [
    {
      "attributes": {
        "currency": "EUR",
        "date": "2026-04-15",
        "ecpm": 12340,
        "ecpv": 53.65,
        "impressions": 100,
        "influenced_count": 1,
        "reached_count": 1,
        "total_cost": 1234,
        "visits": 23,
        "vtr": 23
      },
      "id": "MTIzNHwyMDI2LTA0LTE1fDIwMjYtMDQtMTU=",
      "type": "campaign_stats"
    }
  ],
  "meta": {
    "pagination": {
      "page_count": 1,
      "page_num": 1,
      "total_count": 1
    },
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes

  • ac752c6c2be0Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 12ae8a6b9fadRevision changes
    • info

      endpoint added