Articoli di aiutoRiferimento API
Inizia qui
IniziareFAQPiani e prezzi
Prezzi e pianiInserzionisti
Gestire campagneEditor
Aggiungi un sito e un tag pubblicitarioDenaro
Depositi e pagamentiAccount
Sicurezza dell'accountSviluppatori
Riferimento APILegale
Termini di ServizioInformativa sulla privacyThe 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}Crea una richiesta
Scegli un endpoint e parametri — il comando si aggiorna mentre procedi. Le chiavi rimangono segnaposto: non incollare mai un segreto in una pagina web.
https://api.adgora.net/v1/balancecurl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"PUBLICKEY:SECRET è un segnaposto. Crea una chiave nel tuo profilo e conserva il segreto sul tuo server.
