Taboola API-guide: Backstage-endepunkter, godkendelse og praktiske anvendelser

Taboola API — officielt Backstage API — er Taboolas REST-grænseflade for annoncører. Du godkender med OAuth 2.0 client credentials, læser og skriver derefter alt du kan røre i Ads Console: kampagner, kreative elementer, targeting, budgetter og performance-rapporter, alt under https://backstage.taboola.com/backstage/api/1.0/{account_id}/…. Det er laget mediekøbere bruger til at automatisere bud- og budgetændringer, bulk-upload af kreativer, synkronisere forbrug til et warehouse og bygge de regelmotorer som Taboolas UI ikke tilbyder. Hvad den bevidst ikke eksponerer, er andres data — for det konkurrenceorienterede netværkssyn har du brug for et helt andet API, som vi dækker til sidst.

Hvad Backstage API dækker#

Backstage spejler annoncørkonsollen næsten en-til-en. I praksis udfører fire områder det meste af arbejdet:

• Kampagnestyring. Opret, læs, opdater og pause kampagner; indstil CPC'er, daglige og samlede budgetter, geo/platform-targeting og sideblokering. Alt du ville ændre manuelt kl. 7 om morgenen efter at have tjekket natten tal, kan være et script i stedet.
• Elementer (kreativer). Hver kampagne indeholder elementer — billede-plus-overskrift-enhederne der faktisk vises. API'en lader dig tilføje elementer i bulk, opdatere deres status og læse per-element gennemsynstilstand, hvilket er hvordan store konti udruller dusinvis af kreative varianter uden at røre UI'et. (Hvis du stadig opsætter dine første kampagner manuelt, start med vores Taboola kampagneopsætningsgennemgang — API'en forudsætter du allerede kender konsollens koncepter.)
• Rapportering. Aggregerede performance-endepunkter opdelt efter dimension — dag, kampagne, site, land, platform, element — råmaterialet til enhver automatiseret optimering.
• Ordbøger. Opslag-endepunkter for de opsummeringer alt andet afhænger af: landekoder, platforme, målgruppesegmenter.

Adgang kommer som en klient-ID og en hemmelighed udstedt til din konto — historisk anmodet gennem din Taboola-kontomanager — og den officielle Backstage-reference er sandhedskilden for aktuelle endepunktsformer og adgangsprocedurer. Endepunktsstier nedenfor er aktuelle på skrivningstidspunktet; verificer mod referencen før du bygger.

Godkendelse: client credentials til bearer token#

Backstage bruger det standard OAuth 2.0 client-credentials-flow. Byt din ID og hemmelighed ud med 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 indeholder et access_token du sender som en bearer-header på hvert kald:

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

Det allowed-accounts-kald er det rigtige første anmodning: det returnerer account_id-værdierne (numeriske ID'er og læsbare navne) som hvert andet endepunkt har brug for i sin sti. Tokens udløber — cache et og opdater ved en 401 i stedet for at generere et nyt token per anmodning, både for latenstid og fordi token-anmodninger er ratebegrænset mere aggressivt end dataanmodninger.

De endepunkter du faktisk vil bruge#

Rapporteringsendepunkterne tager start_date og end_date forespørgselsparametre plus valgfrie filtre, og dimension-segmentet (day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…) bestemmer opdelingen. site_breakdown er den der betyder mest for optimering: det er den per-udgiver performance-feed der driver blokeringsliste-automation.

Hvad mediekøbere faktisk automatiserer#

API'en tjener sine opsætningsomkostninger ind i fire tilbagevendende jobs:

1. Regelmotorer. Den klassiske: hver time, hent site_breakdown for aktive kampagner; ethvert site der har brugt mere end N× mål-CPA med nul konverteringer kommer på kampagnens blokerede-sites-liste via en kampagneopdatering. Dette er den samme 'skær taberne fra'-løkke enhver seriøs Taboola-annoncør kører manuelt — indkodet, ufølsom og kørende kl. 3 om natten.
2. Budstyring. Justering af kampagne-CPC'er (og per-site budmodifikatorer hvor tilgængeligt) op på dage og geografier der slår målet, ned når CPA glider — små, hyppige, kedelige justeringer der akkumulerer.
3. Bulk kreative operationer. Upload af 30 overskrift/billede-varianter per kampagne, pause på alt under median-CTR ugentligt, og hold kreativ rotation foran udmattelse uden en eftermiddags klikkeri.
4. Forbrugspipeliner. Et natligt job der henter campaign-summary per dag ind i warehouse'et, så Taboola-forbrug lander ved siden af konverteringsindtægter og alle andre kanaler i ét dashboard.

En minimal integrationsplan#

Hvis du starter fra nul, får denne sekvens dig til brugbar automation på omtrent en dags arbejde, hvor hvert trin kan verificeres før det næste:

1. Token round-trip. Byt legitimationsoplysninger ud med et token og kald allowed-accounts. Hvis dette virker, er godkendelse og tilladelser løst.
2. Skrivebeskyttet rapportering. Hent campaign-summary per dag for den sidste uge og afstem tallene mod Ads Console. Skriv ikke noget før dine læsninger matcher hvad UI'et viser.
3. En enkelt sikker mutation. Pause og genoptag én testkampagne via PUT. Bekræft at ændringen vises i konsollen og at visningstilstanden følger.
4. Den natlige forbrugssynkronisering. Planlæg rapporthentningen i din database. Dette alene retfærdiggører integrationen for de fleste teams.
5. Regelmotoren, i tørkørsel. Beregn sideblokeringsbeslutningerne og log hvad der ville ske i en uge før du lader den skrive. At sammenligne dens valg med dem du tager manuelt er den billigste QA du nogensinde vil køre.

At springe direkte til trin fem er den standardfejl — skrivesti-fejl mod en live annoncekonto er dyre lærepenge.

Ratebegrænsninger og praktiske faldgruber#

• Respekter loftet. Backstage håndhæver per-konto ratebegrænsninger; batch-læsninger (et rapportkald per kampagne per time, ikke et per minut) og back off ved 429'er. Tjek referencen for aktuelle grænser i stedet for at antage.
• Rapportering hænger efter visning. Data for de seneste timer stabiliseres over tid; byg regler mod data mindst et par timer gamle, ellers pauser du kampagner på ufuldstændige tal.
• Redigeringer er ikke øjeblikkelige. Kampagneændringer udbredes til visning med forsinkelse, og elementredigeringer kan genudløse gennemsyn. Automation bør tåle hullet i stedet for at re-udstede "fejlede" skriv.
• Gem ID'er, ikke navne. Kampagne- og elementnavne redigeres af mennesker; numeriske ID'er er stabile join-nøgler.
• Beskyt skrivestien. En regelmotor med en fejl kan pause en kontos hele forbrug eller 10× et bud. Log hver mutation, tilføj fornuftsgrænser (ændr aldrig et bud mere end X% per gennemløb), og start enhver ny regel i tørkørsels-tilstand.

Det andet Taboola API: konkurrencedata#

Alt ovenfor ser præcis én konto: din. Backstage vil aldrig fortælle dig hvilke annoncører der skalerer i din branche, hvilke kreativer de kører, eller hvor længe en konkurrents kampagne har overlevet — netværket udgiver intet eget annoncebibliotek, og intet officielt endepunkt eksponerer andre annoncørers aktivitet.

Det er hullet som OpenAdLibrary's udvikler-API dækker. Indekset indeholder 206.000+ live Taboola-kreativer (juli 2026) inden for et korpus på 725.000+ native annoncer på tværs af 49 netværk, og de samme data bag Taboola annoncebiblioteket kan forespørges via REST: søg kreativer efter annoncør, branche, geo og levetid; hent overskrifter og landingssider; spør når konkurrenter lancerer og afslutter kampagner. Native annoncedata API-guiden dokumenterer endepunkterne, og hvis din arbejdsgang lever i en LLM-agent er der en MCP-server der eksponerer det samme korpus som værktøjer til Claude og ChatGPT. En gratis nøgle dækker let brug og priser forbliver flade for resten; det bredere landskab af programmatisk annonce-intel-adgang undersøges i ad spy værktøjer med en API.

De to API'er komponerer naturligt: Backstage automatiserer eksekvering på din konto, intelligens-API'en automatiserer research på alle andres. De købere der får mest ud af automation kører begge — en regelmotor der holder deres egne kampagner beskåret, og en konkurrence-feed der flagger når en ny annoncør begynder at skalerer i deres branche, så næste test aldrig vælges blindt. Start med Taboola spy værktøjet for at se konkurrencekorpusset i en browser, og tag derefter de samme forespørgsler programmatisk når arbejdsgangen er bevist.