Get started

Funnelfeedr API

Match organizations and people against Funnelfeedr's Nordic B2B data, find the right contacts and switchboards, and reveal organization and contact details from your own systems and AI agents, with an account-level API key.

The Funnelfeedr API is a REST API for prospecting. Use it to enrich a CRM, clean an import, feed a lead pipeline or give your own AI agent access to Funnelfeedr's organization and contact data.

https://api.funnelfeedr.com/external/v1

Start with your AI agent

Building with Claude Code, Cursor, Codex or another agent? Send it this message. It points the agent to the docs and the credit rules, and it reads the rest on its own.

I want to use the Funnelfeedr API.
Start by reading https://funnelfeedr.com/developers/llms.txt: it links every docs page and the OpenAPI spec, and lists the credit rules you must follow before any call that spends credits.

What you can do

Method and path	Cost	What it does
`POST /organizations/match`	Free; details 0.2 credits per organization with `reveal`	Find organizations by Funnelfeedr id, org number, LinkedIn page or domain. The basics are free; can reveal the details (size, revenue, website, description, address and more) in the same call.
`POST /organizations/contacts/match`	Free	The people at each organization who match your account's target contact roles, email and phone masked as in the app.
`POST /organizations/switchboards/match`	Free, or credits if you reveal	Each organization's switchboard — its main phone line rather than a person. Can reveal its number and email in the same call.
`POST /people/match`	Free, or credits if you reveal	Find a person by LinkedIn URL, email, or name + organization. Can reveal in the same call.
`POST /contacts/reveal`	Credits	Reveal email and phone for contacts you already have ids for.
`GET /credits`	Free	The account's credit balance.

Every path above is relative to the base URL. The API reference has every field and an example for every outcome.

How it works

One key per integration, owned by the account. An admin creates keys in Funnelfeedr under Settings → API keys. A key keeps working when the person who made it leaves, and it can call every endpoint, spending ones included. See Authentication.
Batches, not single calls. Every lookup and reveal takes an array of 1–25 items and answers each one separately, in order. See Batching.
Only reveals cost credits. Matching, contacts, switchboards and the balance are free. A reveal — an organization's details, a contact's email and phone, a switchboard's number or email — is quoted exactly with dryRun, capped with maxCredits, and charged all-or-nothing. See Credits & reveal.
Predictable errors. Every error is application/problem+json with a stable code and a retryable flag. See Errors.

Getting access

API access is switched on per account. Ask for access from Settings → API keys in the app, or email support@funnelfeedr.com. Then follow the Quickstart.

Built for AI agents

These docs are written to be read by agents as well as people:

/developers/llms.txt indexes every page, with the credit-safety rules agents must follow; /developers/llms-full.txt is all of it in one file.
Every page has a markdown version: add .md to its URL, or request it with Accept: text/markdown.
The OpenAPI spec uses verb_noun operationIds such as match_people, so they work as tool names.
Agent guidance lists the rules for an agent that spends a customer's credits, and the Quickstart has a block to paste into the prompt you give your agent.