LeadOcean · People search
leadocean/people/searchFind companies, people and contact details with LeadOcean · People search from Alexandria through one Spiral API key. Search people by title, seniority, location, employer, or email and phone flags. An empty page costs nothing. Search rows carry has_email and has_phone, not the addresses. Use people/enrich for one full profile, or contact/work-email for the current work address. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
Up to $0.034918 per run.
Limits
- Runs
- In the background
- Returns
- json
- Longest queue wait
- 1 hour
- Run deadline
- 5 minutes
- Longest run, end to end
- 225 minutes
- Largest inline input
- 1 MB
- Largest input file
- 2 GB
- Largest output
- 5 GB
Input
| Field | Kind | Default | Description |
|---|---|---|---|
q | text | — | Free text over the person's name, title, headline, summary, skills, job descriptions, and company name. |
sic | list | — | SIC codes of the employer. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
city | list | — | City keywords for the person. |
slim | true or false | — | Drop empty and heavy parts of each record. Default false. |
count | true or false | — | Also return meta.total. With limit 1 this is a free sizing call: data is empty and meta.countOnly is true. A larger limit is a paid page plus the total. |
limit | number 1 to 10 | 1 | Rows to return, from 1 to 10. LeadOcean allows up to 100; this cap keeps a page within 100 Firecrawl credits. Each returned row costs 10 credits. An empty page costs nothing. Omitting it sends 1. |
order | one of ranked, stable | — | ranked (default) scores the page. stable walks the snapshot in id order. Send the same order on every page. |
title | list | — | Job title keywords. Wrap a value in [brackets] for an exact match. |
cursor | text | — | Opaque page token. Send meta.nextCursor back unchanged. |
domain | list | — | Company domains the person works at, without a scheme or path. |
facets | true or false | — | Also return counts by seniority, country, industry, and company size. |
fields | list | — | Dotted paths to keep, such as profile_data.profile_full_name. Everything else is omitted. |
hqCity | list | — | Company headquarters city keywords. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
country | list | — | Where the person is located. ISO 3166-1 alpha-2 codes. |
hqState | list | — | Company headquarters state or region. A code such as TX also matches Texas. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
hasEmail | true or false | — | Only people with, or without, a known email. |
hasPhone | true or false | — | Only people with, or without, a known phone number. |
industry | list | — | Company industry. Send LeadOcean's exact industry label. |
jobLevel | list | — | Seniority as stored: C-Team, Director, Manager, Other, Staff, or VP. |
keywords | list | — | Phrases in the person's own headline, summary, skills, and job descriptions. |
continent | list | — | Continent the person is in. |
education | list | — | School, degree, or year phrases. |
emailType | list | — | work, work_other, work_any, personal, other, unknown, or none. |
hqCountry | list | — | Company headquarters country. ISO 3166-1 alpha-2 codes. |
investors | list | — | Lead investor keywords. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
reachable | one of any, strict | — | any: an email or a phone. strict: the email is verified, catch_all_valid, or catch_all. |
seniority | list | — | LeadOcean seniority: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern, or unknown. |
viewedSet | text | — | Which viewed list excludeViewed reads. Default is default. |
excludeIds | list | — | person_id values to leave out, at most 1,000. |
maxFounded | number | — | Latest year the company was founded. Records with no figure are left out. |
maxFunding | number | — | Total funding raised, in USD, upper bound. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
minFounded | number | — | Earliest year the company was founded. Records with no figure are left out. |
minFunding | number | — | Total funding raised, in USD, lower bound. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
companyName | list | — | Company name phrase. Wrap a value in [brackets] for an exact name. |
companyType | list | — | Legal type of the company, such as Privately Held or Public Company. |
emailStatus | list | — | Deliverability of the best email: verified, catch_all_valid, catch_all, untested, and the other LeadOcean statuses. |
excludeCity | list | — | Cities to exclude. |
fundingType | list | — | Type of the last funding round. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
hqContinent | list | — | Continent of the company headquarters. |
jobFunction | list | — | Department of the current role. Values are LeadOcean's job_function labels. |
naicsSector | list | — | Two-digit NAICS sector stored on the person. |
salesRegion | list | — | Commercial region: NORAM, LATAM, EMEA, or APAC. |
excludeTitle | list | — | Job titles to exclude. |
maxEmployees | number | — | Company headcount, upper bound. Records with no figure are left out. |
minEmployees | number | — | Company headcount, lower bound. Records with no figure are left out. |
minFollowers | number | — | Minimum company LinkedIn followers. 0 means no minimum. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
technologies | list | — | Technologies detected on the company website. |
employeeRange | list | — | Headcount bracket, such as 51-200. Coarser than minEmployees and maxEmployees. |
excludeViewed | true or false | — | Leave out people this account marked viewed. Marking itself is not a capability here. |
hqSalesRegion | list | — | Commercial region of the company headquarters. |
facetCompanies | true or false | — | With facets, also estimate distinct employers in each bucket. |
minConnections | number 0 to 500 | — | Minimum LinkedIn connections, from 0 to 500. 0 means no minimum. |
companyKeywords | list | — | What the employer does, in its own words, or an exact industry label. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
companyLinkedin | list | — | Company LinkedIn URLs. |
excludeIndustry | list | — | Industries to exclude. Send LeadOcean's exact industry label. |
excludeKeywords | list | — | Profile keywords to exclude. |
profileKeywords | list | — | The person's own profile text. Same match as keywords. |
excludeCompanyName | list | — | Company name phrases to exclude. |
maxLastFundingYear | number | — | Funded no later than this year. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
minLastFundingYear | number | — | Funded no earlier than this year. Applied through the employer, and only when the matching companies number 50,000 or fewer; otherwise the filter is named in meta.unsupportedFilters and a count is withheld. |
technologyCategories | list | — | What a detected technology is for, such as Analytics or CDN. Send LeadOcean's category label. |
excludeProfileKeywords | list | — | Profile keywords to exclude. |
Same request in code
curl https://api.spiral.ai/v1/runs \
-H "Authorization: Bearer $SPIRAL_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"provider": "alexandria",
"model": "leadocean/people/search",
"input": {
"q": "<q>"
}
}'Frequently asked questions
How much does LeadOcean · People search cost?
Up to $0.034918 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use LeadOcean · People search through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "leadocean/people/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.
Do I need an account with Alexandria to use LeadOcean · People search?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use LeadOcean · People search?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.