Integration guide

Offers API

Pull offers on your server and build a custom wall.

Offers API

Server-side only. Do not call this from untrusted browsers with your secret key.

Endpoint

code

GET https://prismads.co/api/v1/offers

Query parameters

Param	Required	Description
`placement_id`	yes	Placement ID
`api_key`	yes	Public API key (`pk_`)
`user_id`	yes	Your end-user id
`country`	no	ISO code, e.g. `US`
`platform`	no	`web`	`android`	`ios`

Optional header

code

Authorization: Bearer sk_YOUR_SECRET

Windows curl example

bat

curl "https://prismads.co/api/v1/offers?placement_id=YOUR_PLACEMENT_ID&api_key=pk_YOUR_KEY&user_id=test_user_1&country=US&platform=web"

Success response (shape)

json

{
  "success": true,
  "placement_id": "...",
  "user_id": "test_user_1",
  "currency": { "code": "COIN", "name": "Coins", "rate": 100 },
  "count": 12,
  "offers": [
    {
      "id": "offer_123",
      "name": "Install Game",
      "payout_usd": 0.75,
      "reward": 75,
      "click_url": "https://prismads.co/click/offer_123?placement_id=...&user_id=..."
    }
  ]
}

Send users to click_url. We redirect to the advertiser destination.

Errors

HTTP	Code	Meaning
400	`USER_ID_REQUIRED`	Missing `user_id`
400	`PLACEMENT_ID_REQUIRED`	Missing `placement_id`
401	`API_KEY_REQUIRED`	Missing `api_key`
401	`INVALID_API_KEY`	Wrong `api_key`, revoked key, or `api_key` does not belong to this `placement_id`
401	`INVALID_SECRET`	Bearer / `secret_key` does not match (when provided)
403	`PLACEMENT_NOT_LIVE`	Placement not approved yet
403	`PUBLISHER_NOT_LIVE`	Publisher account not approved

Web offerwall

Android