Clicks API

The Clicks API returns a user's recent offer clicks and the current status of each one. Use it to build a "My offers" or "Pending rewards" screen so users can see what they started and whether it has been credited.

Endpoint

GET http://adplusmedia.com/api/v1/offers-iframe/clicks/[APP_ID]/[USER_ID]

Authentication

Like the Offerwall API, this endpoint takes no API key. The placement must exist and be Active.

Anyone who knows your app ID and one of your user IDs can read that user's click history. Do not include anything sensitive in your user identifiers, and consider proxying this endpoint through your own backend if you need access control.

Example request

bash

curl "http://adplusmedia.com/api/v1/offers-iframe/clicks/1042/user_8837"

Response

json

{
      "clicks": [
        {
          "id": 90218,
          "image": "https://cdn.example.com/offers/4821.png",
          "offername": "Monopoly GO!",
          "status": "completed"
        },
        {
          "id": 90219,
          "image": "https://cdn.example.com/offers/5510.png",
          "offername": "Puzzles & Survival",
          "status": "pending"
        }
      ]
    }

Click object

Field	Type	Description
`id`	Integer	Internal click identifier.
`image`	String	Icon of the clicked offer.
`offername`	String	Name of the clicked offer. Note the all-lowercase spelling.
`status`	String	Current state of the click. See below.

Status values

Status	Meaning
`pending`	The click was recorded but no conversion has arrived yet. This is the normal state immediately after a click.
`completed`	The conversion was approved and your postback was fired.
`chargeback`	A previously approved conversion was reversed by the advertiser.

Time window

This endpoint returns clicks from the last 7 days only. Older clicks are omitted even if they are still pending, so do not use it as your system of record. Persist conversions from your postback handler instead.

A click disappearing from this feed does not mean it failed. Never reverse a credit based on a click no longer being listed — reversals arrive explicitly as status=2 postbacks.

Errors

Status	Body	Cause
`400`	`Missing parameters`	App ID or user ID absent from the path.
`404`	`App Not Found`	No placement matches the given app ID.
`403`	`App Not Active`	The placement is not active.