Skip to main content
POST
Upload Manual Audience CSV

Authorizations

Authorization
string
header
required

Enter your API key: wave_live_<token>

Body

multipart/form-data
file
file
required

CSV file with username (col 1) and optional icebreaker (col 2)

name
string
required

Audience list name

Required string length: 1 - 300
desc
string | null

Optional audience description

Maximum string length: 1000

Response

Successful Response

Full detail of an audience list including filter configurations.

id
string<uuid>
required

Audience list ID

name
string
required
type
string
required
desc
string | null
max_scrape_count
integer | null
parentUsernames
string[] | null

Parent Instagram post or reel URLs used to seed a POSTS audience (with like/comment filters)

raw_audience
integer
default:0

Total raw leads extracted from Instagram

filtered_audience
integer
default:0

Total leads that passed the filter criteria

filters
FilterConfigSchema · object[]

Configured filter rules

created_at
string<date-time> | null
updated_at
string<date-time> | null