API Last updated: 2024-05-03
Our offers API consists of offers list in JSON format. This API provides all offers without any filters. You can save this info in your database and sort it however you want.
Max request attempts is 10 per 60 minutes.
Param | Required | Type | Description |
---|---|---|---|
site_key | Yes | String | Site public key of your placement. |
site_secret | Yes | String | Site secret key of your placement. |
type | No | String | multireward if you specify multireward in type param, you will get just multireward offers in response. |
take | No | Integer | Limit the number of offers to X. By default, 100 offers are returned. |
skip | No | Integer | Skips the first X number of results. By default, no offers are skipped. |
GET REQUEST
https://adswedtime.com/api/v1/offers?site_key=publickey&site_secret=secretkey&type=multireward
Error Codes and Description
Error | Code | Description |
---|---|---|
missing_fields | 400 | Both the site_key and site_secret are required. |
authentication_failed | 401 | Site not exists which this key and secret. |
invalid_type | 401 | If you added wrong value in "type" param. |
pending_site | 202 | Site is not approved/active yet. |
too_many_requests | 429 | Allowed only 3 requests in 30 minutes. |
Error Response Sample
{ "error": "too_many_requests", "message": "Allowed only 3 requests in 30 minutes." }Sample Response
Content-type : application/json
{ "success": true, "version": "v1", "offers": { "data": [ { "id": 1, "type": "offer", "level": "easy", "stars": 5, "title": "Title of offer", "description": "Offer Description", "image": "6620fa73e56f31713437299.jpg", "payout": 0.2, "categories": null, "countries": [ "All" ], "devices": [ "All" ], "payment_term": "net30", "android_min_os": null, "ios_min_os": null, "url": "https://adswedtime.com/redirect/manual-offer/2761/user/USER_ID_HERE/site/PUBLIC-KEY", "events": [ { "offer_id": 1, "payout": 0, "description": "install" }, { "offer_id": 1, "payout": 5, "description": "Click on 10 Ads" }, { "offer_id": 1, "payout": 10, "description": "Click on 15 Ads" } ] } ] } }
Response Description
Param | Description |
---|---|
payout | Payout will be in USD. |
image |
Relative path of an image. You can get image from this path
https://adswedtime.com/asset/images/offers/
example: https://adswedtime.com/asset/images/offers/6620fa73e56f31713437299.jpg |
countries |
"All" means this offer available for all countries,
Will return an array of countries with full name like [ "united states", "india" ] |
devices |
"All" means this offer available for all devices,
Will return an array of devices like [ "android", "ios", "PC" ] |
categories | Array of categories or null if this offer not belongs to any category. |
payment_term | This provide each offer payment term. We have NET30 and NET60 |
url | Offer tracking link, where you can add your site public key and your userId |
events | For multi-reward offers, this will be an array of events; otherwise, it will not be present in response. |