Taboola API-guide: Backstage-endpunkter, autentisering och praktiska användningsområden

Taboolas API — officiellt Backstage API — är Taboolas REST-gränssnitt för annonsörer. Du autentiserar med OAuth 2.0 client credentials, läser och skriver sedan allt du kan komma åt i Ads Console: kampanjer, kreativa objekt, målgruppsanpassning, budgetar och prestationsrapporter, allt under https://backstage.taboola.com/backstage/api/1.0/{account_id}/…. Det är lagret som mediabuyers använder för att automatisera bud- och budgetändringar, bulk-uppladda kreativt material, synka utgifter till ett lager och bygga de regelmotorer som Taboolas UI inte erbjuder. Vad det medvetet inte exponerar är någon annans data — för den konkurrenskraftiga vyn av nätverket behöver du ett helt annat API, som vi täcker i slutet.

Vad Backstage API täcker#

Backstage speglar annonsörskonsolen nästan en-till-en. I praktiken gör fyra områden det mesta av jobbet:

• Kampanjhantering. Skapa, läs, uppdatera och pausa kampanjer; sätt CPC, dagliga och totala budgetar, geo-/plattformsanpassning och webbplatsblockering. Allt du skulle ändra för hand kl 7 på morgonen efter att ha kollat nattens siffror kan bli ett skript istället.
• Objekt (kreativt material). Varje kampanj innehåller objekt — bild-plus-rubrik-enheterna som faktiskt visas. API:et låter dig lägga till objekt i bulk, uppdatera deras status och läsa per-objekt-granskningsstatus, vilket är hur stora konton levererar dussintals kreativa varianter utan att röra UI:t. (Om du fortfarande sätter upp dina första kampanjer manuellt, börja med vår genomgång av Taboola-kampanjinställningar — API:et förutsätter att du redan kan konsolens koncept.)
• Rapportering. Aggregerade prestationsendpunkter uppdelade efter dimension — dag, kampanj, webbplats, land, plattform, objekt — råmaterialet för all automatiserad optimering.
• Ordböcker. Slå-upp-endpunkter för de uppräkningar allt annat bygger på: landskoder, plattformar, målgruppssegment.

Åtkomst ges som ett klient-ID och en hemlighet utfärdad för ditt konto — historiskt sett begärd via din Taboola-kontohanterare — och den officiella Backstage-referensen är sanningens källa för aktuella endpoint-format och åtkomstprocedurer. Endpoint-sökvägar nedan är aktuella vid skrivande stund; verifiera mot referensen innan du bygger.

Autentisering: client credentials till bearer token#

Backstage använder det standardiserade OAuth 2.0 client-credentials-flödet. Byt ut ditt ID och din hemlighet mot en 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 innehåller en access_token som du skickar som en bearer-header på varje anrop:

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

Det allowed-accounts-anropet är rätt första förfrågan: det returnerar account_id-värdena (numeriska ID:n och läsbara namn) som varje annan endpoint behöver i sin sökväg. Tokens löper ut — cacha en och uppdater vid ett 401-fel istället för att generera en ny token per förfrågan, både för latens och för att token-förfrågningar är hastighetsbegränsade mer aggressivt än dataförfrågningar.

De endpunkter du faktiskt kommer att använda#

Rapporteringsendpunkterna tar start_date och end_date som frågeparametrar plus valfria filter, och dimension-segmentet (day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…) bestämmer uppdelningen. site_breakdown är den som spelar störst roll för optimering: det är flödet med prestanda per utgivare som driver block-lista-automatisering.

Vad mediabuyers faktiskt automatiserar#

API:et tjänar in sin installationskostnad i fyra återkommande jobb:

1. Regelmotorer. Den klassiska: varje timme, hämta site_breakdown för aktiva kampanjer; alla webbplatser som har spenderat mer än N× mål-CPA utan konverteringar hamnar på kampanjens blockerade-webbplatser-lista via en kampanjuppdatering. Detta är samma "klipp-förlorarna"-loop som varje seriös Taboola-annonsör kör manuellt — kodifierad, okänslomässig och körs kl 3 på natten.
2. Budhantering. Justera kampanj-CPC:n (och per-webbplats-budmodifierare där tillgängliga) upp på dagar och geografiska områden som slår målet, ner när CPA glider iväg — små, frekventa, tråkiga justeringar som ackumuleras.
3. Bulk-operationer för kreativt material. Ladda upp 30 rubrik-/bildvarianter per kampanj, pausa allt under median-CTR varje vecka och hålla kreativ rotation före utmattning utan en eftermiddag av klickande.
4. Utgifts-pipelines. Ett nattligt jobb som hämtar campaign-summary per dag till lagret, så Taboola-utgifter hamnar bredvid konverteringsintäkter och alla andra kanaler i en dashboard.

En minimal integrationsplan#

Om du börjar från noll får denna sekvens dig till användbar automatisering på ungefär en dags arbete, där varje steg kan verifieras innan nästa:

1. Token-rundtur. Byt ut autentiseringsuppgifter mot en token och anropa allowed-accounts. Om detta fungerar är autentisering och behörigheter löst.
2. Skrivskyddad rapportering. Hämta campaign-summary per dag för den senaste veckan och stäm av siffrorna mot Ads Console. Skriv ingenting förrän dina läsningar matchar vad UI:t visar.
3. En enda säker mutation. Pausa och återuppta en testkampanj via PUT. Bekräfta att ändringen visas i konsolen och att visningstillståndet följer.
4. Den dagliga utgiftssynkningen. Schemalägg rapporthämtningen till din databas. Detta ensamt motiverar integrationen för de flesta team.
5. Regelmotorn, i dry-run. Beräkna webbplatsblockeringsbesluten och logga vad som skulle hända i en vecka innan du låter den skriva. Att jämföra dess val med de du gör för hand är den billigaste QA du någonsin kommer att köra.

Att hoppa direkt till steg fem är det vanliga misstaget — skrivvägsbuggar mot ett levande annonskonto är dyra lärdomar.

Hastighetsbegränsningar och praktiska fallgropar#

• Respektera taket. Backstage tillämpar per-konto-hastighetsbegränsningar; batch-läs (ett rapportanrop per kampanj per timme, inte ett per minut) och backa av vid 429-fel. Kolla referensen för aktuella gränser istället för att anta.
• Rapportering släpar efter visning. Data för senaste timmarna stabiliseras över tid; bygg regler mot data som är minst några timmar gamla annars pausar du kampanjer på ofullständiga siffror.
• Redigeringar är inte omedelbara. Kampanjändringar sprider sig till visning med fördröjning, och objektredigeringar kan utlösa granskning på nytt. Automatisering bör tolerera gapet istället för att utfärda "misslyckade" skrivningar på nytt.
• Lagra ID:n, inte namn. Kampanj- och objektnamn redigeras av människor; numeriska ID:n är stabila nycklar för sammanfogning.
• Skydda skrivvägen. En regelmotor med en bugg kan pausa ett kontos hela utgifter eller 10× ett bud. Logga varje mutation, lägg till förnuftsgränser (ändra aldrig ett bud mer än X% per pass), och starta alla nya regler i dry-run-läge.

Det andra Taboola-API:et: konkurrenskraftig data#

Allt ovan ser exakt ett konto: ditt. Backstage kommer aldrig att berätta vilka annonsörer som skalar i din bransch, vilket kreativt material de kör eller hur länge en konkurrents kampanj har överlevt — nätverket publicerar inget eget annonsbibliotek, och ingen officiell endpoint exponerar andra annonsörers aktivitet.

Det är gapet som OpenAdLibrarys utvecklar-API täcker. Indexet innehåller 206 000+ levande Taboola-kreativ (juli 2026) inom ett korpus på 725 000+ native-annonser över 49 nätverk, och samma data bakom Taboolas annonsbibliotek är sökbart via REST: sök kreativ efter annonsör, bransch, geo och livslängd; hämta rubriker och landningssidor; spåra när konkurrenter lanserar och avslutar kampanjer. Guiden för native-annonsdata-API dokumenterar endpunkterna, och om ditt arbetsflöde finns i en LLM-agent finns det en MCP-server som exponerar samma korpus som verktyg för Claude och ChatGPT. En gratis nyckel täcker lätt användning och prissättningen förblir fast för resten; den bredare landskapen för programmatisk annons-intelligensåtkomst undersöks i annonsspionverktyg med ett API.

De två API:na komponeras naturligt: Backstage automatiserar exekvering på ditt konto, intelligens-API:et automatiserar research på alla andras. De köpare som får ut mest av automatisering kör båda — en regelmotor som håller sina egna kampanjer trimmade, och ett konkurrenskraftigt flöde som flaggar när en ny annonsör börjar skala i deras bransch så nästa test aldrig väljs blint. Börja med Taboola-spionverktyget för att se det konkurrenskraftiga korpuset i en webbläsare, ta sedan samma frågor programmatiskt när arbetsflödet bevisar sig.