# 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.

```text
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.

```text
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](https://funnelfeedr.com/developers/api-reference.md) 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](https://funnelfeedr.com/developers/authentication.md).
- **Batches, not single calls.** Every lookup and reveal takes an array of 1–25 items and answers each one separately, in order. See [Batching](https://funnelfeedr.com/developers/batching.md).
- **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](https://funnelfeedr.com/developers/credits-and-reveal.md).
- **Predictable errors.** Every error is `application/problem+json` with a stable `code` and a `retryable` flag. See [Errors](https://funnelfeedr.com/developers/errors.md).

## Getting access

API access is switched on per account. Ask for access from **Settings → API keys** in the app, or email [support@funnelfeedr.com](mailto:support@funnelfeedr.com). Then follow the [Quickstart](https://funnelfeedr.com/developers/quickstart.md).

## Built for AI agents

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

- [/developers/llms.txt](https://funnelfeedr.com/developers/llms.txt) indexes every page, with the credit-safety rules agents must follow; [/developers/llms-full.txt](https://funnelfeedr.com/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](https://funnelfeedr.com/developers/openapi.json) uses verb_noun `operationId`s such as `match_people`, so they work as tool names.
- [Agent guidance](https://funnelfeedr.com/developers/agent-guidance.md) lists the rules for an agent that spends a customer's credits, and the [Quickstart](https://funnelfeedr.com/developers/quickstart.md#tell-your-agent) has a block to paste into the prompt you give your agent.

> **API or MCP?**
>
> Funnelfeedr also has an [MCP server](https://funnelfeedr.com/support/mcp-overview) for Claude, ChatGPT and other assistants. It signs in as a person with OAuth and sees what that person sees. The API is for systems: it uses an API key, not a login, and API keys do not work with the MCP server.