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.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#
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.{
"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.To retrieve detailed information about a specific account, including credit usage:{
"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:{
"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