The fastest way to embed our offerwall. Three steps: apply, get your keys, paste the iFrame.
Step 1 — Apply.
Create a publisher account and submit your app or website for review.
Step 2 — Get keys.
After approval, copy your Public Key (site key) and Secret Key from Setup in your dashboard.
Step 3 — Embed.
Paste the tracking link in an iFrame and configure your postback URL. Replace YOUR_KEY with your Public Key and USER_ID with your user's unique identifier.
When a user completes an offer, we send a HTTP GET request to your postback URL with the parameters below. Use this to credit (and, if needed, debit) your user's balance from the server side.
Parameters
Parameter
Type
Description
subId
string
Your user's unique identifier (the one you passed as USER_ID).
transId
string
Unique transaction ID — use for deduplication.
reward
number
Amount of virtual currency to credit.
payout
number
Offer payout in USD.
signature
string
MD5 hash for verification (see below).
status
integer
1 = credit · 2 = chargeback (subtract).
offer_id
string
Completed offer ID.
offer_name
string
Completed offer name.
round_reward
number
Reward rounded to your site's decimal setting.
userIp
string
User's IP address.
country
string
ISO 2-letter country code.
uuid
string
Unique click ID.
event_id
string
Event ID (multi-reward offers only).
event_name
string
Event name (multi-reward offers only).
Signature verification
Always verify the signature before applying the reward or chargeback. The formula is md5(subId + transId + reward + SECRET_KEY).
Always respond with HTTP 200 and a short body (e.g. OK) once you've handled the event. Non-200 responses trigger retries from our Action Center.
#sec-api
Offers API
Use the Offers API when you want a custom UI and need offer data in JSON. Keep the click id from the response so your postback audit trail can connect back to the user action.
GET/api/v1/offers
Rate limit: 10 requests/hour per site credentials. Responses include an X-RateLimit-Remaining header.
Parameters
Parameter
Required
Type
Description
site_key
required
string
Site public key.
site_secret
required
string
Site secret key.
type
optional
string
offer or multireward.
limit
optional
integer
Results per page (1–500). Default: 100.
offset
optional
integer
Skip N results for pagination.
country
optional
string
ISO 2-letter code (US, DE, BR).
device
optional
string
android, ios, desktop.
min_payout
optional
float
Minimum USD payout.
updated_since
optional
string
ISO 8601 date for incremental sync.
Example request
offers-api.sh
# Fetch US Android offers with a minimum $1 payoutGEThttps://www.cointomedia.com/api/v1/offers?site_key=YOUR_KEY&site_secret=YOUR_SECRET
&country=US
&device=android
&min_payout=1.00
&limit=50
Display banner ads in mobile apps (Flutter, Kotlin, Swift, React Native) or any platform that can make HTTP requests. Returns JSON with image URLs — no JavaScript required.
GET/api/banners/v1/native
Parameters
Param
Required
Description
site_key
Yes
Your site/app key from the publisher dashboard.
sub_id
Yes
Unique user ID in your app (for tracking & anti-fraud).