Bulk export

What it does

A bulk export is a people search that writes rows to a file instead of a page. It takes the same filters as search, so anything you can find you can export.

The file is a plain .csv, never zipped. It is built by a background worker, so a request is admitted or refused on the spot and you poll for the result. An email goes out when the file is ready.

Count first, then export. count_leads is free, and a search with count=true and limit 1 is free too. You see the size of the list before a single record is spent.

Each row written is 1 record, whatever columns it carries. Records are reserved when the export is admitted, and the ones for rows never written are released.

What you get

You choose a preset or an ordered list of column ids. GET /v1/exports/columns is free and public, and lists all of them.

Numbered columns come back as email_1_address, email_1_status and phone_1_number. A value we do not hold is empty.

How you use it

In the app

The Exports page at app.leadocean.io has a filter builder, a column picker with presets, the record price before you start, and a Download button. Build the filter, pick a preset, check the price, download.

The app is a data export. It has no sequencer, dialer, CRM or Chrome extension.

With the API

curl -X POST "https://api.leadocean.io/v1/exports" \
  -H "x-api-key: $LEADOCEAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "acme-vp-sales-ca",
    "filters": {
      "jobLevel": ["VP"],
      "jobFunction": ["Sales & Business Development"],
      "country": ["CA"],
      "emailStatus": ["verified"]
    },
    "limit": 5000,
    "preset": "full"
  }'

The answer is a 202 with the job: id, status, estimatedTotal, remaining and pollAfter (10 seconds). When status is done, download the file with your key or the signed downloadUrl. DELETE /v1/exports/{id} cancels a job and keeps the rows already written.

From an AI agent

The hosted MCP server at https://api.leadocean.io/mcp signs in with OAuth 2.1, so no key is pasted. Export uses three of its 12 tools: leadocean_export_leads, leadocean_get_export and leadocean_list_exports. Try:

Count VPs of sales in Canada with a verified email. If under 10,000, export them with the search preset and give me the download link when it is ready.

The agent counts first with leadocean_count_leads, which is free, then starts the export. leadocean_get_export and leadocean_list_exports are free.

Pricing

Free is 1,000 records, one-off, no card. Pro is $499 a month, flat. Both get the same API, app and MCP server.

Pro has no per-record price and no credits. Exports, searches and lookups are unlimited inside fair use. Past the fair-use line a very large month is paced down to one request a minute until the reset, not cut off. See pricing.

Limits

• Per export. 50,000 rows.
• Per account. 500,000 rows a day and 10,000,000 rows per period. These can be raised: write to support@leadocean.io.
• One at a time. One export runs per account at a time. The rest queue.
• File life. The file is kept 7 days. The key-free emailed link works for 24 hours.
• Rate limit. 100 requests per second per key, on every plan.
• Count cap. meta.total on the REST API stops at 100,000. Use the MCP count for a bigger list.
• Refusals. export_limit_rows, export_filter_unsupported (a filter the index cannot apply, so an export is never half-filtered), export_limit_daily, export_limit_monthly, and 402 when you lack the records.
• Gaps. Certification columns exist but stay empty. About half of profile summaries end in an ellipsis. There is no refund for bounced emails, so filter on emailStatus.

FAQ