Ads Manager
API REST
Planifiez, lancez et suivez vos campagnes depuis vos propres outils. L’API utilise les mêmes droits que la personne qui a créé la clé, et chaque appel est inscrit au journal avec la source API.
EndpointCe qu’il fait
POST /v1/forecastsÉcrans, diffusions et impressions d’un plan, avant de payerPOST /v1/campaignsCrée une campagne à partir d’une prévision, en brouillon ou pour validationGET /v1/campaigns/{id}Statut, budget, rythme de diffusion et périodeGET /v1/campaigns/{id}/resultsImpressions, diffusions, scans et dépenses par jour, heure et écranPOST /v1/creativesEnvoie une image fixe ou une vidéo de 20 secondes maximum et lance les vérifications techniquesGET /v1/screensÉcrans d’une zone, avec type de lieu et horaires d’ouverturecurl https://api.hub.verse.ad/v1/forecasts \
-H "Authorization: Bearer $VERSE_KEY" \
-H "Content-Type: application/json" \
-d '{
"areas": [{ "lat": 53.7997, "lng": -1.5492, "radiusKm": 3 }],
"venueTypes": ["cafes", "gyms", "coworking"],
"hours": { "days": ["mon","tue","wed","thu","fri"], "from": "07:00", "to": "19:00" },
"budget": 300,
"currency": "USD"
}'const res = await fetch("https://api.hub.verse.ad/v1/forecasts", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.VERSE_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
areas: [{ lat: 53.7997, lng: -1.5492, radiusKm: 3 }],
venueTypes: ["cafes", "gyms", "coworking"],
budget: 300,
currency: "USD"
})
});
const forecast = await res.json();
console.log(forecast.screens, forecast.impressions);import os, requests
r = requests.post(
"https://api.hub.verse.ad/v1/forecasts",
headers={"Authorization": f"Bearer {os.environ['VERSE_KEY']}"},
json={
"areas": [{"lat": 53.7997, "lng": -1.5492, "radiusKm": 3}],
"venueTypes": ["cafes", "gyms", "coworking"],
"budget": 300,
"currency": "USD",
},
)
print(r.json()["screens"], r.json()["impressions"])Exemples à titre indicatif.
- Créez vos clés dans Ads Manager › Paramètres › Clés API. Chaque clé est limitée à un espace de travail.
- Limite : 600 requêtes par minute et par clé. Les réponses incluent X-RateLimit-Remaining.
- Les montants sont en unités mineures uniquement quand le nom du champ se termine par Minor ; partout ailleurs, c’est un nombre décimal dans la devise de la campagne.