Adgora
Desarrolladores

Referencia de API

API REST v1: autenticación, estadísticas, campañas, saldo y zonas, además de postbacks de conversión S2S y macros.

1 min de lectura 207 palabras
Artículos de ayudaReferencia de API

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:

http
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 & pathScopeReturns
GET /v1/balancebalanceadvertiser & publisher USD balances
GET /v1/stats?days=7statsdaily rows (add role=publisher for the publisher view)
GET /v1/campaignscampaignsyour campaigns
POST /v1/campaigns/{id}/pausecampaignspauses a campaign
POST /v1/campaigns/{id}/resumecampaignsresumes a campaign
GET /v1/zoneszonesyour publisher zones

Example

curl
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:

url
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}
Constructor de solicitudes

Construir una solicitud

Elige un endpoint y parámetros — el comando se actualiza a medida que avanzas. Las claves permanecen como marcadores: nunca pegues un secreto en una página web.

Rol
GEThttps://api.adgora.net/v1/balance
curl
curl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"

PUBLICKEY:SECRET es un marcador de posición. Crea una clave en tu perfil y guarda el secreto en tu servidor.

Soporte

¿Aún atascado? Una persona responderá

El servicio de soporte maneja campañas, sitios, depósitos y pagos. Escribe desde el correo electrónico de tu cuenta; para un pago, añade el hash de la transacción — ahorra una ronda de preguntas.

  1. Escribe desde el correo electrónico de tu cuenta
  2. Nombra la campaña, sitio o ID de zona
  3. Para un pago, añade el hash de la transacción
Abre el servicio de soporte [email protected]

Herramientas gratuitas

Calculadoras y verificadores que funcionan en tu navegador — sin cuenta.

Aprender más

Glosario

Definiciones simples de CPM, eCPM, tasa de llenado y el resto.

Aprender más

¿Listo para empezar?

Crea una cuenta gratuita y pon esto en práctica — anunciante, editor, o ambos.

What this page answers