GET /v1/campaigns
Chaque campagne porte ce qui a été demandé et ce qui se passe vraiment : effectiveStatus dit si Meta est en revue, si le budget est épuisé ou si la diffusion tourne.
La requête
curl "https://api-sia54tw5uq-uc.a.run.app/v1/campaigns" \
-H "x-api-key: trp_..."
La réponse
{
"data": [
{
"id": "cmp_4b7e02",
"object": "campaign",
"name": "Mariage - printemps",
"objective": "LEAD_GENERATION",
"status": "ACTIVE",
"effectiveStatus": {
"key": "running",
"reason": null,
"action": null
},
"budget": {
"currency": "EUR",
"amountCents": 45000
},
"destination": "LANDING"
}
],
"nextCursor": null
}
POST /v1/campaigns/cmp_4b7e02/activate
Une transition est une action, jamais un champ à modifier. La réponse dit immédiatement dans quel état réel la campagne se trouve.
La requête
curl -X POST "https://api-sia54tw5uq-uc.a.run.app/v1/campaigns/cmp_4b7e02/activate" \
-H "x-api-key: trp_..."
La réponse
{
"data": {
"id": "cmp_4b7e02",
"object": "campaign",
"status": "ACTIVE",
"effectiveStatus": {
"key": "reviewing",
"reason": null,
"action": null
}
}
}
GET /v1/stats?level=campaign
Dépense Meta, coût net, demandes reçues, impressions et portée, par jour, au niveau du business, de la campagne ou de la publicité.
La requête
curl "https://api-sia54tw5uq-uc.a.run.app/v1/stats?level=campaign" \
-H "x-api-key: trp_..."
La réponse
{
"data": [
{
"id": "cmp_4b7e02",
"dayString": "2026-10-05",
"currency": "EUR",
"metaSpend": 41.2,
"netCost": 48.6,
"forms": 9,
"impressions": 7312,
"linkClicks": 164,
"reach": 5890
}
],
"totals": {
"forms": 9,
"netCost": 48.6
},
"range": {
"level": "campaign",
"sinceDayString": "2026-10-05",
"untilDayString": "2026-10-05",
"ids": [
"cmp_4b7e02"
]
}
}
POST /v1/campaigns/cmp_4b7e02/adGenerations
Le travail est asynchrone : vous recevez un jobId à suivre, et les identifiants des publicités à mesure qu'elles arrivent. L'en-tête Idempotency-Key rend l'appel rejouable sans doublon.
La requête
curl -X POST "https://api-sia54tw5uq-uc.a.run.app/v1/campaigns/cmp_4b7e02/adGenerations" \
-H "x-api-key: trp_..." \
-H "Idempotency-Key: 7f3a-2c91"
La réponse
{
"data": {
"id": "agn_19d4c7",
"object": "ad_generation",
"campaignId": "cmp_4b7e02",
"status": "running",
"outputNumber": 8,
"adIds": [],
"jobId": "job_61ba8f"
}
}
POST /v1/landings/lnd_7c25e1/publish
La page part en ligne à sa propre adresse, prête à recevoir les clics de la campagne.
La requête
curl -X POST "https://api-sia54tw5uq-uc.a.run.app/v1/landings/lnd_7c25e1/publish" \
-H "x-api-key: trp_..."
La réponse
{
"data": {
"id": "lnd_7c25e1",
"object": "landing",
"status": "live",
"url": "https://exemple.fr/mariage-printemps",
"publishedAt": "2026-10-05T11:02:47Z"
}
}
GET /v1/forms?campaignId=cmp_4b7e02
Chaque personne qui a rempli un formulaire, avec sa campagne d'origine. isOrganic distingue celles qui viennent d'un partage hors ciblage.
La requête
curl "https://api-sia54tw5uq-uc.a.run.app/v1/forms?campaignId=cmp_4b7e02" \
-H "x-api-key: trp_..."
La réponse
{
"data": [
{
"id": "frm_8f2c1a",
"object": "form",
"campaignId": "cmp_4b7e02",
"firstName": "Camille",
"lastName": "Rousseau",
"email": "camille@example.fr",
"phoneNumberE164": "+33612345678",
"isOrganic": false,
"createdAt": "2026-10-05T09:14:22Z"
}
],
"nextCursor": null
}
GET /v1/contacts
Le même individu converge sur son identité, quel que soit le nombre de formulaires qu'il a remplis : identityKind dit sur quoi.
La requête
curl "https://api-sia54tw5uq-uc.a.run.app/v1/contacts" \
-H "x-api-key: trp_..."
La réponse
{
"data": [
{
"id": "ctc_2ae910",
"object": "contact",
"firstName": "Camille",
"lastName": "Rousseau",
"emails": [
"camille@example.fr"
],
"campaignIds": [
"cmp_4b7e02"
],
"formIds": [
"frm_8f2c1a"
],
"identityKind": "email",
"lastInteractionAt": "2026-10-05T09:14:22Z"
}
],
"nextCursor": null
}