Skip to main content
GET
Offers

Authorizations

X-API-Key
string
header
required

Your API key from the Studio Dashboard

Query Parameters

page
integer
default:1

Page number, 1-indexed.

Required range: x >= 1
page_size
integer
default:50

Items per page. Default 50, max 100.

Required range: 1 <= x <= 100
id
integer

Filter to a single offer (use to fetch one offer's details via the list endpoint).

Required range: x >= 1
source
string
Maximum string length: 32
marketer_uuid
string<uuid>

Filter to offers from a specific marketer.

partner_level
enum<string>
Available options:
new,
base,
pro,
expert
guaranteed_speed
enum<string>
Available options:
true,
false,
1,
0
min_price
number
Required range: x >= 0
max_price
number
Required range: x >= 0
available_only
enum<string>
Available options:
true,
false,
1,
0
sort
enum<string>
default:recommendation

Sort order.

  • recommendation: platform recommendation (default).
  • added_desc: newest offers first (by offer creation date).
  • added_asc: oldest offers first.
  • price_asc: cheapest first (effective per-fan price after your discount).
  • price_desc: most expensive first (effective per-fan price after your discount).
  • traffic_desc: most traffic first (running aggregate fans delivered in the last 30 days).
Available options:
recommendation,
added_desc,
added_asc,
price_asc,
price_desc,
traffic_desc

Response

Successful response

success
boolean
Example:

true

data
object[]
pagination
object

Page-based pagination, returned by every list endpoint that isn't a cursor feed.