Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaLead GenAvailable now

LeadOcean · People search

leadocean/people/search

Find 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

FieldKindDefaultDescription
qtext—

Free text over the person's name, title, headline, summary, skills, job descriptions, and company name.

siclist—

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.

citylist—

City keywords for the person.

slimtrue or false—

Drop empty and heavy parts of each record. Default false.

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

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

orderone of
ranked, stable
—

ranked (default) scores the page. stable walks the snapshot in id order. Send the same order on every page.

titlelist—

Job title keywords. Wrap a value in [brackets] for an exact match.

cursortext—

Opaque page token. Send meta.nextCursor back unchanged.

domainlist—

Company domains the person works at, without a scheme or path.

facetstrue or false—

Also return counts by seniority, country, industry, and company size.

fieldslist—

Dotted paths to keep, such as profile_data.profile_full_name. Everything else is omitted.

hqCitylist—

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.

countrylist—

Where the person is located. ISO 3166-1 alpha-2 codes.

hqStatelist—

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.

hasEmailtrue or false—

Only people with, or without, a known email.

hasPhonetrue or false—

Only people with, or without, a known phone number.

industrylist—

Company industry. Send LeadOcean's exact industry label.

jobLevellist—

Seniority as stored: C-Team, Director, Manager, Other, Staff, or VP.

keywordslist—

Phrases in the person's own headline, summary, skills, and job descriptions.

continentlist—

Continent the person is in.

educationlist—

School, degree, or year phrases.

emailTypelist—

work, work_other, work_any, personal, other, unknown, or none.

hqCountrylist—

Company headquarters country. ISO 3166-1 alpha-2 codes.

investorslist—

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.

reachableone of
any, strict
—

any: an email or a phone. strict: the email is verified, catch_all_valid, or catch_all.

senioritylist—

LeadOcean seniority: owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern, or unknown.

viewedSettext—

Which viewed list excludeViewed reads. Default is default.

excludeIdslist—

person_id values to leave out, at most 1,000.

maxFoundednumber—

Latest year the company was founded. Records with no figure are left out.

maxFundingnumber—

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.

minFoundednumber—

Earliest year the company was founded. Records with no figure are left out.

minFundingnumber—

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.

companyNamelist—

Company name phrase. Wrap a value in [brackets] for an exact name.

companyTypelist—

Legal type of the company, such as Privately Held or Public Company.

emailStatuslist—

Deliverability of the best email: verified, catch_all_valid, catch_all, untested, and the other LeadOcean statuses.

excludeCitylist—

Cities to exclude.

fundingTypelist—

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.

hqContinentlist—

Continent of the company headquarters.

jobFunctionlist—

Department of the current role. Values are LeadOcean's job_function labels.

naicsSectorlist—

Two-digit NAICS sector stored on the person.

salesRegionlist—

Commercial region: NORAM, LATAM, EMEA, or APAC.

excludeTitlelist—

Job titles to exclude.

maxEmployeesnumber—

Company headcount, upper bound. Records with no figure are left out.

minEmployeesnumber—

Company headcount, lower bound. Records with no figure are left out.

minFollowersnumber—

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.

technologieslist—

Technologies detected on the company website.

employeeRangelist—

Headcount bracket, such as 51-200. Coarser than minEmployees and maxEmployees.

excludeViewedtrue or false—

Leave out people this account marked viewed. Marking itself is not a capability here.

hqSalesRegionlist—

Commercial region of the company headquarters.

facetCompaniestrue or false—

With facets, also estimate distinct employers in each bucket.

minConnectionsnumber
0 to 500
—

Minimum LinkedIn connections, from 0 to 500. 0 means no minimum.

companyKeywordslist—

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.

companyLinkedinlist—

Company LinkedIn URLs.

excludeIndustrylist—

Industries to exclude. Send LeadOcean's exact industry label.

excludeKeywordslist—

Profile keywords to exclude.

profileKeywordslist—

The person's own profile text. Same match as keywords.

excludeCompanyNamelist—

Company name phrases to exclude.

maxLastFundingYearnumber—

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.

minLastFundingYearnumber—

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.

technologyCategorieslist—

What a detected technology is for, such as Analytics or CDN. Send LeadOcean's category label.

excludeProfileKeywordslist—

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.