Get Offers
Main API endpoint to fetch available offers for a particular user. Use this to display offers in your offer wall.
Last updated
Was this helpful?
Main API endpoint to fetch available offers for a particular user. Use this to display offers in your offer wall.
Last updated
Was this helpful?
Method: GET Base URL:
aff_id
Any Integer
60000
api_key
Any String
941bd1fecf7e6596823b895e04df3a0c
wall_code
String
nQug
user_id
The affiliate's user ID. Max length 255 bytes
String
user12345
ip
IP v4 or v6. Used to target offers geographically.
String
127.0.0.1
user_agent
The end-user's user agent, used for device targeting.
String
in_app
Will this placement be inside an app? If string "true", we will only return offers that follow App Store and Play Store guidelines.
"true" or "false"
false
rank_method
One of "cpm" or "cr". Determines how the rank field will be calculated.
String
cpm
s2 s3 s4 s5
Four available subIDs the affiliate can pass to us. We will return them in the affiliate's postback.
String
lang
The language as provided by the browser (from Accept-Language HTTP header). Defaults to English if not provided.
String
categories
App metadata categories filter. If provided, we will return the offers that belong to the given app metadata categories. It accepts comma-separated category names with partial matching using asterisk.
String
game*,entertainment
exclude_categories
App metadata categories exclusion filter. If provided, we will return the offers that do not belong to the given app metadata categories. It accepts comma-separated category names with partial matching using asterisk.
String
game*,entertainment
is_game
If set to true or false, will return only games or non-games. If not provided both games and non-games are returned.
String
true
age
User's age. If provided, we will return the offers that meet the given age targetng requirement.
Integer
24
gender
User's gender. If provided, we will return the offers that meet the given gender targetng requirement.
String
male
override_w2m_devices
A list of the devices the user owns separated by commas. You may use this instead of posting devices to the Devices endpoint. Allowed values are "iphone", "ipad", and "android". Only used if user_agent is a desktop device.
String
iphone,android
An array of offers will be returned on success. Each offer will have the following fields:
id
Offer ID
int
341022
anchor
Offer title to display to users
string
Playstation 5
things_to_know
Offer information that can be presented as a bullet-point list
array
[ "Enter to win a Playstation 5!", "You must click “Allow” if tracking permission is requested within the app." ]
session_hours
Offer is valid for that many hours
int
720
offer_expires_at
Offer expiration timestamp
int
1741370828
requirements
What the user should do to complete an offer
string
Sign up with valid information and complete the full survey.
description
Description to display to the user
string
Enter to win a Playstation 5!
disclaimer
A field to display with each offer. Replace the ${sitename} macro yourself.
string
This offer is presented to you by ${sitename} on behalf of a third party merchant
product_id
A unique string shared between offers which belong to same product, e.g. same mobile app.
string
01JEEDPNV72ZX4FFY81K2HSSTC
product_name
The offer's product name.
string
Product #1
confirmation_time
Text that described how long it takes to receive credit
string
Confirms Instantly
creatives
Links to offer creatives
object
creatives.images
Links to offer images
object
{ "275x275": "https://example.org/275x275.jpg", "400x400": "https://example.org/400x400.jpg"}
pending_time
Time in minutes that a reward will be held from the user following completion
int
60
mobile_verification_required
Whether the end user needs to verify their mobile phone number
bool
false
web2mobile
Whether this offer must be accessed on the user's mobile device. You must send us the devices the user owns via the [POST devices] endpoints. If no devices are stored, web2mobile offers will not be returned.
bool
FALSE
web2mobile_devices
Array of devices the users must access the user on. NULL if not a web2mobile offer. The list of applicable devices is taken from the devices stored for that particular user (see the other devices API endpoint)
array|null
["iphone", "ipad"]
app_metadata.app_id
App ID on the mobile app store. It can be either App Store or Google Play Store app ID.
string|null
1596736236
app_metadata.categories
An array of app metadata categories.
array|null
["Games", "Casual", "Puzzle"]
app_metadata.screenshot_urls
An array of app metadata screenshot URLs.
array|null
["https://is1-ssl.mzstatic.com/image/thumb/Purple126/v4/39/88/3a/39883ae6-4f45-9879-c849-aedb4d5ab40c/2e706b4c-baf0-456b-ad67-81db322f75a8_CLASSIC22_202203_2688x1242_Screenshots_01_en-US.png/643x0w.png"]
app_metadata.video_urls
An array of app metadata video URLs.
array|null
["https://play.google.com/video/lava/web/player/yt:movie:dSg_iqQpKYA?autoplay=1&authuser=0&embed=play"]
is_game
Whether the offer is a game offer
bool
FALSE
click_url
URL to redirect the user to
string
https://seek.gg/vc/nQ/users/testuser/offers/360819?source_type=live_offer_api
support_url
URL of the support form for this offer
string
https://seek.gg/offer/contact/nqqYp2g/1666524?s1=testuser
impression_url
URL to notify that the offer was viewed
string
https://seek.gg/v1/user-based-api/impression?funnel_id=01JKBMPR5QYT91EGGV1R62DB2W&wall_code=nqqYp2g&user_id=testuser&offer_id=1666524
icon_url
Square icon URL
string
https://main-p.agmcdn.com/offers/1639000851514.jpg
categories
Offer categories
array
[ "CPI", "iPad", "iPhone" ]
total_points
Total points the user may earn
float
126.72
total_points_promotional
If a promotion is currently in progress, the amount of points they will earn. If not null, this should be used instead of total_points.
float|null
187.9
sticky
If an offer should be pinned to the top of the offer wall
bool
TRUE
rank
The rank of the offer according to the "rank_method" requested
int
1
events
An array of events the user may complete to earn points. Each event is an object.
array
[see below]
events.#.uuid
ID of the event
string
0dc43f54-135a-46a4-a51c-a2c5f3cfdac0
events.#.name
Event name to display to the user
string
Completed
events.#.type
"flat" or "dynamic". Flat events have static point values. Dynamic events will have varying payouts.
string
flat
events.#.payable
Whether the event pays anything to the user
bool
TRUE
events.#.ttc_minutes
Minutes to complete this event after the click
int
43200
events.#.expires_at
Timestamp when the event expires
int
1741370829
events.#.flat_points
Will be 0 if the event is not payable.
float|null
126.72
events.#.flat_payout
Will be 0 if the event is not payable.
float|null
46.22
events.#.flat_promotional_points
Points if there is an ongoing promotion
float|null
187.9
events.#.dynamic_display_type
Either "up_to" or "commission". This determines how the potential points are displayed.
"up_to": display "Up to {dynamic points amount}
"commission": display "{dynamic points amount} per ${dynamic payout amount}
string|null
up_to
events.#.dynamic_points
Described above
float|null
187.9
events.#.dynamic_payout
For "commission", the dollars amount to use in the phrase above
float|null
1
events.#.dynamic_promotional_points
Described above
float|null
0
events.#.event_type_id
ID used to identify the event type
Integer|null
1
events.#.time_played
Time played goal associated with the event.
object|null
events.#.time_played.id
Time played goal id.
integer
100
events.#.time_played.goal_unit
The unit of time that the goal is measured in. Allowed values are: NANOS, MICROS, MILLIS, SECONDS, MINUTES, HOURS, HALF_DAYS, DAYS, WEEKS, MONTHS, YEARS, DECADES, CENTURIES, MILLENNIA, ERAS, FOREVER.
string
DAYS
events.#.time_played.goal_unit_count
The quantity of goal unit required to complete the goal.
integer
7
events.#.multiple_conversions_allowed
Whether this event can be converted multiple times
bool
true
events.#.multiple_conversions_rules
The rules for multiple event conversions
object|null
events.#.multiple_conversions_rules.rule_type
Can be UNLIMITED, TOTAL_CONVERSIONS or INTERVAL
string
"UNLIMITED"
events.#.multiple_conversions_rules.x_conversions
Number of conversions allowed
int
3
events.#.multiple_conversions_rules.every_y_seconds
Only used for INTERVAL type: allows X conversions every Y seconds
int
600
The following table shows the list of offer event type ids that can be retrieved in the API:
1
Install
2
Event
3
Purchase
4
Dynamic Event: Adjust
5
Dynamic Event: Playtime
6
Dynamic Event: AppsFlyer
NULL
N/A
Your affiliate ID. Can be found on the .
Your API key. Can be found on the .
Wall code that can be found on the