API Endpoint & Authentication
The Perkox Dynamic API enables custom offerwall UI rendering on your backend or native client by pulling live offer feeds directly.
METHOD: GET
URL: https://api.perkox.com/offerwall/api/offers
HEADERS: Authorization: Bearer <YOUR_API_TOKEN>
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| app_id | string (required) | Your application identifier. |
| player_id | string (required) | Unique user ID on your platform. |
| device | string (optional) | Filter by "android" or "ios" or "desktop". |
| country | string (optional) | Two-letter ISO country code (e.g. "US", "DE"). |
| page | integer (optional) | Page number for paginated results (default: 1). |
Response Payload Structure (JSON)
response.jsonjson
{
"success": true,
"message": "Offers retrieved successfully",
"data": {
"current_page": 1,
"data": [
{
"id": 10001,
"name": "Kingdom Conquest: Strategy RPG",
"thumbnail": "https://cdn.perkox.com/offers/sample-game-thumbnail.jpg",
"description": "Build a mighty kingdom, gather resources, explore the vast land and battle enemies by completing quests and recruiting heroes.",
"requirements": "Reach the listed levels within 30 days. New users only. Complete events to receive rewards.",
"model": "cpa",
"payout": "0.00",
"devices": [
{ "name": "iOS" },
{ "name": "Android" }
],
"categories": [
{ "name": "Gaming" }
],
"link": "https://tracking.perkox.com/click?pub_id={PUB_ID}&offer_id={OFFER_ID}",
"preview": "https://apps.apple.com/app/example-game/id1234567890",
"events": [
{ "id": "00000000-0000-4000-8000-000000000001", "name": "Install and Open", "payout": "0.00" },
{ "id": "00000000-0000-4000-8000-000000000002", "name": "Complete Tutorial", "payout": "0.50" },
{ "id": "00000000-0000-4000-8000-000000000003", "name": "Reach Level 10", "payout": "2.50" },
{ "id": "00000000-0000-4000-8000-000000000004", "name": "Reach Level 20", "payout": "10.00" },
{ "id": "00000000-0000-4000-8000-000000000005", "name": "Make In-App Purchase", "payout": "5.00" }
]
}
],
"first_page_url": "https://api.perkox.com/offerwall/api/offers?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "https://api.perkox.com/offerwall/api/offers?page=1",
"links": [
{ "url": null, "label": "« Previous", "active": false },
{ "url": "https://api.perkox.com/offerwall/api/offers?page=1", "label": "1", "active": true },
{ "url": null, "label": "Next »", "active": false }
],
"next_page_url": null,
"path": "https://api.perkox.com/offerwall/api/offers",
"per_page": 20,
"prev_page_url": null,
"to": 1,
"total": 1
}
}Offer Tracking Links
Always redirect users through the provided
link URL. This establishes the attribution click cookie and attaches your player_id so conversions are credited to your account.
