DocsDynamic Offer API & JSON Feed

Dynamic Offer API & JSON Feed

Programmatically fetch live offers, creative assets, multi-tier events, and payouts via JSON REST API.

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

ParameterTypeDescription
app_idstring (required)Your application identifier.
player_idstring (required)Unique user ID on your platform.
devicestring (optional)Filter by "android" or "ios" or "desktop".
countrystring (optional)Two-letter ISO country code (e.g. "US", "DE").
pageinteger (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": "&laquo; Previous", "active": false },
      { "url": "https://api.perkox.com/offerwall/api/offers?page=1", "label": "1", "active": true },
      { "url": null, "label": "Next &raquo;", "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.