Export People with Email

post

https://api.ai-ark.com/api/developer-portal/v1/people/export

Search and email finding in a single asynchronous call: exports up to 10,000 people matching the same account and contact filters as the People Search API, with real-time verified emails included. The recommended endpoint for bulk outbound list building.

💳 Credit Usage: 0.5 credits per exported person (charged for everyone, whether or not an email is found) + 0.5 credits per found valid email. Example: 1,000 people with 700 emails found = 1,000 × 0.5 + 700 × 0.5 = 850 credits. You only pay the email portion for emails verified in real time by BounceBan. Note: this differs from Find Emails by Track ID, which charges only for found emails.

✅ Email Verification: All emails (SMTP & CATCH_ALL) returned by the API are verified in real time by BounceBan — safe to send, no re-verification needed.

Limit: size maximum is 10000. Exceeding this limit returns 400 Bad Request - pagination limit exceeded.

Results are processed asynchronously; provide a webhook URL to receive a POST when the export completes, or poll Export People Statistics.

Auto-refund window: A submission that is charged but never delivered is auto-refunded after up to 10 hours.

Rate limits (per token): If a token already has 500 requests in flight, a further submit is rejected with 400 too many pending requests — drain below the cap (or wait for completions), then retry. 10 jobs are processed at once. Limits are independent per service and per token.

The response returns a trackId and state (e.g. PENDING) with statistics (total, success, failed, found).

🔗 Related Endpoints:
  • Export People Statistics — poll job progress (free)
  • Export People Results — fetch the exported people + emails, paginated (free)
  • Export People Submissions — your submission & refund history (free)
  • Resend Export People Webhook — re-trigger delivery (free)
  • People Search + Find Emails by Track ID — the equivalent two-step flow with a preview step
  • Export Single Person with Email — row-by-row instead of bulk

📘 Webhook Payload: see Export People Webhook Payload. 🔄 Retry: We automatically retry webhook delivery up to 3 times.

The header Content-Type: application/json must be included in the request.

Body Params

account

object

Match modes & combination logic
Every text filter accepts a mode that controls how your search terms are matched:

SMART (default) — Uses AI to find related concepts, not just the words you typed. Searching for creative director will also find people with titles like art director or head of creative. Use SMART to expand your reach when the exact wording varies.
WORD — Finds the exact phrase but allows extra words around it. creative director will match associate creative director or group creative director, but not art director. Use WORD when the phrase must appear literally.
STRICT — The most restrictive mode: only the exact characters you typed. creative director returns only creative director — no variations, prefixes, or suffixes. Use STRICT for precise, deduplicated targeting.

`any` vs `all`

any = OR logic — a record matches if it matches at least one of the values. Adding more values expands your results.
all = AND logic — a record matches only if it matches every value. Adding more values narrows your results.

Both accept include and exclude. A search cannot consist of exclude filters only.

Value limits

Maximum 300 values per include/exclude array.
Maximum 10,000 results per search (100 per page). To retrieve more than 10,000 — e.g. a search matching 38,000 people — use the Lists pagination pattern: pull the first 10,000, add their ids to a list via POST /v1/lists (free), re-run the same search with "lists": { "people_id": { "exclude": ["<list-id>"] } } — now only 28,000 remain — pull the next 10,000, append to the list, and repeat until you have all 38,000.

contact

object

Match modes & combination logic
Every text filter accepts a mode that controls how your search terms are matched:

SMART (default) — Uses AI to find related concepts, not just the words you typed. Searching for creative director will also find people with titles like art director or head of creative. Use SMART to expand your reach when the exact wording varies.
WORD — Finds the exact phrase but allows extra words around it. creative director will match associate creative director or group creative director, but not art director. Use WORD when the phrase must appear literally.
STRICT — The most restrictive mode: only the exact characters you typed. creative director returns only creative director — no variations, prefixes, or suffixes. Use STRICT for precise, deduplicated targeting.

`any` vs `all`

any = OR logic — a record matches if it matches at least one of the values. Adding more values expands your results.
all = AND logic — a record matches only if it matches every value. Adding more values narrows your results.

Both accept include and exclude. A search cannot consist of exclude filters only.

Value limits

Maximum 300 values per include/exclude array.
Maximum 10,000 results per search (100 per page). To retrieve more than 10,000 — e.g. a search matching 38,000 people — use the Lists pagination pattern: pull the first 10,000, add their ids to a list via POST /v1/lists (free), re-run the same search with "lists": { "people_id": { "exclude": ["<list-id>"] } } — now only 28,000 remain — pull the next 10,000, append to the list, and repeat until you have all 38,000.

lists

object

Reference exclusion lists created via POST /v1/lists (free): { "people_id": { "exclude": ["<list-id>"] } } on people endpoints, { "company_id": { "exclude": ["<list-id>"] } } on Company Search. Up to 10 lists per request, each holding up to 10,000 items. Standard uses: suppress already-contacted prospects, and paginate beyond the 10,000-result cap.

page

integer

required

Defaults to 0

Required on People Search and Company Search (default 0). Zero-based page number. Use with size to paginate. The full result set is capped at 10,000 records per search — see the Lists pagination pattern above to go deeper.

size

integer

required

1 to 10000

Defaults to 10

Required on People Search and Company Search. Results per page: max 100. Default 10 on People Search / Company Search, 25 on Preview. On Export People with Email, size is the total export size, up to 10,000.

webhook

uri

required

Defaults to https://237c-5-61-35-80.ngrok-free.app

HTTPS URL notified when the job completes (retried up to 3×). You can re-send later via the notify endpoint.

Responses

any vs all

any vs all

200Export accepted; processing asynchronously

400Bad Request - e.g. pagination limit exceeded, or too many pending requests (token already has 500 in-flight requests)

404Not Found

`any` vs `all`

`any` vs `all`