Artigos de ajudaReferência da API
Comece aqui
ComeçandoFAQPlanos e preços
Preços e planosAnunciantes
Executando campanhasEditores
Adicionar um site e tag de anúncioDinheiro
Depósitos e pagamentosConta
Segurança da contaDesenvolvedores
Referência da APILegal
Termos de ServiçoPolítica de PrivacidadeThe 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}Construa uma solicitação
Escolha um endpoint e parâmetros — o comando é atualizado conforme você avança. As chaves permanecem como marcadores: nunca cole um segredo em uma página da web.
https://api.adgora.net/v1/balancecurl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"PUBLICKEY:SECRET é um espaço reservado. Crie uma chave no seu perfil e mantenha o segredo no seu servidor.
