> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Leadfeeder

> Connect Leadfeeder to your Atako agents — 16 read and 10 write actions.

Let your agents read the companies that visit your website (Leadfeeder / Dealfront Web Visitors), their visits, custom feeds, goals, tags and lists, and manage tags and list membership.

## Connection

* **Authentication**: API key.

> [!NOTE]
>
> In Leadfeeder (Dealfront): Settings → Personal tab → API Keys → "Create a new API key". The value is shown once, copy it then. API access only exists on a trial and on paid plans (Discover and above), not on the free Lite plan.
>
> See [Leadfeeder's documentation](https://docs.leadfeeder.com/api/public).

## Read actions (16)

| Action | Description |
| - | - |
| `get_companies` | Retrieve companies by their ids, with full deep data. Arguments: ids (required, array of company id strings, sent comma-separated); account\_id (required); include (string, e.g. tags, lists, web\_visits, icps, crm\_connections…). Credit note: each company consumes 1 credit unless it was already accessed within the last 12 months. |
| `get_company` | Get one company by id, with firmographics and hierarchy. Arguments: id (string, Leadfeeder company id, in the path); account\_id (required); include (string, e.g. tags, lists, web\_visits, icps…). Credit note: accessing full deep data consumes 1 credit unless the company was accessed within the last 12 months. |
| `get_company_financials` | Get the financial reports available for a company. Arguments: id (string, Leadfeeder company id, in the path); account\_id (required). Credit note: consumes 1 credit per company only if financial data is available and there was no active deep-data access within the last 12 months. |
| `get_current_user` | Get the current API user (id, e-mail, first and last name, phone, country, team role). Needs no account\_id. |
| `get_custom_feed` | Get one web-visits custom feed by id (name, folder, filters). Arguments: custom\_feed\_id (string, from list\_custom\_feeds, in the path); account\_id (required); include (string, folder and/or connected\_list). |
| `get_list` | Get one list by id (name, scope, list\_type). Arguments: id (string, scope-prefixed list id such as company\_123, from list\_lists, in the path); account\_id (required). Retrieving a list does not consume credits. |
| `get_usage` | Get the API usage per endpoint for an account over a period (successful and failed request counts). Arguments: account\_id (required); start\_period and end\_period (required, YYYY-MM). |
| `list_accounts` | Check the API key and list the Leadfeeder accounts it can access. Without account\_id: every account with its name only; with account\_id: that account with its credit details. The account\_id to pass to every other action comes from here. |
| `list_custom_feeds` | List the web-visits custom feeds of an account. Arguments: account\_id (required); include (string, folder and/or connected\_list) adds the folder and the connected list; filter\_has\_connected\_list (boolean) keeps only feeds with (true) or without (false) a connected list. |
| `list_goals` | List the goals of an account (a page-view condition marking buying intent, e.g. a pricing-page view). Argument: account\_id (required). Retrieving goals does not consume credits. |
| `list_list_items` | List the members of a list as bare references (ids only): give them to get\_companies. Arguments: id (string, scope-prefixed list id, in the path); account\_id (required); page\_cursor (string, page\[cursor] from the previous page); page\_size (integer 1 to 100, default 20). Retrieving members does not consume credits. |
| `list_lists` | List the lists of an account. Arguments: account\_id (required); scope (required, company or contact — sent as filter\[scope], it is mandatory); page\_num (integer >= 1); page\_size (integer 1 to 100, default 20). Retrieving lists does not consume credits. |
| `list_tags` | List the tags of an account (id, name, colour) — the ids used by add\_tags\_to\_company. Arguments: account\_id (required); page\_num (integer >= 1); page\_size (integer 1 to 100, default 20). Retrieving tags does not consume credits. |
| `list_visiting_companies` | List the companies that visited your website within a date range, each with its inferred geographic location. Arguments: account\_id (required); start\_date and end\_date (required, YYYY-MM-DD, inclusive); custom\_feed\_id (string, only that custom feed); include=company (string) adds the company object; page\_num (integer >= 1); page\_size (integer 1 to 100, default 20). Reading web visits does not consume credits. |
| `search_companies` | Search companies by criteria (a read: POST carries the search body). Arguments: account\_id (required, query); at least one of search\_terms (string\[]), locations (array of \{ street, postal\_code, city, country\_code, region\_code, geo:\{ latitude, longitude, distance } }), industries \{ classification: internal\|wz\|nace, codes: string\[] }, employee\_ranges (array of "1-10", "11-100", "101-500", "501-1.000", "1.001-5.000", "5.001-10.000", "10.000+"), revenue \{ min, max } (EUR), icp\_ids (string\[]), filters \{ do\_not\_contact, has\_email, has\_financials\_earnings, has\_financials\_net\_worth, has\_financials\_revenue, has\_ip\_addresses, has\_phone, has\_social\_media\_profiles } (booleans); page\_cursor (string); page\_size (integer 1 to 100, default 20). Credit note: searches do not consume credits; credits are only used if you then retrieve deep data for a company not accessed within the last 12 months. |
| `search_web_visits` | Search web visits within a date range (a read: POST carries the filter body). Arguments: account\_id (required, query); start\_date and end\_date (required, YYYY-MM-DD, inclusive); filters — simple inline filters \{ company\_id (string), location\_cities (string\[]), location\_country\_codes (string\[], ISO 3166-1 alpha-2) } — or advanced\_filters (object, a fixed custom-feed-style filter tree), one or the other, never both; include=company (string); page\_num (integer >= 1); page\_size (integer 1 to 100, default 20). Searching web visits does not consume credits. |

## Write actions (10)

| Action | Description |
| - | - |
| `add_companies_to_list` | Add a company to one or more company lists. Arguments: id (string, company id, in the path); account\_id (required, query); list\_ids (array of company list id strings, required — e.g. company\_123, from list\_lists with scope company). Adding a company to lists does not consume credits. |
| `add_contacts_to_list` | Add a contact to one or more contact lists. Arguments: id (string, contact id, in the path); account\_id (required, query); list\_ids (array of contact list id strings, required — e.g. contact\_456, from list\_lists with scope contact). Adding a contact to lists does not consume credits. |
| `add_tags_to_company` | Assign one or more tags to a company. Arguments: id (string, company id, in the path); account\_id (required, query); tag\_ids (array of tag id strings, required — from list\_tags). Assigning tags does not consume credits. |
| `create_list` | Create a list. Arguments: account\_id (required, query); name (string, required); scope (string, required: company or contact). Creating a list does not consume credits. |
| `create_tag` | Create a tag that can be assigned to companies. Arguments: account\_id (required, query); name (string, required); color (integer 0 to 9, required — 0 #1B70F0, 1 #08A360, 2 #AE540D, 3 #D42422, 4 #5A219B, 5 #073572, 6 #00838F, 7 #D42422, 8 #B61A5C, 9 #4C3AED). Creating tags does not consume credits. |
| `remove_companies_from_list` | Remove a company from one or more company lists. Arguments: id (string, company id, in the path); account\_id (required, query); list\_ids (array of company list id strings, required). Removing a company from lists does not consume credits. |
| `remove_contacts_from_list` | Remove a contact from one or more contact lists. Arguments: id (string, contact id, in the path); account\_id (required, query); list\_ids (array of contact list id strings, required). Removing a contact from lists does not consume credits. |
| `remove_tags_from_company` | Unassign one or more tags from a company (it removes the association, not the tag). Arguments: id (string, company id, in the path); account\_id (required, query); tag\_ids (array of tag id strings, required). Unassigning tags does not consume credits. |
| `update_list` | Rename a list. Arguments: id (string, scope-prefixed list id, in the path); account\_id (required, query); name (string, required). Updating a list does not consume credits. |
| `update_tag` | Update a tag — only the fields you pass change. Arguments: id (string, tag id, in the path); account\_id (required, query); name (string); color (integer 0 to 9). At least one of name or color is required. Updating tags does not consume credits. |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](https://docs.atako.ai/integrations/permissions.md) for the grant model and [Security](https://docs.atako.ai/integrations/security.md) for how credentials are protected.

***

*Last reviewed against the provider API: October 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.