Skip to content
ProspectAPIs

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.

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

bash
curl https://api.prospectapis.com/v1/account \
  -H "Authorization: Bearer $PROSPECTAPIS_KEY"
JavaScript (fetch)
const res = await fetch("https://api.prospectapis.com/v1/account", {
  headers: { Authorization: `Bearer ${process.env.PROSPECTAPIS_KEY}` },
});
console.log(await res.json());
Python (requests)
import os, requests

res = requests.get(
    "https://api.prospectapis.com/v1/account",
    headers={"Authorization": f"Bearer {os.environ['PROSPECTAPIS_KEY']}"},
)
print(res.json())
200 OK
{
  "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.

bash
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"
JavaScript (fetch)
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);
Python (requests)
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:

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

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

bash
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"}'
202 Accepted
{ "research_id": "7f3c2a90-...", "status": "queued", "estimated_seconds": 60 }

Poll every 10 to 15 seconds until the status is completed or failed. Polling is free.

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

header
Authorization: Bearer $PROSPECTAPIS_KEY

Endpoints

MethodPathCost
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/:idfree, owner only
POST/v1/email/verify$0.003 per valid or invalid result; catch-all and unknown are free
GET/v1/email/verify/statsfree
POST/v1/email/outcomesfree
POST/v1/email/verify/jobsfree to create; $0.003 per definite result as it is checked
GET/v1/email/verify/jobs/:idfree
GET/v1/email/verify/jobs/:id/resultsfree
POST/v1/email/outcomesfree; 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/contactsLaunching soon
GET/v1/email/domain/:domainfree, 300 an hour per account
GET/v1/email/verify/calibrationfree
POST/v1/email/clean$0.001 per address (quick checks, up to 1,000 a call)
POST/v1/email/verify/jobs/:id/stopfree
POST/v1/watchlistsfree; $0.009 per delivered record
GET/v1/watchlistsfree
GET/v1/watchlists/:idfree
DELETE/v1/watchlists/:idfree
POST/v1/watchlists/:id/testfree, 5 a minute per account
POST/v1/watchlists/:id/resumefree
GET/v1/watchlists/:id/deliveriesfree
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/resharersNot available yet
GET/v1/pages/followers$0.0012 per live read
GET/v1/pages/followers/enrichedLaunching soon
GET/v1/people/profile/liteNot available yet
GET/v1/pages/profile$0.0012 per live read; a page that cannot be read is free
GET/v1/posts/detailNot available yet
POST/v1/pages/search$0.0012 per live read, up to 1,000 results a query
POST/v1/posts/searchNot available yet
GET/v1/pages/employeesNot available yet
POST/v1/leads/searchNot available yet
POST/v1/leads/companies/searchNot 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/launchesNot available yet
GET/v1/launches/:idNot available yet
POST/v1/accounts/sessionfree; connect your own account with its session string, 10 attempts a minute
POST/v1/accounts/loginfree; connect by signing in, with a code or a check when the account asks
GET/v1/accounts/sessionfree; what is connected, never the session
DELETE/v1/accounts/sessionfree; disconnect and delete the stored session
GET/v1/accountsfree; every account connected to this key, up to 50, each with its account_id
POST/v1/accountsfree; connect another account (a session or a sign-in) and get its account_id
GET/v1/accounts/:account_idfree; one connected account, never its session
DELETE/v1/accounts/:account_idfree; remove one account, its session and its queued writes
POST/v1/accounts/:account_id/reconnectfree; connect the same account again, same account_id
POST/v1/accounts/:account_id/checkpointfree; finish a sign-in that asked for a code or a check
GET/v1/companies/:domain/jobsLaunching soon
GET/v1/companies/:domain/technologiesLaunching soon
POST/v1/accounts/connect-linkfree; a single-use link where your end user connects their own account, with signed account events
DELETE/v1/accounts/connect-link/:link_idfree; 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/eventsLaunching soon
GET/v1/events/citiesLaunching soon
GET/v1/events/:idLaunching soon
POST/v1/events/enrichLaunching soon
POST/v1/messages$0.005 per action
POST/v1/people/invite$0.005 per action
POST/v1/people/invite/withdrawNot available yet
POST/v1/people/follow$0.005 per action
POST/v1/people/visit$0.005 per action
POST/v1/postsNot available yet
POST/v1/posts/react$0.005 per action
POST/v1/posts/commentNot available yet
POST/v1/posts/repost$0.005 per action
POST/v1/posts/quoteNot available yet
POST/v1/invitations/acceptNot available yet
POST/v1/invitations/declineNot available yet
POST/v1/connections/removeNot available yet
POST/v1/posts/editNot available yet
POST/v1/posts/deleteNot available yet
POST/v1/posts/comment/deleteNot available yet
POST/v1/people/endorseNot available yet
POST/v1/chatsNot available yet
POST/v1/messages/reactNot available yet
POST/v1/messages/read$0.005 per action
GET/v1/writes/queuedfree; the writes waiting for your account to reconnect
DELETE/v1/writes/queued/:idfree; 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/skillsLaunching soon
GET/v1/insights/profile-viewsLaunching soon
GET/v1/insights/ssiLaunching soon
GET/v1/insights/postsLaunching soon
GET/v1/messages/inmail-creditsfree; your connected account's remaining credits for messages outside its network
GET/v1/accountfree
POST/v1/feedbackfree, 10 an hour
GET/v1/feedbackfree
GET/v1/feedback/:idfree
GET/v1/versionfree, 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.

StatusMeaning
400Bad 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.
401Missing or invalid API key. Send Authorization: Bearer pa_live_...
402Not enough credits for this call. The body carries top_up_url; nothing was charged.
403The connected account cannot do this: it does not administer the page (not_page_admin) or needs attention first (account_restricted). Never charged.
404No 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.
405HEAD on a /v1 data route. Use GET.
409Creating 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).
413A request body over 100 kB (3 MB on POST /v1/email/verify/jobs, for lists up to 50,000 addresses).
422The connected account is signed out (session_logged_out). Connect it again, then retry.
429Rate 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.
500An unexpected server error. The body says only Internal server error; the hold is refunded.
502Feedback only: the report could not be delivered. Retry shortly.
503A 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.
504The request ran past its deadline (45 seconds by default). Not charged.
402 Payment Required
{
  "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.

HeaderMeaning
X-API-VersionThe API version that served the request.
X-Credits-RemainingCredit balance in dollars after this call.
X-Free-Records-RemainingKept 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.

JavaScript: new seed rounds to Slack
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.

Python: last month's rounds to CSV
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.

JavaScript: a research brief for one company
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.

bash
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"}'
202 Accepted
{ "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.

bash
curl https://api.prospectapis.com/v1/feedback/3f6c1d2e-8b4a-4f7e-9c21-5a0d7e9b4c13 \
  -H "Authorization: Bearer $PROSPECTAPIS_KEY"
200 OK
{ "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?