Skip to main content
GET
Get Audience Leads

Authorizations

Authorization
string
header
required

Enter your API key: wave_live_<token>

Path Parameters

id
string
required

Query Parameters

page
integer | null
default:1

Page number (starts at 1)

Required range: x >= 1
limit
integer | null
default:15

Items per page (max 100)

Required range: 1 <= x <= 100
sort_field
string | null

Field name to sort by (e.g. 'follower_count' or 'username')

sort_order
string | null

Sort direction: 'asc' or 'desc'

Pattern: ^(asc|desc)$
search
string | null

Search term to filter leads by username or bio

filters
string | null

JSON-encoded string of column filter criteria. Example: '{"follower_count": {"min": 500, "max": 50000}, "is_verified": true, "account_type": "Business"}'

Response

Successful Response

Paginated list of leads with search and filter state.

data
Data · object[]
required

Array of extracted Instagram profile objects

page
integer
required

Current page number

Example:

1

limit
integer
required

Page size limit

Example:

15

total
integer
required

Total leads matching search/filter criteria

Example:

320

total_pages
integer
required

Total pages available

Example:

22

search
string | null

Search term applied

filters
any | null

Column filter rules applied. Can be passed as a JSON-encoded string in query params. Example: '{"follower_count": {"min": 500, "max": 50000}, "is_verified": true, "account_type": "Business"}'