Skip to main content

​
Run stats

Stats are scoped to a completed run. 
GET /v1/intent/audiences/{id}/runs/{runId}/stats
x-api-key: YOUR_API_KEY

{
  "data": {
    "run": {
      "id": "ad53af16-efbc-4fe1-a764-ded7181653a1",
      "audienceId": "8c049a20-3385-42da-b710-0d038eff5812",
      "status": "completed",
      "runType": "manual",
      "resultCount": 151,
      "completedAt": "2026-05-05T08:45:03.000Z"
    },
    "stats": {
      "total": 151,
      "fillRates": {
        "hashedEmail": { "count": 151, "percent": 100 },
        "email": { "count": 151, "percent": 100 },
        "firstName": { "count": 103, "percent": 68.21 },
        "jobTitle": { "count": 59, "percent": 39.07 },
        "company.name": { "count": 70, "percent": 46.36 },
        "linkedinUrl": { "count": 57, "percent": 37.75 }
      },
      "scoreHistogram": [
        { "bucket": "50-69", "count": 24, "percent": 15.89 },
        { "bucket": "70-89", "count": 111, "percent": 73.51 },
        { "bucket": "90-99", "count": 16, "percent": 10.6 }
      ],
      "averages": {}
    }
  }
}
fillRates includes public result fields exposed by the run results endpoint.

​
Direct CSV download

Use the direct CSV endpoint when you want to stream a completed run as a CSV file immediately. 
GET /v1/intent/audiences/{id}/runs/{runId}/export.csv
x-api-key: YOUR_API_KEY

curl -L "$BASE/v1/intent/audiences/$AUDIENCE_ID/runs/$RUN_ID/export.csv" \
  -H "x-api-key: $API_KEY" \
  -o audience.csv

​
Stored CSV exports

Use stored exports when you need a reusable export record and a signed download URL. 
POST /v1/intent/audiences/{id}/runs/{runId}/exports
x-api-key: YOUR_API_KEY

{
  "data": {
    "export": {
      "id": "40bfaa9b-eff0-468d-b382-9b721790780c",
      "audienceId": "8c049a20-3385-42da-b710-0d038eff5812",
      "runId": "ad53af16-efbc-4fe1-a764-ded7181653a1",
      "exportType": "csv",
      "status": "completed",
      "contentType": "text/csv",
      "byteSize": 18450,
      "rowCount": 151,
      "completedAt": "2026-05-05T08:46:03.000Z"
    },
    "downloadUrl": "https://f005.backblazeb2.com/file/...",
    "downloadUrlExpiresAt": "2026-05-06T08:46:03.000Z",
    "downloadUrlTtlSeconds": 86400
  }
}
List stored exports: 
GET /v1/intent/audiences/{id}/runs/{runId}/exports
x-api-key: YOUR_API_KEY
Refresh a signed URL for a specific export: 
GET /v1/intent/audiences/{id}/runs/{runId}/exports/{exportId}
x-api-key: YOUR_API_KEY

​
Export behavior

  • Stored export URLs expire; call the export detail endpoint for a fresh URL.
  • POST /exports creates or reuses a CSV export for the completed run.
  • CSV rows are tied to the run snapshot identified by runId.