List available Smart Link ads

Returns a batch of eligible Smart Link offers for the authenticated publisher.

Each item is a reserved visit with its own id and smart_link. Cache the batch briefly
on your server using cache_ttl_seconds (do not re-request on every UI render).

When an end user starts an offer, open smart_link in their browser only. That URL
is a Highpay redirect for humans, not a publisher API call.

HTTP 200 with success=true and an empty ads array means no fill right now.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
length ≤ 191

Opaque ID for your end user. Used for cooldown / abuse detection. Do not send PII.

string
length between 2 and 2
^[A-Za-z]{2}$

ISO 3166-1 alpha-2 country code for geo targeting.

string
enum
length ≤ 32

Device class hint.

Allowed:
string
length ≤ 16

Language hint (BCP 47 / short code).

integer
1 to 25

Max ads to return (default and hard max are platform-configured).

Responses

Language
Credentials
Bearer
hp_live_|hp_test_
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json