Skip to main content
POST
Find contacts at prospects' sites
Pass up to 50 prospectIds. The optional terms array accepts 3-25 distinct job titles; omit it to search the default editorial, SEO, marketing, and owner roles. Use GET /v3/outreach/prospects/people-search-terms to see the suggested titles and defaults. The request starts background work. The 202 response reports enqueuedCount, enqueuedProspectIds, skipped, and creditsCharged. Poll Outreach Prospects while an enqueued site’s status is finding_people, then read Outreach Contacts for names and roles. This costs 5 AI credits per site searched, with a refund when a site yields nobody new. Sites already being searched, sites that already link to you, and self-serve or creator-platform opportunities are skipped without a charge. Finding people does not buy their email addresses.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
prospectIds
string[]
required

Prospect IDs to search.

Required array length: 1 - 50 elements
terms
string[]

Job titles to search for, matched as substrings and OR'd together - 'editor' finds 'Managing Editor'. Between 3 and 25 distinct terms; omit to use a sensible default covering editorial, SEO, marketing and owners.

Required array length: 3 - 25 elements

Response

202 - application/json

Default Response

enqueuedCount
integer
enqueuedProspectIds
string[]
skipped
integer
creditsCharged
number