User Based API (v1)

Use Case

Our User Based API allows you to display offers compatible with virtual currency applications and display them natively on your website or app. This API allows you to recreate the functionality of the AdGate Rewards offer wall within your own application.

With this API you can:

• Return a list of optimized offers for a specific user based on their geolocation, device, and user history.

• See and display a user's offer interaction history.

Endpoints should be called in real-time whenever you would like your users to see offers. Results should not be cached as they are constantly changing. Calls to the endpoints should be made from the server-side, not the client-side.

Endpoints

The following endpoints are available:

• Get Offers

• Post Devices

• Get History

• Get Offer History

Each endpoint accepts parameters passed in the query, e.g.:

https://api.adgatemedia.com/v1/user-based-api/history?aff_id=60000&api_key=abcdef&wall_code=nQ&user_id=user12345

Some endpoints may require extra data provided in a JSON body.

All endpoints return a JSON response.

Authentication

Each endpoint requires these two parameters:

Parameter	Description	Type	Example
aff_id	Your affiliate ID. Can be found on the Offers API page.	Any Integer	60000
api_key	Your API key. Can be found on the Offers API page.	Any String	941bd1fecf7e6596823b895e04df3a0c