Quickstart

This walks through the API end to end: see what’s available, get a free quote, export, and download. The same flow works from the CLI in one command, and from an AI agent.

You need an Intent Leads account with a plan and at least one lane. Sign up at intentleads.si, pick a plan on Usage and plan, and set up a lane (or ask us to set them up for you).

Create an API key

In the dashboard, open API and CLI and create a key. Copy it straight away: it’s shown once. Keys start with il_live_.

export INTENT_LEADS_KEY="il_live_..."

Every request sends it as a bearer token. See Authentication.

See how many new people each lane has

curl -s https://intentleads.si/api/v1/lanes \
  -H "Authorization: Bearer $INTENT_LEADS_KEY"

Each lane shows its keywords and how many people you could export now, after every filter and less anyone you’ve already exported this billing period. This is free.

Get a free quote

Ask how many people an export would get. dry_run: true never buys anything.

curl -s -X POST https://intentleads.si/api/v1/exports \
  -H "Authorization: Bearer $INTENT_LEADS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lanes": ["L1"], "max": 100, "dry_run": true}'

Response

{
  "dry_run": true,
  "lanes": [
    {
      "lane": "L1",
      "name": "Sales development, build or buy",
      "strength": "medium",
      "available": { "high": 12, "medium_plus": 143, "all": 673, "at_lane_strength": 143 },
      "data_window": { "start": "2026-09-30", "end": "2026-10-13" },
      "checked_at": "2026-10-14T06:02:11.000Z",
      "approximate": false
    }
  ],
  "requested": 100,
  "available": 143,
  "will_export": 100,
  "capped_by": "max",
  "allowance": { "plan": "starter", "before": 2490, "after": 2390, "period_end": "2026-11-09" },
  "exports_enabled": true,
  "notes": ["…"]
}

will_export is the smallest of what you asked for, what’s available, and the contacts left on your plan.

Confirm the export

Send the same request with dry_run: false and an idempotency_key. The key makes retries safe: sending it again returns the same export and never buys twice.

curl -s -X POST https://intentleads.si/api/v1/exports \
  -H "Authorization: Bearer $INTENT_LEADS_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lanes": ["L1"], "max": 100, "dry_run": false, "idempotency_key": "2026-10-14-l1"}'

Response (202)

{
  "export": {
    "id": "01a13b70-5f2e-7c1a-9d3e-2b8f6a4c1e90",
    "status": "queued",
    "lanes": ["L1"],
    "requested": 100,
    "will_export": 100,
    "exported": 0,
    "min_strength": null,
    "billing_period": "2026-10-09",
    "via": "api",
    "created_at": "2026-10-14T09:15:02.000Z",
    "finished_at": null,
    "error": null
  },
  "reused": false,
  "poll": "/api/v1/exports/01a13b70-5f2e-7c1a-9d3e-2b8f6a4c1e90"
}

Wait for it, then download

Exports usually finish within a few minutes. Poll until status is completed (or partial, if fewer people were really there than estimated):

curl -s https://intentleads.si/api/v1/exports/01a13b70-5f2e-7c1a-9d3e-2b8f6a4c1e90 \
  -H "Authorization: Bearer $INTENT_LEADS_KEY"

Then get the CSV. Downloading again is always free.

curl -s "https://intentleads.si/api/v1/exports/01a13b70-5f2e-7c1a-9d3e-2b8f6a4c1e90?format=csv" \
  -H "Authorization: Bearer $INTENT_LEADS_KEY" -o leads.csv

See Lead fields for every column.

Next steps

Pull new leads on a schedule

GET /api/v1/leads?since=last returns only people you haven’t pulled yet.

Handle removal requests

Check GET /api/v1/suppressions and delete those people within 10 business days.

Do it from the terminal

intentleads export --lane L1 --max 100 --format csv --out leads.csv

All endpoints

Lanes, keywords, checks, usage, team and keys.

Get started

How it works

Your account

Tools

Reference

Next steps

Pull new leads on a schedule

Handle removal requests

Do it from the terminal

All endpoints

​Next steps

Pull new leads on a schedule

Handle removal requests

Do it from the terminal

All endpoints

Next steps