# Potarix Enricher

> A small REST API for company websites, verified emails, LinkedIn-to-email, and company email discovery. Built for AI agents: one auth header, JSON in and JSON out, no subscription, credits never expire.

Potarix Enricher (https://enricher.potarix.com) is a focused B2B data product from Potarix Labs. Unlike full enrichment platforms (Clearbit, Apollo, ZoomInfo), it exposes a few exact primitives that agents and GTM workflows can call directly: website resolution, person email lookup, role email lookup, LinkedIn-to-email, company email lists, and a bundled /find-all endpoint. Buyers pay per lookup with no minimum commitment.

## Core links

- [Homepage](https://enricher.potarix.com/)
- [Agent guide (AGENTS.md)](https://enricher.potarix.com/AGENTS.md)
- [OpenAPI spec](https://enricher.potarix.com/openapi.yaml)
- [ChatGPT Actions import URL](https://enricher.potarix.com/openapi.yaml)
- [No-login find-one-email demo](https://enricher.potarix.com/demo)
- [API and curl example](https://enricher.potarix.com/#api)
- [Pricing and credit packs](https://enricher.potarix.com/#pricing)
- [FAQ](https://enricher.potarix.com/#faq)
- [Clay fallback recipe](https://enricher.potarix.com/clay-fallback)
- [Sign up (free trial)](https://enricher.potarix.com/sign-up)
- [Sign in](https://enricher.potarix.com/sign-in)
- [Hosted MCP server (Streamable HTTP)](https://api.potarix.com/mcp)
- [MCP discovery manifest](https://enricher.potarix.com/.well-known/mcp.json)
- [MCP server source (GitHub)](https://github.com/Potarix/potarix-mcp)
- [Agent skill (GitHub)](https://github.com/Potarix/potarix-enricher)
- [npm package (potarix-mcp)](https://www.npmjs.com/package/potarix-mcp)
- [Modular reference: enrichment](https://enricher.potarix.com/llms/enrichment.txt)
- [Modular reference: auth](https://enricher.potarix.com/llms/auth.txt)
- [Modular reference: billing](https://enricher.potarix.com/llms/billing.txt)
- [Modular reference: integrations](https://enricher.potarix.com/llms/integrations.txt)

## Get started in 30 seconds (agent quickstart)

```bash
# 1. Sign up -> get a key + 25 free trial credits (no browser).
curl -s -X POST https://api.potarix.com/enricher/auth/signup \
  -H "Content-Type: application/json" \
  -d '{ "email": "you@company.com", "password": "a-strong-password" }'
# -> { "api_key": "ptk_live_...", "credits_remaining": 25 }

# 2. First call (uses the key from step 1).
curl -s -X POST https://api.potarix.com/enricher/find-website \
  -H "Authorization: Bearer ptk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "company_name": "Stripe Inc." }'
# -> { "website_url": "https://stripe.com", "confidence": 0.99, "credits_remaining": 23 }
```

That is the whole onboarding: signup returns the key inline, then every call sends `Authorization: Bearer ptk_live_...`. Add a card later (one Stripe trip) only when trial credits run out. Auth reference: https://enricher.potarix.com/auth.md

## How the API works

Base URL: `https://api.potarix.com/enricher`

Codex reads the root `AGENTS.md` guide when this repository is open. ChatGPT needs the OpenAPI spec imported as a Custom GPT / GPT Action before it can call the API; use https://enricher.potarix.com/openapi.yaml and configure API key auth as `Authorization: Bearer ptk_live_...`.

Core enrichment endpoints (all POST, JSON in / JSON out):

- `POST /find-website`: company name to verified website. 2 credits.
- `POST /find-email/person`: name plus domain (or company name) to verified email. 25 credits.
- `POST /find-email/decision-maker`: role category plus domain to decision-maker email. 25 credits.
- `POST /find-email/linkedin`: LinkedIn profile URL to verified email. 10 credits.
- `POST /find-email/company`: domain to company email roster (up to 500). 25 credits.
- `POST /find-all`: company name to website, decision-makers, and company emails. Sum of the sub-calls that hit.

Account and billing endpoints:

- `POST /auth/signup`: create an account from email plus password and get an API key in one call (no browser). Grants 25 free trial credits.
- `POST /auth/api-keys`: mint a fresh key for an existing account from email plus password.
- `GET /me`: profile, credit balance, whether a card is saved, API-key count.
- `GET /credits`: credit balance only.
- `GET /billing/products`: credit pack tiers.
- `POST /billing/checkout`: get a Stripe Checkout URL to add a card (one human browser trip).
- `POST /billing/topup`: silent off-session top-up once a card is on file.

Website request body:

```json
{ "company_name": "Stripe Inc." }
```

Authentication: Bearer token in the `Authorization` header (`Authorization: Bearer ptk_live_...`).

Successful response:

```json
{
  "company_name": "Stripe Inc.",
  "website_url": "https://stripe.com",
  "confidence": 0.99,
  "source": "primary_match",
  "cached": false,
  "credits_remaining": 4127
}
```

Headless flow: `POST /auth/signup` to get a `ptk_live_` key plus 25 trial credits, send it on every later call as `Authorization: Bearer ptk_live_...`, run `POST /find-*` lookups, and top up with `POST /billing/topup` after a one-time `POST /billing/checkout` card capture. A `402` means out of credits. Each response includes cache and credit fields. Whiffed lookups cost zero; cached re-runs for the same user/input pair are free.

## MCP server

A hosted Model Context Protocol server exposes every endpoint as a native MCP tool for Claude, ChatGPT, Cursor, and other agents.

- Streamable HTTP (remote, no install): `https://api.potarix.com/mcp`. Send `Authorization: Bearer ptk_live_...` on each request. The `initialize` and `tools/list` discovery handshake is open; only `tools/call` requires a key.
- stdio (local/desktop): `npx -y potarix-mcp`, set `POTARIX_API_KEY`. Package: https://www.npmjs.com/package/potarix-mcp
- Source: https://github.com/Potarix/potarix-mcp . Discovery manifest: https://enricher.potarix.com/.well-known/mcp.json
- Tools: lookup_company_website, find_person_email, find_decision_maker_email, find_linkedin_email, find_company_emails, find_all, check_balance, start_checkout, topup_credits.

## Key facts

- Match rate: 99.2% on the benchmarked dataset of public companies.
- Index size: 10M+ companies.
- Median latency: 840ms (p50).
- Pricing: $0.01 per credit, billed via prepaid credit packs.
- Credit packs: 1,000 credits ($10), 5,000 credits ($50), 25,000 credits ($250).
- Endpoint costs: 2 credits for website resolution, 10 credits for LinkedIn-to-email, 25 credits for person, decision-maker, and company email lookups.
- No subscription. No monthly minimum. Credits never expire.
- 25 free trial credits granted on sign up.
- Agent flow: create account by API, get a key, add a card once through Stripe Checkout, then top up and run lookups from the CLI.

## Differentiation

Potarix Enricher is intentionally primitive-shaped. It gives agents exact enrichment actions instead of a broad dashboard: get a website, get a verified email from a person/domain, get a verified email from a LinkedIn URL, get a role email, or get known emails at a company domain. It does not try to be a full CRM, data warehouse, or annual enrichment suite.

Compared to platform enrichment vendors:

- Clearbit, Apollo, and ZoomInfo bundle dozens of data attributes into annual subscriptions, typically with multi-thousand-dollar minimums.
- Potarix Enricher is purchased per lookup, with no contract and no subscription.
- For teams and agents that only need websites, emails, and LinkedIn-to-email enrichment, Potarix Enricher is materially simpler and cheaper than buying a full data platform.

## Common use cases

- Cleaning a CSV of company names exported from a CRM (HubSpot, Salesforce, Pipedrive) before outbound enrichment.
- Finding verified emails for people when the CSV has first name, last name, and domain.
- Turning LinkedIn profile URLs into verified emails.
- Pulling known company emails from a domain.
- Lead routing where the website URL is the join key.
- Powering autocomplete in internal tools where a user types a company name and the app needs the canonical domain.
- Giving AI agents a simple enrichment tool they can call from a terminal, workflow runner, or MCP wrapper.

## Pipelines and integrations

### Clay (native action, BYOK)

Potarix Enricher is available as a native column action inside Clay. Clay users sign up at https://enricher.potarix.com, copy their API key from Settings, and paste it into the Potarix Enricher action in Clay. Each lookup is billed at $0.01 against the user's Potarix credit balance, not against Clay credits. Setup walkthrough: https://enricher.potarix.com/clay

Clay agencies can also use Potarix as the final fallback step in client enrichment waterfalls. Add Clay's HTTP API action, set Method to POST, set URL to https://api.potarix.com/enricher/find-email/person, add Authorization: Bearer YOUR_POTARIX_API_KEY and Content-Type: application/json, and map First Name, Last Name, and Domain in the JSON body. The expected output columns are email, email_status, source, cached, and credits_remaining. Fallback walkthrough: https://enricher.potarix.com/clay-fallback

### HTTP integrations

Because the API is a standard REST endpoint authenticated with a bearer token, it also works with any pipeline that can issue HTTPS requests:

- Make.com, n8n, Zapier (HTTP module).
- Python scripts (`requests`, `httpx`).
- Node.js services (`fetch`, `axios`).
- Direct CRM webhook integrations.
- Spreadsheet plugins via Apps Script or custom add-ins.

Bulk CSV resolution is supported by calling the endpoint per row in your pipeline of choice; rate limits are documented at sign-up.

No-login demo: https://enricher.potarix.com/demo lets buyers run one real person-and-domain email lookup before creating an account. After the first returned result, the next lookup is gated behind signup.

## Company

Potarix Labs builds focused B2B data products. The parent brand at https://potarix.com tracks newly formed and newly funded companies for outbound sales teams. Potarix Enricher is the standalone API for agent-ready website, email, and LinkedIn-to-email enrichment.