Articles d'aideRéférence API
Commencez ici
CommencerFAQPlans et tarifs
Tarification & plansAnnonceurs
Exécution de campagnesÉditeurs
Ajouter un site et un tag publicitaireArgent
Dépôts et paiementsCompte
Sécurité du compteDéveloppeurs
Référence APILégal
Conditions d'utilisationPolitique de confidentialité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
| Method & path | Scope | Returns |
|---|---|---|
GET /v1/balance | balance | advertiser & publisher USD balances |
GET /v1/stats?days=7 | stats | daily rows (add role=publisher for the publisher view) |
GET /v1/campaigns | campaigns | your campaigns |
POST /v1/campaigns/{id}/pause | campaigns | pauses a campaign |
POST /v1/campaigns/{id}/resume | campaigns | resumes a campaign |
GET /v1/zones | zones | your publisher zones |
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=ORDER123status 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}Construire une demande
Choisissez un point de terminaison et des paramètres — la commande se met à jour au fur et à mesure. Les clés restent des espaces réservés : ne collez jamais un secret dans une page web.
https://api.adgora.net/v1/balancecurl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"PUBLICKEY:SECRET est un espace réservé. Créez une clé dans votre profil et gardez le secret sur votre serveur.
