Get Offers

get

https://api.bitlabs.ai/v2/client/offers

Returns offers for the current user in one of two modes: Full catalog (default) — Omit offer_ids. Behavior matches the historical user-based offers list (upstream AdGate user-based offers API). Optional query parameters such as limit, is_game, devices, client_ip, client_user_agent, and in_app apply to this mode. By offer IDs — Include offer_ids as a comma-separated list of AdGate offer IDs (non-empty, duplicate IDs deduplicated). There is no BitLabs-enforced maximum ID count (subject to upstream AdGate limits). The response uses the same OffersV2 schema; upstream calls use AdGate’s user-based “offers by IDs” API. Optional tags use the same encoding and merge semantics as catalog mode. List-scoping parameters (limit, is_game, devices, etc.) are ignored in this mode. Response order matches AdGate only; BitLabs does not reorder results. Malformed offer_ids, empty offer_ids, or invalid tags yield 400 Bad Request. The upstream rank_method parameter is not supported.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

devices

array of strings

An array that any combination of iphone, ipad, or android. Provide an empty array to clear existing devices.

devices

in_app

boolean | null

If true, only offers that follow App Store and Play Store guidelines are returned. If not set, it falls back to the app setting.

client_user_agent

string

The user agent string of the user's device.

client_ip

string

The IPv4 address of the user's device.

is_game

boolean | null

If true, only game offers are returned. If false, only non game offers are returned. If not set, all offers are returned.

limit

integer

Optional maximum number of offers to return from the upstream AdGate user-based offers API (limit={int}). This is not page-based pagination; omit the parameter for default upstream behavior. Ignored when offer_ids is present.

offer_ids

string

Comma-separated AdGate offer IDs. When present, selects by-ID mode (see operation description). Duplicate IDs are deduplicated. No fixed maximum count at the BitLabs API layer.

200OK