ProspectAPIs

Connect ANOTHER of your own accounts to this key, alongside the ones already connected, and get its account_id. Send either `session` (a signed-in session string) or `identifier` and `password` (a sign-in). When the sign-in asks for a code or a check, the answer carries account_id and challenge_id: finish it with account_checkpoint. Refused with account_already_connected (and that account's account_id) when the same account is already here. Free. Session strings and passwords are credentials: pass them only when the user gives them. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Your credit balance and the prices you pay (record, research, email verification). Free. Check it before a large paged search.

Finish a sign-in that asked for a code or a check: send the challenge_id from the earlier answer, the code when one was asked for, and the same identifier and password. Within 15 minutes. Free. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Connect YOUR OWN account with its signed-in session string, so the write tools and page_followers act as you. The session is checked live once, stored encrypted, never returned and deleted on account_disconnect; it replaces any account connected before. Free. A session string is a credential: pass it only when the user gives it. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

A short-lived, single-use link on our site where YOUR end user connects their own account (a sign-in, with any code or check it asks for, or a session string), so you never handle their password. type create (default) connects a new account; type reconnect with account_id reconnects that one and keeps its account_id. Optional: name (your own reference, passed back in the redirect and every event), expires_on (5 minutes to 24 hours, default 1 hour), success_redirect_url and failure_redirect_url (https; status, account_id, name and reason are added to the query), notify_url (https; receives account.connected, account.reconnect_required and account.disconnected for that account, signed with the webhook_secret this answer shows once). Free. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Revoke a hosted connect link before it is used, so it can no longer connect anything. Free.

Disconnect your account: its stored session is deleted. Safe to repeat; works at a zero balance. Free.

One connected account by its account_id: status, handle, name, egress and dates. Never returns a session. Free.

Connect YOUR OWN account by signing in with its email or phone and password. When the account asks for a two-factor code, an emailed code or a check a person must finish, the answer carries a `challenge_id` (and a `handoff_url` for a check): call again with `code` and `challenge_id` within 15 minutes. With `totp_secret` (the authenticator setup key) the two-factor code is typed for you; `remember: true` keeps the details encrypted so a later sign-out is signed back in automatically. Free. A password is a credential: pass it only when the user gives it. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Connect the same account again after it signed out, keeping its account_id: send `session`, or `identifier` and `password`. Free. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Remove one connected account: its stored session, its browser profile and its queued writes are deleted. Other accounts are untouched. Free.

What is connected: `connected`, `status` (active, or dead when it signed out and needs connecting again), the account's handle and name, and its dates. Never returns the session. Free. Check it before a batch of writes.

Every account connected to this API key, oldest first: account_id, status (active, connecting, or dead when it needs connecting again), handle, name, egress and dates. Never returns a session. No cap on accounts per key. Free.

One ad in full by its id from `ads_search`, with the facts its library shows only on the single ad (for example the countries it ran in). Costs $0.006 when found; an unknown id is free, and a library that cannot be read right now answers 503 (free). While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Whether a company runs ads now on the public Meta, Google, LinkedIn and TikTok ad libraries, by its domain. Returns a one-line `summary`, a `platforms` entry per library with its `status` (ok, no_ads, not_resolved, not_covered, unreadable with a `reason`), the advertiser and how it was resolved, and the live ads (text, media, first and last seen, countries, landing URL, status, format). Only `no_ads` means the company runs no ads there; `not_resolved` means the advertiser was not found, so pass its id (google_advertiser_id, meta_page_id, linkedin_company_id or tiktok_advertiser) and ask again. A field the library does not show is null. Costs $0.006 per library whose status is ok, on the first page; everything else is free, and one unreadable library never fails the call. Page with `cursor`. Coverage: Meta worldwide (active ads; inactive ones only when they reached the EU); Google worldwide (the last 30 days); LinkedIn ads run since 2023-06-01, with run dates and reach only for ads shown in the EU; TikTok only ads shown in the EEA, Switzerland and the UK. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

The API's version and deployed build. Free, needs no key.

Start a new conversation from your connected account with one person, or a group of up to 50 (subject is the group's title). Answers the new thread_id for message_thread (null when it could not be read back; find it in messages_list). Optional attachment as on message_send. Costs $0.005 per action. Requires a connected account. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Delete one of your own comments. Costs $0.005 per action. Pass the comment_id from post_engagers (kind=comments). Requires a connected account. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

The funding rounds for one company domain, newest announcement first: the same records as funding_search filtered to this domain. Costs $0.009 per record returned; a company with no rounds is free. Page with `cursor`. Coverage: funding rounds are complete from 2026-10-01, partial from 2026-09-22 to 2026-09-30, and only a few earlier rounds are held, so a company whose last round was before that returns none (an empty answer carries a `coverage` object saying so).

Read one cited company profile. Its one argument, `domain`, takes the company's domain (`acme.com`) or its exact company name (`Acme Robotics`); there is no separate name argument. The profile gives name, description, HQ, founded year, industry, employee band, social links, a funding rollup (the amount raised across the rounds we hold, not lifetime total raised) and a careers link, with a source URL on every field and each marked `stated` (a page states it) or `inferred` (classified from a page); a field no source supports is null, never guessed. Costs $0.02 per company returned, drawn from your balance. A domain not built yet returns 202 `building` (retry in about 30 seconds), and a domain that does not resolve to a company returns 404; both are free. A company name is matched whole against the funding rounds we hold: several companies with that name answer HTTP 300 with each `{name, domain}` to choose from (free, never a guess), and no company with that name is a free 404. The funding rollup counts only rounds in our funding coverage. Coverage: funding rounds are complete from 2026-10-01, partial from 2026-09-22 to 2026-09-30, and only a few earlier rounds are held, so a company whose last round was before that returns none (an empty answer carries a `coverage` object saying so). While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

LAUNCHING SOON: answers 503 until hiring signals go live (GET /pricing hiring_tech.available). A company's open job postings by its domain, read from its own public job board (Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee) or the job postings marked up on its careers page. `status` is ok, no_openings (a board was found and is empty) or no_board_found (no public board was linked from the site; this does not mean the company is not hiring). Each opening has title, department, location, remote, employment type, seniority (inferred from the title), salary when the board states it, posted_at, the posting URL, `source` (the board API read), `ats` ({provider, board_slug}), `fetched_at`, and our own first_seen_at and last_seen_at. A field the board does not state is null. Read live when the stored read is older than `max_age_hours`. Costs $0.006 per lookup whose status is ok, never per posting; every other answer is free, and 503 when the site cannot be read. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

LAUNCHING SOON: answers 503 until hiring signals go live (GET /pricing hiring_tech.available). The technologies a company's website and DNS show it uses, by its domain: analytics, marketing automation, CRM, chat, payments, CMS, framework, hosting and CDN, email and productivity suite, security, ATS and more. Each one has its category, the evidence (the script, header, cookie name, meta generator or DNS record that matched, and the page or record it was seen on), `source`, `fetched_at`, first_seen_at and last_seen_at. `status` is ok or none_detected (no rule matched; not proof the company uses nothing). Read live when the stored read is older than `max_age_hours`. Costs $0.006 per lookup whose status is ok; none_detected and errors are free. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Remove a first-degree connection from your connected account. Costs $0.005 per action. Requires a connected account. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Read your connected account's first-degree connections, newest first, each with name, headline, profile_ref, person_ref and connected_at. Costs $0.0012 per read. Page with `start` or the `cursor` of the previous page. Requires a connected account. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Clean up to 50,000 addresses a call (an input size per request, not a volume cap: send more in further calls or as a background job) with quick checks (no mail server is contacted): returns `keep`, `review` (role, free, parked, new or typo addresses, with a reason) and `remove` (cannot receive mail), plus `counts`. $0.001 per well-formed address. Run email_verify on the kept addresses you will actually send to.

What is known about one email domain without contacting its mail server: `exists`, `accepts_mail`, `null_mx`, `mx` hosts, `mail_provider`, `spf`, `dmarc`, `disposable`, `free_provider`, `parked`, `domain_age_days`, `new_domain`, `did_you_mean`, and `catch_all` (true or false only when our own check measured it recently, else null) with `catch_all_checked_at`. Free, with no hourly lookup limit (only the per-key rate limit applies).

Find a person's work email from `first_name`, `last_name` and company `domain`. The common patterns are checked in order against the mail server, most common first. Returns `status` (found, catch_all, unknown, not_found), `email`, `pattern`, `score`, `recommendation` and the addresses `checked`. Costs $0.009 only when an address is found; on a catch-all domain it returns the most likely address as `best_guess`, free.

Report what happened when you sent: `bounced` or `delivered`, 1 to 100 addresses per call. A bounce you report makes your later email_verify checks of that address come back invalid (reason `reported_bounce`); a delivered report on a catch-all address raises its score. Returns `stored`. Free.

Check whether email addresses can receive mail, up to 50,000 addresses a call (an input size per request, not a volume cap: send more in further calls or as a background job); a call over it is refused with TOO_MANY_EMAILS, free. What our probe pacing cannot check now is queued into a verification job and comes back `queued` with its `job_id`, free here and billed when the job checks it. Each result has `status` (valid, invalid, catch-all or unknown), `reason`, `reason_text`, `score` (0 to 100), `recommendation` (send, send_with_caution, retry_later or do_not_send), `charged`, `flags`, `smtp_code`, `catch_all_tier`, `did_you_mean` (a likely domain typo), `mail_provider` and `checked_at`. Costs $0.003 per valid or invalid result, drawn from your balance; catch-all and unknown results are free (pricing_get lists which statuses are charged). When the balance covers only some addresses, the rest come back `unknown` with reason `not_checked_insufficient_credits`, free (`not_checked_key_cap` when the key's monthly cap stops it). `depth: "quick"` never contacts the mail server: syntax, disposable and free lists, DNS, parked and new-domain flags and a recently measured catch-all verdict, at $0.001 per address whatever the status; an address that needs a mailbox check comes back `unknown` with reason `not_probed`. `depth: "cache"` (or `cache_only: true`) answers only from verdicts already on record from any account (valid within 30 days, invalid within 90): it never contacts the mail server and never counts against the probe budget, a known verdict is billed like a full check, and anything not on record comes back `miss`, free. A `paced` or `provider_cooldown` result carries `retry_after_s`: retry after that many seconds.

What each verification score band has meant in practice: the measured bounce rate per band from delivery outcomes customers reported over the last 90 days. A band with fewer than 30 reports shows a null rate. Free.

Check up to 50,000 addresses in the background. Returns 202 with a job `id`; poll email_verify_job_get. A slow or greylisting server is retried about 5, 15 and 30 minutes later, free. Each valid or invalid result costs $0.003 as it is checked; catch-all and unknown are free. An optional https `callback_url` gets one signed POST when the job completes (verify with the returned `secret`). At most 5 jobs run at once per account.

A job's `status` (queued, running, completed), `total`, `done`, `charged_count` and `amount_usd`. Free.

A job's results in input order, up to 1,000 a page (`limit`), from `cursor`; `next_cursor` is null on the last page. An address not yet checked shows status `pending`. Free.

Turn off a job's monitoring (its regular re-checks); a job still running is cancelled, and what it already checked stays readable. Free.

Your own email verification mix over the last `days` (1 to 90, default 30): `total`, `by_status` (valid, invalid, catch-all, unknown), `charged`, `served_from_cache`, `catch_all_share` and `unknown_share`. Free.

LAUNCHING SOON: answers 503 until event discovery goes live. One Luma or Partiful event's speakers, sponsors, agenda and side events, from its URL or an `events_search` id. Each section has a `status`: ok (items found), not_published (the page publishes none, with a reason) or unreadable (could not tell); an empty list never means none on its own. Items parsed from the description carry `source: description`, the heading they sat under and a `confidence`. Costs $0.005 only when at least one section is ok; everything else is free. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

LAUNCHING SOON: answers 503 until event discovery goes live. One event read fresh from its platform, in the same shape as `events_search`, with Luma's categories and Partiful's hosts by name. Costs $0.0015; an unknown id is a free 404, and a platform that cannot be read with no stored copy is a free 503. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

LAUNCHING SOON: answers 503 until event discovery goes live. Every city `events_search` covers, with its slug, timezone and which platforms (luma, partiful) cover it. Free. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

LAUNCHING SOON: answers 503 until event discovery goes live. Find public events on Luma and Partiful in one city, soonest first, in one record shape for both platforms: title, url, start and end in UTC and in local time with the offset, timezone, city, venue, Luma's own category, the guest count where the host shows it (null when hidden), hosts with their platform ids, the organiser, and ticket price. Read logged out, never with an account. `sources` says per platform whether it was read (`ok`), does not cover the city or filter (`not_covered`, Partiful publishes no category) or could not be read now (`unreadable`). Costs $0.0015 per event returned; an empty page is free. `events_cities` lists the cities. Page with `cursor`. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

One report this account sent, by the feedback_id feedback_send returned: its status (received, triaged, fixed, wont_fix, needs_info), the team's response and responded_at. Free. A report from another account answers 404.

The reports this account sent with feedback_send (from any of its keys), newest first, each with its status (received, triaged, fixed, wont_fix, needs_info), the team's response and responded_at. Free. Use it to check whether a reported bug was fixed before reporting it again. Page with `cursor` from the previous `next_cursor`.

Report a bug, a wrong or empty field, a missing capability or a question about ProspectAPIs to the team. A report is first drafted to a queue (action "draft", the default), which sends nothing; action "list" shows the pending drafts with their ids; action "send" posts only the drafts named in `ids` to POST /v1/feedback and returns a feedback_id per report; action "discard" drops the drafts named in `ids`. Free; limited to 10 delivered reports an hour per account (a 429 keeps the draft queued: wait, do not retry in a loop). Before reporting that a field is wrong or a parameter is ignored, re-run the call with a value that could only match if it were honoured. Put the exact call, what came back and what you expected in `details`; never include secrets or API keys.

Read one funding record by id. Costs $0.009 when found; a missing id is free.

Search funding rounds (venture rounds, debt, grants, IPOs), newest announcement first. Costs $0.009 per record returned, drawn from your balance (every account starts with a free $1); a search that matches nothing is free. Page with `cursor`: pass back `next_cursor` exactly as returned; a null `next_cursor` means there are no more matches. Narrow with filters before raising `limit`. Each record gives the headquarters as `location` (the place as the source states it, often a city) and `country` (the country name), plus `country_code` (the ISO 3166-1 alpha-2 code). Coverage: funding rounds are complete from 2026-10-01, partial from 2026-09-22 to 2026-09-30, and only a few earlier rounds are held, so a company whose last round was before that returns none (an empty answer carries a `coverage` object saying so).

Your connected account's remaining credits for messages to people outside its network (credits_remaining). Free. Requires a connected account. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Your connected account's recent posts with impressions, reactions, comments and reposts. Costs $0.0012 per read. Requires a connected account. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Who viewed your connected account's profile, where the network shows them (a hidden viewer is anonymous), plus the view count. Costs $0.0012 per read. Requires a connected account. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Your connected account's social selling index (0 to 100) and its four parts (0 to 25 each), with your rank in your industry and network. Costs $0.0012 per read. Requires a connected account. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Accept a connection invitation your connected account received. Costs $0.005 per action. Requires a connected account. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.

Decline a connection invitation your connected account received. Costs $0.005 per action. Requires a connected account. While GET /pricing does not list this route in its family's available_routes it answers 503 temporarily_unavailable and nothing is charged.