LEleadfeeder
Web Visits
v1

Retrieve Goals

Changed on

Retrieve all goals defined in the account. A goal is a page-view condition — on the page URL or title, a form submission, a file download or a video — that marks the page views signalling buying intent, such as visits to a pricing page. relationships.custom_feed links a goal to the Web Visits custom feed listing the companies with a page view meeting it, and a custom feed's advanced_filters can filter on the goal field with a goal's id.

Credit Note: Retrieving goals does not consume credits.

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

get/v1/web-visits/goals

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/web-visits/goals
  • 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: web_visits:read

Query parameters

account_idstring required

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

Response

Success

Example response

{
  "data": [
    {
      "attributes": {
        "created_at": "2026-10-01T10:00:00.000Z",
        "criterion": {
          "field": "page_url",
          "operator": "contains",
          "value": "/pricing"
        },
        "enabled": true,
        "name": "Pricing page",
        "updated_at": "2026-10-02T11:00:00.000Z"
      },
      "id": "4182",
      "relationships": {
        "custom_feed": {
          "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "type": "custom_feed"
        }
      },
      "type": "goal"
    }
  ],
  "meta": {
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}

Changes