Leadfeeder API
    • Leadfeeder API
    • Authentication
    • Getting Started
    • Rate Limits
    • Relationships
    • Company ID Lifecycle
    • OpenAPI Specification Access
    • List of NACE / WZ codes
    • List of Industries
    • AI & MCP (Beta)
      • Overview of the Leadfeeder MCP Server
      • Quickstart
      • Connect your AI tool
      • Authentication and permissions
    • Account
      • List Accounts
    • Companies
      • Get Company Details
      • Create Company Enrichment Job
      • Estimate Company Enrichment Job
      • Retrieve Companies
      • Company Financial Reports
      • Get Company Enrichment Job Status
      • Retrieve Company IPs
      • Match Companies
      • Search Companies
      • Search Company Signals
      • Update a Company
      • Remove Company from Lists
      • Add Company to Lists
      • Unassign Tags from Company
      • Assign Tags to Company
    • Contacts
      • Get Contact Details
      • Create Find Contact Data Job
      • Estimate Find Contact Data Job
      • Retrieve Contacts
      • Get Find Contact Data Job Status
      • Search Contacts
      • Update a Contact
      • Remove Contact from Lists
      • Add Contact to Lists
    • Web Visits
      • How to Create Custom Feed
      • Custom Feed - Filter Reference
      • Search Web Visits
      • Retrieve Custom Feeds
      • Retrieve Visitor Companies
      • Create a Custom Feed
      • Get Custom Feed Details
      • Update Custom Feed
      • Delete a Custom Feed
      • Retrieve Custom Feeds Folders
      • Retrieve Web Visits Tracker Script
    • Campaigns
      • Retrieve Campaigns
      • Get Campaign Details
      • Update Campaign
      • Retrieve Campaign Stats
    • IP
      • Enrich Company IP Address
    • Buyer Personas
      • Retrieve Buyer Personas
      • Create a Buyer Persona
      • Get Buyer Persona Details
      • Delete a Buyer Persona
      • Update a Buyer Persona
    • Ideal Customer Profiles
      • Retrieve Ideal Customer Profiles
      • Create an Ideal Customer Profile
      • Retrieve Company ICP Matches
      • Get Ideal Customer Profile Details
      • Delete an Ideal Customer Profile
      • Update an Ideal Customer Profile
    • Tags
      • Retrieve Tags
      • Create Tag
      • Create Batch Add Tags Job
      • Get Batch Add Tags Job
      • Delete Tag
      • Create Batch Remove Tags Job
      • Get Batch Remove Tags Job
      • Get Tag Details
      • Update Tag
    • Lists
      • Retrieve Lists
      • Create a List
      • Create Batch Add to List Job
      • Get List Details
      • Get Batch Add to List Job
      • Create Batch Remove from List Job
      • Delete List
      • Get Batch Remove from List Job
      • Retrieve Company List Memberships
      • Retrieve Contact List Memberships
      • Update List
      • Retrieve List Items
    • Custom Fields
      • Retrieve Custom Fields
      • Create Custom Field
      • Get Custom Field Details
      • Delete Custom Field
      • Update Custom Field
    • Users
      • Get Current User
    • Settings
      • Update Cookie Consent Settings
      • Get Data Processing Settings
      • Update Data Processing Settings
      • Get Cookie Consent Settings
    • Usage
      • Get Endpoints Usage
    • Reference Data
      • Get Geo Suggestions
      • Get Countries with Regions
      • Get Industries
    • Schemas
      • AccountCompanyV1
      • AccountSummaryV1
      • AccountV1
      • ApiUsageV1
      • BatchAddTagsJobV1
      • BatchAddToListJobV1
      • BatchRemoveFromListJobV1
      • BatchRemoveTagsJobV1
      • BuyerPersonaRequestV1
      • BuyerPersonaV1
      • CampaignLocationV1
      • CampaignSettingsV1
      • CampaignStatsV1
      • CampaignSummaryV1
      • CampaignV1
      • CompaniesAdvancedSearchFilterItem
      • CompanyFinancialsV1
      • CompanyIndustryV1
      • CompanyLocationV1
      • CompanyIpV1
      • CompanyMatchV1
      • CompanySummaryV1
      • CompanyV1
      • ContactFilterGroupsV1
      • ContactSummaryV1
      • ContactV1
      • CookieConsentSettingsV1
      • CountryV1
      • CustomFeedFolderV1
      • CustomFeedRequestV1
      • CustomFeedV1
      • CustomFieldV1
      • DataProcessingSettingsV1
      • EnrichedIpV1
      • CRMUserV1
      • ErrorObjectV1
      • CRMOrganizationV1
      • EnrichmentJobV1
      • CRMContactV1
      • GeoSuggestionV1
      • FindContactDataJobV1
      • CRMLeadV1
      • ICPV1
      • CRMConnectionV1
      • IpAddressExtendedV1
      • IcpRequestV1
      • CRMSuggestionV1
      • IpLocationV1
      • CRMGroupConnectionV1
      • LocationV1
      • ListV1
      • MaskedCompanySummaryV1
      • MaskedContactSummaryV1
      • NetworkV1
      • SignalV1
      • UserV1
      • TagV1
      • VisitLocationV1
      • WebVisitV1
      • WebVisitsTrackerScriptV1

    Getting Started

    The Leadfeeder API enables you to programmatically access company and contact intelligence, website visitor data, and manage your workflow objects. This guide walks you through the initial setup to start making your first API requests.

    Prerequisites#

    Before you begin, ensure you have:
    An active Leadfeeder account
    🚀
    Don't have a Leadfeeder account yet?
    Start a free 14-day trial — no credit card required. Once your account is active, come back to Step 1 to generate your API key.
    User permissions to generate API keys
    A development environment capable of making HTTPS requests

    Step 1: Generate Your API Key#

    Each Leadfeeder user can generate their own API keys for authentication.
    To create an API key:
    1.
    Log in to the Leadfeeder platform
    2.
    Navigate to Settings ⚙ → Personal → API Keys
    3.
    Click Create a new API key
    4.
    Copy and securely store your API key
    Note: If you do not see the API keys section, contact your account administrator to grant the necessary permissions.
    For detailed information on how to configure authentication in your requests, see Authentication.

    Step 2: Find Your Account ID#

    Most API endpoints require an account_id parameter to specify which account's data you want to access. Your user may have access to multiple Leadfeeder accounts.

    Option A: Copy it from the app#

    1.
    Go to Settings ⚙ → Account or directly click on https://app.leadfeeder.com/l/settings/website/
    2.
    In the General section, find Account ID.
    3.
    Click the copy button next to it.
    The ID is now on your clipboard, ready to paste into a request or a prompt.

    Option B: Call the List Accounts endpoint#

    Use this when your API key has access to several accounts and you want them all
    in one response.
    Request
    Response
    {
      "data": [
        {
          "type": "account_summary",
          "id": "123456",
          "attributes": {
            "name": "Account 1"
          }
        },
        {
          "type": "account_summary",
          "id": "789012",
          "attributes": {
            "name": "Account 2"
          }
        }
      ],
      "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
      }
    }
    The id field contains your account_id.

    Get Account Details with Credit Information##

    To retrieve detailed information about a specific account, including credit usage:
    Request
    Response
    {
      "data": [
        {
          "type": "account",
          "id": "123456",
          "attributes": {
            "name": "Account 1",
            "credits": {
              "available": 1000,
              "used": 200,
              "remaining": 800,
              "next_reset_on": "2026-10-01"
            }
          }
        }
      ],
      "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
      }
    }

    Step 3: Make Your First API Request#

    Once you have your API key and account ID, you can start making requests to the API.

    Example: Search for Companies#

    Let's search for companies in a specific location and industry:
    Request
    Response
    {
      "data": [
        {
          "type": "company_summary",
          "id": "159001425",
          "attributes": {
            "name": "Example Company Ltd",
            "role": "group_member",
            "register": {
              "status": "active"
            },
            "meta": {
              "do_not_contact": false,
              "has_phones": true,
              "has_mail": true,
              "has_contacts": true
            }
          }
        }
      ],
      "meta": {
        "credits": {
          "charged": 0
        },
        "pagination": {
          "next_cursor": "dXNlcjpVMEc5V0ZYTlo",
          "total_count": 145
        },
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
      }
    }

    Understanding the account_id Parameter#

    The account_id is a required parameter for most API endpoints. It determines:
    Which account's data is accessed
    Which credit pool is used for requests that consume credits
    Which permissions and access levels apply

    Don't have an account yet?#

    Start a free trial
    No Leadfeeder account yet? Create one in a few minutes and get your API key and account ID.
    Book a demo
    We advise you individually about your unique use cases and act as a partner to answer all your questions.
    Modified at 2026-08-20 11:34:30
    Previous
    Authentication
    Next
    Rate Limits
    Built with