# Leadinfo Docs - [Leadinfo MCP](https://docs.leadinfo.com/product/mcp/overview.md): Connect Claude, ChatGPT or any MCP client to Leadinfo and work with your identified companies, scores, contacts, traffic, lead lists and scoring setup in plain language. - [Tools](https://docs.leadinfo.com/product/mcp/tools.md): The 37 tools the Leadinfo MCP gives your assistant, grouped by what they answer, and whether each one reads or changes data. - [Core skills and prompts](https://docs.leadinfo.com/product/mcp/prompts-and-skills.md): The Leadinfo core skills: ready-made workflows for the questions sales and marketing ask most, served by the Leadinfo MCP to every client and as a plugin for Claude. - [Introduction](https://docs.leadinfo.com/introduction.md): What the Leadinfo Data API covers, how it is organised, and how it relates to the Portal and the Leadinfo MCP. - [Authentication](https://docs.leadinfo.com/authentication.md): Exchange your client credentials for a Bearer token, understand scopes, and learn which account a token acts for. - [Limits and windows](https://docs.leadinfo.com/limits.md): Rate limits, date windows, page sizes and the response envelopes used across the API. - [Trackers](https://docs.leadinfo.com/concepts/trackers.md): A tracker is one tracking script on one website. Every company, session and analytics endpoint is scoped to a tracker code. - [Companies](https://docs.leadinfo.com/concepts/companies.md): The account list: every company identified on a tracker with its activity, history, firmographics, tags, CRM status and scores, plus the drill-downs behind one company. - [Scoring](https://docs.leadinfo.com/concepts/scoring.md): The unified score and the pillars behind it: fit from the ICP Builder, intent from the Intent Builder, engagement from company activity and people from what contacts did. Every number comes with the rules and events behind it. - [Profiles: ICP, Intent and Persona Builder](https://docs.leadinfo.com/concepts/profiles.md): Describe who you sell to, which pages signal buying intent and which people you want to reach. Profiles drive the fit, intent and people pillars of the score, and the API drafts them from your own data. - [Filters](https://docs.leadinfo.com/concepts/filters.md): The filter vocabulary shared by company search, saved segments and ICP and Intent Builder profiles: fields, operators, list values and the relationship shortcut. - [People: visitors, personas and contacts](https://docs.leadinfo.com/concepts/people.md): The difference between a person identified on your website, a persona rule, and a contact from Leadinfo's database, and which endpoint returns which. - [Pagination](https://docs.leadinfo.com/concepts/pagination.md): How list responses are shaped and how to iterate through companies, sessions and signals without missing rows. - [Industries](https://docs.leadinfo.com/reference/industries.md): SIC 1987 divisions and major groups for branch_international, and the national code systems behind branch_local. - [Company sizes](https://docs.leadinfo.com/reference/company-sizes.md): The employee_range buckets and how to filter on company size. - [Countries and regions](https://docs.leadinfo.com/reference/countries-and-regions.md): ISO country codes and the countries behind each region value. - [Traffic channels](https://docs.leadinfo.com/reference/traffic-channels.md): The channel values, the sources grouped under each, and the source filters. - [Contact fields](https://docs.leadinfo.com/reference/contact-fields.md): Department values for department and dmu, and the leadership and seniority scales. - [Build a daily action list](https://docs.leadinfo.com/guides/daily-opportunities.md): Give Sales a short list of companies worth acting on today, each with the best person to contact and the reasons behind the score. - [Account-based marketing: select, understand, act](https://docs.leadinfo.com/guides/abm-prospecting.md): Pick twenty companies in an industry where you already win, understand what they showed interest in, and take a defensible next step. - [Marketing analytics](https://docs.leadinfo.com/guides/marketing-analytics.md): Read sessions with their source, medium, campaign and landing page, count them the way your report needs, and get from a traffic number to the companies behind it. - [Set up scoring profiles](https://docs.leadinfo.com/guides/scoring-profiles.md): Draft an ICP Builder and an Intent Builder profile from your own data, save them, and watch the unified score explain itself. - [Identity, granted scopes and an account overview for the calling token](https://docs.leadinfo.com/api-reference/auth/identity-granted-scopes-and-an-account-overview-for-the-calling-token.md) - [Get the access token for client credentials (GET alias)](https://docs.leadinfo.com/api-reference/auth/get-the-access-token-for-client-credentials-get-alias.md): Exchange `X-Client-ID` + `X-Client-Secret` headers for an OAuth2 Bearer access token. This is the **only** endpoint in the public API that accepts client credentials directly — every other endpoint requires the resulting `Authorization: Bearer ` header. - [Get the access token for client credentials](https://docs.leadinfo.com/api-reference/auth/get-the-access-token-for-client-credentials.md): Exchange `X-Client-ID` + `X-Client-Secret` headers for an OAuth2 Bearer access token. This is the **only** endpoint in the public API that accepts client credentials directly — every other endpoint requires the resulting `Authorization: Bearer ` header. - [Identify Domain by IP Address](https://docs.leadinfo.com/api-reference/identify/identify-domain-by-ip-address.md): Resolve IPv4 or IPv6 addresses to a domain and company_id. A quantitative score and a qualitative confidence score is given for every successful result. Charged 1 credit only when a domain is returned — not-found IPs return 404 with no charge. - [Sessions counted per channel, campaign, landing page, sector and more](https://docs.leadinfo.com/api-reference/traffic/sessions-counted-per-channel-campaign-landing-page-sector-and-more.md): Sessions of the window counted per group, with distinct companies, bounce (at most one page) and averages; the grouped view of /sessions with the same filters. Without group_by: one row with the window's totals. Sectors are SIC major groups of the visiting companies. - [Sessions counted per group, with filter conditions](https://docs.leadinfo.com/api-reference/traffic/sessions-counted-per-group-with-filter-conditions.md): Sessions of the window counted per group, with distinct companies, bounce (at most one page) and averages; the grouped view of /sessions with the same filters. Without group_by: one row with the window's totals. Sectors are SIC major groups of the visiting companies. - [List trackers owned by the authenticated client](https://docs.leadinfo.com/api-reference/traffic/list-trackers-owned-by-the-authenticated-client.md) - [Raw session rows for a tracker over a date range](https://docs.leadinfo.com/api-reference/traffic/raw-session-rows-for-a-tracker-over-a-date-range.md) - [Search session rows for a tracker with filter conditions](https://docs.leadinfo.com/api-reference/traffic/search-session-rows-for-a-tracker-with-filter-conditions.md) - [Sessions for a single company under a tracker (drill-down)](https://docs.leadinfo.com/api-reference/traffic/sessions-for-a-single-company-under-a-tracker-drill-down.md) - [Pages one company viewed on this tracker, with view counts and first and last seen](https://docs.leadinfo.com/api-reference/traffic/pages-one-company-viewed-on-this-tracker-with-view-counts-and-first-and-last-seen.md): The per-account signal trail: which pages the company looked at in the window and when. The company was identified, not a person; do not present these views as the behaviour of a specific contact. - [Form submissions with their captured field values](https://docs.leadinfo.com/api-reference/traffic/form-submissions-with-their-captured-field-values.md) - [Company details by company_id](https://docs.leadinfo.com/api-reference/traffic/company-details-by-company_id.md) - [List tags visible to the authenticated client](https://docs.leadinfo.com/api-reference/traffic/list-tags-visible-to-the-authenticated-client.md) - [List saved segments for the authenticated client, including their filter rules](https://docs.leadinfo.com/api-reference/traffic/list-saved-segments-for-the-authenticated-client-including-their-filter-rules.md) - [People identified at visitor companies (email, name, job title, LinkedIn)](https://docs.leadinfo.com/api-reference/traffic/people-identified-at-visitor-companies-email-name-job-title-linkedin.md): Named people captured through Persona Insights. This is the only endpoint where a person is known to have been on the website; every other endpoint identifies the company. Do not tell contacts they were tracked or list the pages they viewed. - [Leadbot conversation submissions with their captured field values](https://docs.leadinfo.com/api-reference/traffic/leadbot-conversation-submissions-with-their-captured-field-values.md) - [Identified companies for a tracker with engagement, firmographics and tags](https://docs.leadinfo.com/api-reference/traffic/identified-companies-for-a-tracker-with-engagement-firmographics-and-tags.md) - [Search identified companies with nested AND/OR filters and saved segments](https://docs.leadinfo.com/api-reference/traffic/search-identified-companies-with-nested-andor-filters-and-saved-segments.md) - [Why a company scores what it scores](https://docs.leadinfo.com/api-reference/traffic/why-a-company-scores-what-it-scores.md): The unified score decomposed into its pillars (fit from the ICP Builder or the model, intent from the Intent Builder, persona-matched visitors, engagement), with the rules matched and missed, the pages viewed in the window, the observed facts and what the data cannot tell. Defaults to the 90-day eng… - [How a company's score changed over time, and why](https://docs.leadinfo.com/api-reference/traffic/how-a-companys-score-changed-over-time-and-why.md): Every recorded change of the stored score, newest first: the score, the previous score and delta, the pillar values, the causes (new events, fading activity, a profile change, company data or signal weights) and the events that arrived. Changes of 2 points or more, or with a cause other than fading… - [Companies whose score moved in a period, and why](https://docs.leadinfo.com/api-reference/traffic/companies-whose-score-moved-in-a-period-and-why.md): The movers feed for accounts on stored scoring: who rose, who fell and who became hot or warm in the last `days`, each with the score before and after, the tier, the causes merged per pillar and one plain-language summary such as 'Quillis rose from 58 to 63 and is now warm. New activity: form submis… - [Contacts at a recognised company, persona matches first](https://docs.leadinfo.com/api-reference/traffic/contacts-at-a-recognised-company-persona-matches-first.md): People from Leadinfo's contact database who work at the company; they did not necessarily visit the website. Narrow with persona_id, department, dmu (the department's decision makers) or position_keyword. - [Companies to act on now, each with the person to approach](https://docs.leadinfo.com/api-reference/traffic/companies-to-act-on-now-each-with-the-person-to-approach.md): The account's companies by score, highest first, straight from the stored scores (updated in real time on every signal and faded nightly). AI assistants and shared-network traffic are never scored. `tier` starts at hot, warm, cool or cold and fills up to `limit` from the tiers below; `meta.in_tier`… - [Draft an ICP Builder, Intent Builder or Persona Builder profile from the account's data](https://docs.leadinfo.com/api-reference/profiles/draft-an-icp-builder-intent-builder-or-persona-builder-profile-from-the-accounts-data.md): A first draft to review and save with POST /profiles/{kind}. `kind=icp`: sector (SIC major groups on branch_international), size and country rules from the companies tagged customer on the tracker (`basis=customers`), from the CRM-linked companies (`basis=crm`), or, for accounts without either, from… - [How the unified company score is computed for this account](https://docs.leadinfo.com/api-reference/profiles/how-the-unified-company-score-is-computed-for-this-account.md): The pillars behind `score` on company rows (fit, intent, persona, activity), their effective weights, the active ICP Builder and Intent Builder profiles (each company gets its best match among them), the engagement model and a short reading guide. Meant for explaining the score to users; per-company… ## OpenAPI Specs - [openapi](/api-reference/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.