docs
Audiences

Preview an audience's leads

GET
/v1/audiences/{id}/leads

Lists the leads in an audience. Leads you have not revealed come back as free previews. Leads you already revealed come back in full. Free.

Authorization

bearerAuth
headerAuthorizationBearer <API key>

Create a key in the app under Developers. Keys start with dcd_live_.

Path Parameters

id*string

Audience id. Starts with aud_.

Match^aud_

Query Parameters

cursor?string

Cursor from the previous page's next_cursor.

limit?integer

Items per page, 1 to 100. Defaults to 25.

Range1 <= value <= 100
Default25

Response Body

Success.

application/json
  1. response
data*array<|>

The items on this page.

next_cursor*|

Pass this as ?cursor= to get the next page. Null on the last page.

request_id*string

Id of the request that produced this response. A replayed idempotent response keeps the original id.

Example Request
curl -X GET 'https://api.diced.si/v1/audiences/aud_7GhT2kLm9QpX4sWv1bNc8ZrY/leads' \  -H 'Authorization: Bearer dcd_live_your_key'
Example Response
{  "data": [    {      "id": "string",      "first_name": "string",      "last_name": "string",      "email": "string",      "emails": [        "string"      ],      "business_email": "string",      "phone": "string",      "mobile_phone": "string",      "direct_phone": "string",      "linkedin_url": "string",      "address": {        "line1": "string",        "line2": "string",        "city": "string",        "state": "string",        "zip": "string",        "country": "string"      },      "demographics": {        "gender": "male",        "age_range": "18-24",        "married": true,        "children": true,        "income_range": "<20k",        "net_worth": "<0",        "homeowner": true      },      "job": {        "title": "string",        "seniority": "c_suite",        "department": "administrative"      },      "company": {        "name": "string",        "domain": "string",        "phone": "string",        "industry": "string",        "size": "1-10",        "revenue": "<1m",        "sic": "string",        "naics": "string",        "city": "string",        "state": "string",        "country": "string"      },      "intent": {        "level": "high",        "topic": {          "id": "string",          "name": "string",          "category": "string"        },        "last_active": "string"      },      "household": {        "property1": "string",        "property2": "string"      },      "updated_at": "string",      "unlocked": true    }  ],  "next_cursor": "string",  "request_id": "string"}