Taboola API-guide: Backstage-endepunkter, autentisering og praktiske bruksområder

Taboola API – offisielt Backstage API – er Taboolas REST-grensesnitt for annonsører. Du autentiserer deg med OAuth 2.0 client credentials, deretter leser og skriver du alt du kan berøre i Ads Console: kampanjer, kreative elementer, målgrupper, budsjetter og ytelsesrapporter, alt under https://backstage.taboola.com/backstage/api/1.0/{account_id}/…. Det er laget mediekjøpere bruker for å automatisere bud- og budsjettendringer, laste opp kreativer i bulk, synkronisere budsjett til et lager, og bygge regelmotorer som Taboolas grensesnitt ikke tilbyr. Det den bevisst ikke eksponerer er andres data – for det konkurranseanalysesynet av nettverket trenger du et helt annet API, som vi dekker på slutten.

Hva Backstage API dekker#

Backstage speiler annonsørkonsollen nesten en-til-en. I praksis gjør fire områder det meste av jobben:

• Kampanjestyring. Opprett, les, oppdater og sett kampanjer på pause; sett CPC, daglige og totale budsjetter, geo-/plattform-målgrupper og nettstedsblokkering. Alt du ville endret for hånd klokken 7 om morgenen etter å ha sjekket nattens tall, kan bli et skript i stedet.
• Elementer (kreativer). Hver kampanje inneholder elementer – bilde-pluss-overskrift-enhetene som faktisk vises. API-en lar deg legge til elementer i bulk, oppdatere deres status, og lese per-element-godkjenningsstatus, som er hvordan store kontoer sender dusinvis av kreative varianter uten å berøre grensesnittet. (Hvis du fortsatt setter opp dine første kampanjer manuelt, start med vår Taboola kampanjeoppsett-guide – API-en forutsetter at du allerede kjenner konsollens konsepter.)
• Rapportering. Aggregerte ytelsesendepunkter delt opp etter dimensjon – dag, kampanje, nettsted, land, plattform, element – råmaterialet for enhver automatisert optimalisering.
• Ordbøker. Oppslagssendepunkter for oppramsingene alt annet avhenger av: landskoder, plattformer, målgruppesegmenter.

Tilgang kommer som en klient-ID og hemmelighet utstedt for kontoen din – historisk forespurt gjennom din Taboola-kontohåndterer – og den offisielle Backstage-referansen er sannhetskilden for nåværende endepunktformer og tilgangsprosedyrer. Endepunktstiene nedenfor er gjeldende per skrivende stund; verifiser mot referansen før du bygger.

Autentisering: client credentials til bearer token#

Backstage bruker standard OAuth 2.0 client-credentials-flyten. Bytt ID-en og hemmeligheten din mot et token:

curl -X POST "https://backstage.taboola.com/backstage/oauth/token" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "grant_type=client_credentials"

Svaret inneholder en access_token du sender som en bearer-header på hvert kall:

curl "https://backstage.taboola.com/backstage/api/1.0/users/current/allowed-accounts" \
  -H "Authorization: Bearer YOUR_TOKEN"

Det allowed-accounts-kallet er det riktige første forespørselen: det returnerer account_id-verdiene (numeriske ID-er og lesbare navn) som alle andre endepunkter trenger i stien sin. Token utløper – mellomlagre ett og forny ved en 401 i stedet for å generere et nytt token per forespørsel, både for latens og fordi token-forespørsler er hastighetsbegrenset mer aggressivt enn dataforespørsler.

Endepunktene du faktisk vil bruke#

Rapporteringsendepunktene tar start_date og end_date spørreparametere pluss valgfrie filtre, og dimension-segmentet (day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…) bestemmer oppdelingen. site_breakdown er den som betyr mest for optimalisering: det er ytelsesstrømmen per utgiver som driver blokkeringsliste-automatisering.

Hva mediekjøpere faktisk automatiserer#

API-en tjener inn oppsettskostnaden sin i fire gjentakende jobber:

1. Regelmotorer. Den klassiske: hver time, hent site_breakdown for aktive kampanjer; ethvert nettsted som har brukt mer enn N× mål-CPA med null konverteringer havner på kampanjens blokkerte-nettsteder-liste via en kampanjeoppdatering. Dette er den samme «kutt-taperne»-løkken enhver seriøs Taboola-annonsør kjører manuelt – kodet, ufølsom, og kjører klokken 3 om natten.
2. Budstyring. Justere kampanje-CPC-er (og per-nettsted budmodifikatorer der tilgjengelig) opp på dager og geografier som slår målet, ned når CPA avviker – små, hyppige, kjedelige justeringer som akkumuleres.
3. Bulk-operasjoner på kreativer. Laste opp 30 overskrift/bilde-varianter per kampanje, sette alt under median-CTR-en på pause ukentlig, og holde kreativ rotasjon foran utmattelse uten en ettermiddag med klikking.
4. Budsjett-pipelines. En nattlig jobb som henter campaign-summary per dag inn i lageret, slik at Taboola-budsjett lander ved siden av konverteringsinntekter og alle andre kanaler i ett dashbord.

En minimal integrasjonsplan#

Hvis du starter fra null, får denne sekvensen deg til nyttig automatisering på omtrent en dags arbeid, med hvert trinn verifiserbart før det neste:

1. Token rundtur. Bytt legitimasjon mot et token og kall allowed-accounts. Hvis dette fungerer, er autentisering og tillatelser løst.

2. Skrivebeskyttet rapportering. Hent campaign-summary per dag for den siste uken og avstem tallene mot Ads Console. Ikke skriv noe før lesningene dine stemmer med det grensesnittet viser.

3. En enkelt trygg mutasjon. Sett en testkampanje på pause og ta den av pause via PUT. Bekreft at endringen vises i konsollen og at visningstilstanden følger.

4. Den nattlige budsjettsynkroniseringen. Planlegg rapporteringshentingen inn i databasen din. Dette alene rettferdiggjør integrasjonen for de fleste team.

5. Regelmotoren, i tørrkjøring. Beregn nettstedsblokkeringsbeslutningene og logg hva som ville skje i en uke før du lar den skrive. Å sammenligne dens valg med de du tar for hånd er den billigste QA-en du noen gang vil kjøre.

Å hoppe rett til trinn fem er den vanlige feilen – skrivesti-feil mot en levende annonsekonto er dyre lærdommer.

Hastighetsbegrensninger og praktiske fallgruver#

• Respekter taket. Backstage håndhever per-konto-hastighetsbegrensninger; batch-les (ett rapportkall per kampanje per time, ikke ett per minutt) og trapp ned ved 429-svar. Sjekk referansen for nåværende grenser i stedet for å anta.
• Rapportering henger etter visning. Data for nylige timer stabiliseres over tid; bygg regler mot data som minst er noen timer gamle, ellers setter du kampanjer på pause på ufullstendige tall.
• Redigeringer er ikke øyeblikkelige. Kampanjeendringer sprer seg til visning med forsinkelse, og elementredigeringer kan utløse ny gjennomgang. Automatisering bør tåle gapet i stedet for å re-utstede «feilede» skrivinger.
• Lagre ID-er, ikke navn. Kampanje- og elementnavn redigeres av mennesker; numeriske ID-er er stabile nøkler for sammenkobling.
• Beskytte skrivestien. En regelmotor med en feil kan sette en kontos hele budsjett på pause eller 10× et bud. Logg hver mutasjon, legg til sunnhetsgrenser (endre aldri et bud mer enn X% per gjennomgang), og start enhver ny regel i tørrkjøringsmodus.

Det andre Taboola API-et: konkurranseanalysedata#

Alt ovenfor ser nøyaktig én konto: din. Backstage vil aldri fortelle deg hvilke annonsører som skalerer i din bransje, hvilke kreativer de kjører, eller hvor lenge en konkurrents kampanje har overlevd – nettverket publiserer intet eget annonsebibliotek, og intet offisielt endepunkt eksponerer andre annonsørers aktivitet.

Det er gapet OpenAdLibrarys utvikler-API dekker. Indeksen holder 206 000+ levende Taboola-kreativer (juli 2026) innenfor et korpus på 725 000+ native annonser på tvers av 49 nettverk, og de samme dataene bak Taboola annonsebiblioteket er søkbare over REST: søk kreativer etter annonsør, bransje, geo og levetid; hent overskrifter og landingssider; spor når konkurrenter lanserer og avslutter kampanjer. Guiden for native annonsedata-API dokumenterer endepunktene, og hvis arbeidsflyten din lever i en LLM-agent er det en MCP-server som eksponerer det samme korpuset som verktøy for Claude og ChatGPT. En gratis nøkkel dekker lett bruk og priser forblir flate for resten; det bredere landskapet for programmatisk annonseanalyse-tilgang er kartlagt i annonsespionasjeverktøy med API.

De to API-ene komponerer naturlig: Backstage automatiserer gjennomføring på din konto, etterretnings-API-et automatiserer forskning på alle andres. Kjøperne som får mest ut av automatisering kjører begge – en regelmotor som holder sine egne kampanjer beskjåret, og en konkurransestrøm som flagger når en ny annonsør begynner å skalerer i deres bransje, slik at neste test aldri velges blindt. Start med Taboola-spionasjeverktøyet for å se konkurransekorpuset i en nettleser, og ta deretter de samme spørringene programmatisk når arbeidsflyten viser seg å fungere.