API reference

The Adgora REST API lets you read stats, list and pause campaigns, check balances and list zones programmatically. Base URL: https://api.adgora.net. All responses are JSON.

Authentication

Create a key pair in your profile (the secret is shown once). Send it on every /v1 request:

Authorization: Bearer {public_key}:{secret}

Requests are rate-limited to 120 per minute per account; over the limit returns 429 with a Retry-After header. Keys carry scopes (stats, campaigns, balance, zones); a missing scope returns 403.

Endpoints

Example

curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
  "https://api.adgora.net/v1/stats?days=30"

S2S conversion postback

To track CPA conversions, call the postback URL from your advertiser's server when a conversion happens. The {clickid} macro is passed to your landing page on the click URL — capture it and send it back:

https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123

status may be confirmed, delivered, rejected or returned; order_ref is your optional order id. Find the offer secret on the offer page.

Landing URL macros

Add these to a creative's landing URL — Adgora substitutes them at click time:

{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}