Docs
Quickstart
Written and maintained by The ProspectAPIs team
ProspectAPIs is a REST API at https://api.prospectapis.com. One key reaches every product: funding signals, email verification and prospect research. Requests and responses are JSON.
Per our API reference, the public API serves 100 endpoints under /v1, and 19 of them never cost a credit.
New to account research? Our guide to sales prospect research covers what to look up before a first message, and researching prospects with an AI agent shows how to automate it; the funding and research APIs below do those lookups for you.
Our target is your first successful call within 10 minutes of signing up: a key, one request, and data back. If it takes longer, tell us where it stalled with the feedback endpoint below.
1. Get a key
Create an account, open API keys and create one. Keys look like pa_live_ followed by 48 hex characters. The full key is shown once, when you create it; we store only a hash. An account can hold up to 25 active keys.
export PROSPECTAPIS_KEY="pa_live_..."2. Check the account
GET /v1/account is free. It returns your credit balance and the current prices. A new account starts with a free $1 balance.
curl https://api.prospectapis.com/v1/account \
-H "Authorization: Bearer $PROSPECTAPIS_KEY"const res = await fetch("https://api.prospectapis.com/v1/account", {
headers: { Authorization: `Bearer ${process.env.PROSPECTAPIS_KEY}` },
});
console.log(await res.json());import os, requests
res = requests.get(
"https://api.prospectapis.com/v1/account",
headers={"Authorization": f"Bearer {os.environ['PROSPECTAPIS_KEY']}"},
)
print(res.json()){
"credits_remaining": 1,
"signup_credit_usd": 1,
"free_records_remaining": 0,
"price_per_record_usd": 0.009,
"price_per_verification_usd": 0.003,
"research_price_usd": 0.15
}3. Search funding rounds
Newest announcement first, 25 records a page by default. You pay $0.009 per record returned, from your balance, and a search that matches nothing is free. Every filter.
curl -G https://api.prospectapis.com/v1/funding \
-H "Authorization: Bearer $PROSPECTAPIS_KEY" \
--data-urlencode "round=seed,series_a" \
--data-urlencode "since=2026-09-01" \
--data-urlencode "limit=10"const q = new URLSearchParams({ round: "seed,series_a", since: "2026-09-01", limit: "10" });
const res = await fetch(`https://api.prospectapis.com/v1/funding?${q}`, {
headers: { Authorization: `Bearer ${process.env.PROSPECTAPIS_KEY}` },
});
const { data } = await res.json();
console.log(data);import os, requests
res = requests.get(
"https://api.prospectapis.com/v1/funding",
headers={"Authorization": f"Bearer {os.environ['PROSPECTAPIS_KEY']}"},
params={"round": "seed,series_a", "since": "2026-09-01", "limit": 10},
)
data = res.json()["data"]
print(data)Read one record by its id:
curl https://api.prospectapis.com/v1/funding/$FUNDING_ID \
-H "Authorization: Bearer $PROSPECTAPIS_KEY"4. Get new rounds pushed to you
A watchlist saves funding filters and an https webhook. Each new matching round is POSTed to it, signed, and costs $0.009 only when your webhook answers 2xx. Signatures, retries and limits.
curl -X POST https://api.prospectapis.com/v1/watchlists \
-H "Authorization: Bearer $PROSPECTAPIS_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Seed rounds in Germany",
"filters": {"round": "seed", "country": "Germany"},
"webhook_url": "https://hooks.example.com/funding"}'The response that creates the watchlist includes a whsec_ signing secret, shown once. Store it with your webhook and use it to check the signature on every delivery.
5. Research a prospect
A research brief is paid from your credit balance ($0.15 each); the free $1 balance a new account starts with pays for the first ones. When the balance runs out the call answers 402, so add credits on Billing before a large run. Submit one identifier and, optionally, your own product as context. The API answers 202 with a research_id at once; the brief takes 20 to 90 seconds. The full contract.
curl -X POST https://api.prospectapis.com/v1/research \
-H "Authorization: Bearer $PROSPECTAPIS_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "acme.com", "purpose": "outreach",
"context": "We sell route planning software for 3PLs"}'{ "research_id": "7f3c2a90-...", "status": "queued", "estimated_seconds": 60 }Poll every 10 to 15 seconds until the status is completed or failed. Polling is free.
curl https://api.prospectapis.com/v1/research/$RESEARCH_ID \
-H "Authorization: Bearer $PROSPECTAPIS_KEY"Authentication
Send the key in the Authorization header as a Bearer token on every /v1 request except GET /v1/version. Keep keys on the server or in your agent's environment; never ship one in a browser bundle. Revoke a leaked key from the dashboard and it stops working at once. The key format, the keyless routes and the 401 bodies are on authentication.
Authorization: Bearer $PROSPECTAPIS_KEYEndpoints
| Method | Path | Cost |
|---|---|---|
| GET | /v1/funding | $0.009 per record returned, a search with no match is free |
| GET | /v1/funding/:id | $0.009 when found, free on 404 |
| POST | /v1/research | $0.15 per completed brief, refunded on failure |
| GET | /v1/research/:id | free, owner only |
| POST | /v1/email/verify | $0.003 per valid or invalid result; catch-all and unknown are free |
| GET | /v1/email/verify/stats | free |
| POST | /v1/email/outcomes | free |
| POST | /v1/email/verify/jobs | free to create; $0.003 per definite result as it is checked |
| GET | /v1/email/verify/jobs/:id | free |
| GET | /v1/email/verify/jobs/:id/results | free |
| POST | /v1/email/outcomes | free; a charged valid you report bounced within 30 days is credited back |
| POST | /v1/email/find | $0.009 per found address; nothing found or catch-all is free |
| POST | /v1/website/contacts | Launching soon |
| GET | /v1/email/domain/:domain | free, 300 an hour per account |
| GET | /v1/email/verify/calibration | free |
| POST | /v1/email/clean | $0.001 per address (quick checks, up to 1,000 a call) |
| POST | /v1/email/verify/jobs/:id/stop | free |
| POST | /v1/watchlists | free; $0.009 per delivered record |
| GET | /v1/watchlists | free |
| GET | /v1/watchlists/:id | free |
| DELETE | /v1/watchlists/:id | free |
| POST | /v1/watchlists/:id/test | free, 5 a minute per account |
| POST | /v1/watchlists/:id/resume | free |
| GET | /v1/watchlists/:id/deliveries | free |
| GET | /v1/people/profile | $0.0012 per live read; a profile that cannot be read is free |
| POST | /v1/people/search | $0.0012 per live read, up to 1,000 results a query |
| GET | /v1/people/posts | $0.0012 per live read |
| GET | /v1/posts/engagers | $0.0012 per live read |
| GET | /v1/posts/resharers | Not available yet |
| GET | /v1/pages/followers | $0.0012 per live read |
| GET | /v1/pages/followers/enriched | Launching soon |
| GET | /v1/people/profile/lite | Not available yet |
| GET | /v1/pages/profile | $0.0012 per live read; a page that cannot be read is free |
| GET | /v1/posts/detail | Not available yet |
| POST | /v1/pages/search | $0.0012 per live read, up to 1,000 results a query |
| POST | /v1/posts/search | Not available yet |
| GET | /v1/pages/employees | Not available yet |
| POST | /v1/leads/search | Not available yet |
| POST | /v1/leads/companies/search | Not available yet |
| GET | /v1/companies/:domain | $0.02 per company returned, by domain or exact name; 202 building, 300 several matches and 404 unknown are free |
| GET | /v1/companies/:domain/funding | $0.009 per record returned, a company with no rounds is free |
| GET | /v1/launches | Not available yet |
| GET | /v1/launches/:id | Not available yet |
| POST | /v1/accounts/session | free; connect your own account with its session string, 10 attempts a minute |
| POST | /v1/accounts/login | free; connect by signing in, with a code or a check when the account asks |
| GET | /v1/accounts/session | free; what is connected, never the session |
| DELETE | /v1/accounts/session | free; disconnect and delete the stored session |
| GET | /v1/accounts | free; every account connected to this key, up to 50, each with its account_id |
| POST | /v1/accounts | free; connect another account (a session or a sign-in) and get its account_id |
| GET | /v1/accounts/:account_id | free; one connected account, never its session |
| DELETE | /v1/accounts/:account_id | free; remove one account, its session and its queued writes |
| POST | /v1/accounts/:account_id/reconnect | free; connect the same account again, same account_id |
| POST | /v1/accounts/:account_id/checkpoint | free; finish a sign-in that asked for a code or a check |
| GET | /v1/companies/:domain/jobs | Launching soon |
| GET | /v1/companies/:domain/technologies | Launching soon |
| POST | /v1/accounts/connect-link | free; a single-use link where your end user connects their own account, with signed account events |
| DELETE | /v1/accounts/connect-link/:link_id | free; revoke a connect link before it is used |
| GET | /v1/ads | $0.006 per library that returns ads (status ok); no ads, not found, not covered and unreadable are free |
| GET | /v1/ads/:id | $0.006 when found; an unknown id is free |
| GET | /v1/events | Launching soon |
| GET | /v1/events/cities | Launching soon |
| GET | /v1/events/:id | Launching soon |
| POST | /v1/events/enrich | Launching soon |
| POST | /v1/messages | $0.005 per action |
| POST | /v1/people/invite | $0.005 per action |
| POST | /v1/people/invite/withdraw | Not available yet |
| POST | /v1/people/follow | $0.005 per action |
| POST | /v1/people/visit | $0.005 per action |
| POST | /v1/posts | Not available yet |
| POST | /v1/posts/react | $0.005 per action |
| POST | /v1/posts/comment | Not available yet |
| POST | /v1/posts/repost | $0.005 per action |
| POST | /v1/posts/quote | Not available yet |
| POST | /v1/invitations/accept | Not available yet |
| POST | /v1/invitations/decline | Not available yet |
| POST | /v1/connections/remove | Not available yet |
| POST | /v1/posts/edit | Not available yet |
| POST | /v1/posts/delete | Not available yet |
| POST | /v1/posts/comment/delete | Not available yet |
| POST | /v1/people/endorse | Not available yet |
| POST | /v1/chats | Not available yet |
| POST | /v1/messages/react | Not available yet |
| POST | /v1/messages/read | $0.005 per action |
| GET | /v1/writes/queued | free; the writes waiting for your account to reconnect |
| DELETE | /v1/writes/queued/:id | free; cancel a queued write |
| GET | /v1/messages | $0.0012 per read |
| GET | /v1/messages/thread | $0.0012 per read |
| GET | /v1/connections | $0.0012 per read |
| GET | /v1/invitations/received | $0.0012 per read |
| GET | /v1/invitations/sent | $0.0012 per read |
| GET | /v1/people/skills | Launching soon |
| GET | /v1/insights/profile-views | Launching soon |
| GET | /v1/insights/ssi | Launching soon |
| GET | /v1/insights/posts | Launching soon |
| GET | /v1/messages/inmail-credits | free; your connected account's remaining credits for messages outside its network |
| GET | /v1/account | free |
| POST | /v1/feedback | free, 10 an hour |
| GET | /v1/feedback | free |
| GET | /v1/feedback/:id | free |
| GET | /v1/version | free, no key |
Two more answer at the API root, free and without a key. GET /pricing returns the live price list (funding records, research, watchlist deliveries) that this site renders its prices from. GET /health is the liveness check for uptime monitors; it answers "status": "ok" while the API is serving. Each endpoint has its own page, with parameters, response fields and samples, in the API reference.
Errors
Every error is JSON with an error string, and sometimes a code, field or message. Unknown parameters are refused rather than ignored, so a typo never silently widens a search you pay for. The error codes and which errors to retry are on errors.
| Status | Meaning |
|---|---|
| 400 | Bad input: an unknown query parameter or body field, a malformed id or date, a body that is not valid JSON, or more than one research identifier. The body names the problem. |
| 401 | Missing or invalid API key. Send Authorization: Bearer pa_live_... |
| 402 | Not enough credits for this call. The body carries top_up_url; nothing was charged. |
| 403 | The connected account cannot do this: it does not administer the page (not_page_admin) or needs attention first (account_restricted). Never charged. |
| 404 | No record, research job or watchlist with that id, a job or watchlist that belongs to another account, nothing found for a people read, a person who asked to be removed (person_removed), or no such route. Never charged. |
| 405 | HEAD on a /v1 data route. Use GET. |
| 409 | Creating a watchlist when the account already has the most active watchlists allowed, or a call that acts on your connected account before one is connected (account_not_connected). |
| 413 | A request body over 100 kB (3 MB on POST /v1/email/verify/jobs, for lists up to 50,000 addresses). |
| 422 | The connected account is signed out (session_logged_out). Connect it again, then retry. |
| 429 | Rate limit reached (the per-key requests-a-minute limit). Wait for the time in Retry-After, then retry; do not retry in a tight loop. |
| 500 | An unexpected server error. The body says only Internal server error; the hold is refunded. |
| 502 | Feedback only: the report could not be delivered. Retry shortly. |
| 503 | A dependency is unavailable (authentication, or a route that is not launched yet, such as an endpoint that is not on sale yet). The code is temporarily_unavailable. Nothing was charged; retry later. |
| 504 | The request ran past its deadline (45 seconds by default). Not charged. |
{
"error": "Insufficient credits",
"top_up_url": "https://prospectapis.com/dashboard/billing",
"message": "Out of credits. Top up at https://prospectapis.com/dashboard/billing to continue."
}Rate limits
/v1 allows 60 requests a minute per API key by default. POST /v1/feedback also allows 10 delivered reports an hour per account. Responses carry the standard RateLimit headers; on a 429, wait for the window to reset. The full table, the headers and a backoff sample are on rate limits.
Billing headers
Every response carries X-API-Version. Metered responses also carry your balance after the call, so a client can track spend without a second request.
| Header | Meaning |
|---|---|
| X-API-Version | The API version that served the request. |
| X-Credits-Remaining | Credit balance in dollars after this call. |
| X-Free-Records-Remaining | Kept for older clients and always 0: the monthly free records ended on 2026-10-25. |
Billing reserves before it serves. A request holds the records it may return, the page is capped to that hold, and anything unserved is refunded when the response closes. A non-2xx response refunds the whole hold, and a request past its deadline is not charged.
Sample apps
Three small programs you can run as they are once PROSPECTAPIS_KEY is set. Each one is complete: save the JavaScript ones as .mjs files (they use top-level await) and run them with Node 18 or later, and the Python one with Python 3 and requests.
New seed rounds to Slack. Posts yesterday's seed and pre-seed rounds to a Slack incoming webhook. Run it once a day from cron. For a push instead of a poll, use a watchlist.
const since = new Date(Date.now() - 86400000).toISOString().slice(0, 10);
const q = new URLSearchParams({ round: "pre_seed,seed", since, until: since, limit: "100" });
const res = await fetch(`https://api.prospectapis.com/v1/funding?${q}`, {
headers: { Authorization: `Bearer ${process.env.PROSPECTAPIS_KEY}` },
});
if (!res.ok) throw new Error(`${res.status}: ${(await res.json().catch(() => ({}))).error ?? res.statusText}`);
const { data } = await res.json();
const lines = data.map((r) => `${r.company_name} raised ${r.round_label ?? r.round_stage}${r.amount_usd ? ` ($${(r.amount_usd / 1e6).toFixed(1)}M)` : ""}: ${r.source_url}`);
await fetch(process.env.SLACK_WEBHOOK_URL, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ text: lines.length ? lines.join("\n") : "No new seed rounds yesterday." }),
});Last month's rounds to CSV. Pages through every Series A from the last 30 days with the cursor and writes a spreadsheet-ready file.
import csv, datetime, os, requests
since = (datetime.date.today() - datetime.timedelta(days=30)).isoformat()
headers = {"Authorization": f"Bearer {os.environ['PROSPECTAPIS_KEY']}"}
params = {"round": "series_a", "since": since, "limit": 100}
rows = []
MAX_PAGES = 10 # up to 1,000 rounds; raise it on purpose, each record is billed
for _ in range(MAX_PAGES):
res = requests.get("https://api.prospectapis.com/v1/funding", headers=headers, params=params)
if res.status_code == 402:
print(f"out of credits, saved {len(rows)} rows")
break
res.raise_for_status()
page = res.json()
rows += page["data"]
if not page.get("next_cursor"):
break
params["cursor"] = page["next_cursor"]
with open("series_a.csv", "w", newline="") as f:
w = csv.writer(f)
w.writerow(["company", "domain", "amount_usd", "announced_at", "investors", "source"])
for r in rows:
w.writerow([r["company_name"], r["company_domain"], r["amount_usd"], r["announced_at"],
"; ".join(r.get("investors") or []), r["source_url"]])
print(f"wrote {len(rows)} rounds to series_a.csv")A research brief for a company that just raised. Submits a brief for one domain and polls until it is ready. A brief is charged only when it completes.
const auth = { Authorization: `Bearer ${process.env.PROSPECTAPIS_KEY}`, "Content-Type": "application/json" };
const domain = process.argv[2] ?? "example.com";
const submit = await fetch("https://api.prospectapis.com/v1/research", {
method: "POST",
headers: auth,
body: JSON.stringify({ domain, purpose: "outreach", context: "They just raised a round; we sell to newly funded teams." }),
});
if (!submit.ok) throw new Error(`${submit.status}: ${(await submit.json().catch(() => ({}))).error ?? submit.statusText}`);
const { research_id } = await submit.json();
for (;;) {
await new Promise((r) => setTimeout(r, 10000));
const poll = await fetch(`https://api.prospectapis.com/v1/research/${research_id}`, { headers: auth });
if (!poll.ok) throw new Error(`${poll.status}: ${(await poll.json().catch(() => ({}))).error ?? poll.statusText}`);
const job = await poll.json();
if (job.status === "completed") { console.log(JSON.stringify(job.result, null, 2)); break; }
if (job.status === "failed") throw new Error(JSON.stringify(job.error ?? "research failed"));
}Feedback
Found a wrong field or a missing capability? Send it from your code or agent. It is free and goes straight to the team. kind is bug (default), feature or question; never put secrets or keys in details.
curl -X POST https://api.prospectapis.com/v1/feedback \
-H "Authorization: Bearer $PROSPECTAPIS_KEY" \
-H "Content-Type: application/json" \
-d '{"kind": "bug", "title": "country filter ignores accents",
"details": "GET /v1/funding?country=Curaçao returned 0; expected 2"}'{ "feedback_id": "...", "status": "sent" }The report is stored before the team is alerted, so it is never lost: status is stored when the alert failed and the team picks it up in triage instead. Read your reports back, with what the team did about them, from any key on the account. GET /v1/feedback lists them newest first (limit 1 to 100, default 25, and cursor from the last page's next_cursor); GET /v1/feedback/:id reads one. Each carries status (received, triaged, fixed, wont_fix or needs_info), the team's response and responded_at. Both are free, and an id from another account answers 404.
curl https://api.prospectapis.com/v1/feedback/3f6c1d2e-8b4a-4f7e-9c21-5a0d7e9b4c13 \
-H "Authorization: Bearer $PROSPECTAPIS_KEY"{ "id": "3f6c1d2e-8b4a-4f7e-9c21-5a0d7e9b4c13", "kind": "bug", "tool": null,
"title": "country filter ignores accents", "details": "...",
"status": "fixed", "response": "Fixed: accents now match.",
"responded_at": "2026-11-02T09:30:00Z", "created_at": "2026-11-01T18:04:11Z",
"updated_at": "2026-11-02T09:30:00Z", "from_this_key": true }Every change to the API and the MCP server is dated on the changelog, and the about page explains where the funding data comes from and how each record keeps its source.
Was this page helpful?