Quickstart

This walkthrough takes you through the core loop of the Fuse API: verify your key, search for prospects, save the results into a list, and export that list to CSV.

You will need an API key — create one in Settings → API Cockpit (details). The search-and-save step debits search credits from your workspace; check your balance first if you are unsure.

Verify your key

curl https://api.tryfuse.ai/api/v1/business/me -u "af_YOUR_KEY:"

{ "user": { "id": "685409d3287883fbc17c0ced", "email": "you@company.com", "name": "Your Name" } }

If you get a 401, the key is malformed or revoked — see authentication.

Preview a prospect search

Search filters are structured fields. GET /business/prospects/filter-options returns the accepted values for enumerated filters, so you never have to guess spellings:

curl -X POST https://api.tryfuse.ai/api/v1/business/prospects/search \
  -u "af_YOUR_KEY:" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "job_title_levels": ["c_suite"],
      "job_title_role": ["finance"],
      "location_country": ["united states"]
    },
    "size": 5
  }'

The response is a page of matching profiles plus a scrollToken for the next page. Previewing is the cheap way to tune filters before you commit to saving.

Save results into a list

When the filters look right, save matches into a list. This runs the search server-side and enriches the saved contacts asynchronously:

curl -X POST https://api.tryfuse.ai/api/v1/business/prospects/search/save-to-list \
  -u "af_YOUR_KEY:" \
  -H "Content-Type: application/json" \
  -d '{
    "filters": {
      "job_title_levels": ["c_suite"],
      "job_title_role": ["finance"],
      "location_country": ["united states"]
    },
    "listName": "US finance leaders",
    "limit": 100
  }'

{ "listIds": ["68a1f20b9c41d20014b3e901"] }

The 202 means the job started. Contacts appear in the list as enrichment completes — poll the next step until rows show up.

Billing note: this endpoint runs its own search and debits credits for the rows it saves. It does not reuse a previous POST /prospects/search — so preview to tune filters, then save once. Details in credits & billing.

Read the list

curl "https://api.tryfuse.ai/api/v1/business/lists/68a1f20b9c41d20014b3e901/rows?limit=25&pageNum=1" \
  -u "af_YOUR_KEY:"

Rows carry the contact’s identity fields plus columnValues for any custom columns on the list, and the response is paginated.

Export to CSV

Exports are asynchronous: start a job, poll it, download the file.

# start
curl -X POST https://api.tryfuse.ai/api/v1/business/lists/68a1f20b9c41d20014b3e901/export \
  -u "af_YOUR_KEY:" -H "Content-Type: application/json" -d '{}'
# -> { "jobId": "68a1f5209c41d20014b3eb11" }

# poll until status is "completed"
curl https://api.tryfuse.ai/api/v1/business/exports/68a1f5209c41d20014b3eb11 \
  -u "af_YOUR_KEY:"
# -> { "exportJob": { "status": "completed", "rowCount": 100, "downloadUrl": "https://..." } }

The downloadUrl is a presigned link valid for 15 minutes, and the file downloads named after your list.

Where to next

Campaigns end to end

Turn a list into an outbound campaign — manual, AI-generated, or from a template.

Upload your own contacts

Bring contacts from your CRM instead of searching.

Errors

The one envelope every failure uses, and every code you can receive.

Rate limits

Per-surface quotas and the headers that tell you where you stand.

Get started

Concepts

Guides

Where to next

Campaigns end to end

Upload your own contacts

Errors

Rate limits

​Where to next

Campaigns end to end

Upload your own contacts

Errors

Rate limits

Where to next