Οδηγός Taboola API: Backstage Endpoints, Εξουσιοδότηση και Πρακτικές Χρήσεις

Το Taboola API — επίσημα το Backstage API — είναι το REST interface της Taboola για διαφημιστές. Εξουσιοδοτείστε με OAuth 2.0 client credentials και μετά διαβάζετε και γράφετε όλα όσα μπορείτε να αγγίξετε στο Ads Console: καμπάνιες, creative items, targeting, προϋπολογισμούς και αναφορές απόδοσης, όλα κάτω από https://backstage.taboola.com/backstage/api/1.0/{account_id}/…. Είναι το επίπεδο που χρησιμοποιούν οι media buyers για να αυτοματοποιήσουν αλλαγές προσφορών και προϋπολογισμών, bulk-upload δημιουργικών, συγχρονισμό spend σε ένα warehouse και να δημιουργήσουν τους μηχανισμούς κανόνων που το UI της Taboola δεν προσφέρει. Αυτό που σκόπιμα δεν αποκαλύπτει είναι τα δεδομένα οποιουδήποτε άλλου — για την ανταγωνιστική όψη του δικτύου χρειάζεστε ένα εντελώς διαφορετικό API, το οποίο καλύπτουμε στο τέλος.

Τι καλύπτει το Backstage API#

Το Backstage αντιγράφει το console του διαφημιστή σχεδόν ένα προς ένα. Στην πράξη, τέσσερις τομείς κάνουν το μεγαλύτερο μέρος της δουλειάς:

• Διαχείριση καμπανιών. Δημιουργία, ανάγνωση, ενημέρωση και παύση καμπανιών· ορισμός CPCs, ημερήσιων και συνολικών προϋπολογισμών, geo/platform targeting και αποκλεισμούς ιστοτόπων. Οτιδήποτε θα άλλαζετε με το χέρι στις 7 π.μ. μετά τον έλεγχο των νυχτερινών αριθμών μπορεί να γίνει script.
• Items (δημιουργικά). Κάθε καμπάνια περιέχει items — τις μονάδες εικόνας-συν-επικεφαλίδας που πραγματικά εμφανίζονται. Το API σας επιτρέπει να προσθέτετε items σε bulk, να ενημερώνετε την κατάστασή τους και να διαβάζετε την κατάσταση αναθεώρησης ανά item, που είναι ο τρόπος με τον οποίο οι μεγάλοι λογαριασμοί στέλνουν δεκάδες παραλλαγές δημιουργικών χωρίς να αγγίζουν το UI. (Εάν ακόμη ρυθμίζετε τις πρώτες σας καμπάνιες χειροκίνητα, ξεκινήστε με το βήμα-βήμα ρύθμισης καμπάνιας Taboola — το API υποθέτει ότι γνωρίζετε ήδη τις έννοιες του console.)
• Αναφορές. Συγκεντρωτικά endpoints απόδοσης κομμένα κατά διάσταση — ημέρα, καμπάνια, site, χώρα, πλατφόρμα, item — η πρώτη ύλη για οποιονδήποτε αυτοματισμό βελτιστοποίησης.
• Λεξικά. Endpoints αναζήτησης για τις απαριθμήσεις από τις οποίες εξαρτώνται όλα τα άλλα: κωδικοί χωρών, πλατφόρμες, τμήματα κοινού.

Η πρόσβαση έρχεται ως ένα client ID και secret που εκδίδονται για τον λογαριασμό σας — ιστορικά ζητούνταν μέσω του account manager σας στην Taboola — και η επίσημη αναφορά Backstage είναι η πηγή αλήθειας για τα τρέχοντα σχήματα endpoints και διαδικασίες πρόσβασης. Οι διαδρομές endpoints παρακάτω είναι τρέχουσες κατά τη συγγραφή αυτού· επαληθεύστε με την αναφορά πριν δημιουργήσετε.

Εξουσιοδότηση: client credentials σε bearer token#

Το Backstage χρησιμοποιεί την τυπική ροή OAuth 2.0 client-credentials. Ανταλλάξτε το ID και το secret σας για ένα 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"

Η απάντηση περιέχει ένα access_token που στέλνετε ως bearer header σε κάθε κλήση:

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

Αυτή η κλήση allowed-accounts είναι το σωστό πρώτο αίτημα: επιστρέφει τις τιμές account_id (αριθμητικά IDs και αναγνώσιμα ονόματα) που κάθε άλλο endpoint χρειάζεται στη διαδρομή του. Τα tokens λήγουν — κρατήστε ένα στην cache και ανανεώστε σε περίπτωση 401 αντί να δημιουργείτε νέο token ανά αίτημα, τόσο για λανθάνων χρόνος όσο και επειδή τα αιτήματα token περιορίζονται πιο επιθετικά από τα αιτήματα δεδομένων.

Τα endpoints που πραγματικά θα χρησιμοποιήσετε#

Τα endpoints αναφορών παίρνουν παραμέτρους ερωτήματος start_date και end_date συν προαιρετικά φίλτρα και το τμήμα dimension (day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…) αποφασίζει τη φέτα. Το site_breakdown είναι αυτό που έχει τη μεγαλύτερη σημασία για βελτιστοποίηση: είναι η τροφοδοσία απόδοσης ανά publisher που οδηγεί τον αυτοματισμό λιστών αποκλεισμού.

Τι αυτοματοποιούν πραγματικά οι media buyers#

Το API αποδίδει το κόστος ρύθμισής του σε τέσσερις επαναλαμβανόμενες εργασίες:

1. Μηχανισμοί κανόνων. Το κλασικό: κάθε ώρα, τραβήξτε site_breakdown για ενεργές καμπάνιες· οποιοσδήποτε ιστότοπος έχει ξοδέψει περισσότερο από N× target CPA με μηδενικές μετατροπές μπαίνει στη λίστα αποκλεισμένων ιστοτόπων της καμπάνιας μέσω ενημέρωσης καμπάνιας. Αυτός είναι ο ίδιος βρόχος αποκοπής των χαμένων που κάθε σοβαρός διαφημιστής Taboola τρέχει χειροκίνητα — κωδικοποιημένος, απαθής και να τρέχει στις 3 π.μ.
2. Διαχείριση προσφορών. Προσαρμογή CPCs καμπανιών (και των τροποποιητών προσφορών ανά site όπου διατίθενται) προς τα πάνω σε ημέρες και γεωγραφικές περιοχές που ξεπερνούν το target, προς τα κάτω όταν το CPA αποκλίνει — μικρές, συχνές, βαρετές προσαρμογές που συσσωρεύονται.
3. Λειτουργίες bulk δημιουργικών. Μεταφόρτωση 30 παραλλαγών επικεφαλίδας/εικόνας ανά καμπάνια, παύση όλων κάτω από τον μέσο CTR εβδομαδιαία και διατήρηση της περιστροφής δημιουργικών μπροστά από την κόπωση χωρίς ένα απόγευμα κλικ.
4. Αγωγοί spend. Μία νυχτερινή εργασία που τραβάει campaign-summary ανά ημέρα στο warehouse, ώστε τα spend της Taboola να καταλήγουν δίπλα στα έσοδα μετατροπών και κάθε άλλο κανάλι σε ένα dashboard.

Ένα ελάχιστο σχέδιο ενσωμάτωσης#

Εάν ξεκινάτε από το μηδέν, αυτή η ακολουθία σας φέρνει σε χρήσιμο αυτοματισμό σε περίπου μία μέρα εργασίας, με κάθε βήμα επαληθεύσιμο πριν από το επόμενο:

1. Token round-trip. Ανταλλάξτε διαπιστευτήρια για ένα token και καλέστε allowed-accounts. Αν αυτό λειτουργεί, η εξουσιοδότηση και τα δικαιώματα έχουν λυθεί.
2. Αναφορές μόνο για ανάγνωση. Τραβήξτε campaign-summary ανά ημέρα για την τελευταία εβδομάδα και συμφωνήστε τους αριθμούς με το Ads Console. Μην γράψετε τίποτα μέχρι οι αναγνώσεις σας να ταιριάζουν με αυτό που δείχνει το UI.
3. Μία ασφαλής μεταλλαγή. Παύστε και ξαναενεργοποιήστε μία δοκιμαστική καμπάνια μέσω PUT. Επιβεβαιώστε ότι η αλλαγή εμφανίζεται στο console και ότι η κατάσταση εμφάνισης ακολουθεί.
4. Ο νυχτερινός συγχρονισμός spend. Προγραμματίστε το τράβηγμα αναφοράς στη βάση δεδομένων σας. Αυτό από μόνο του δικαιολογεί την ενσωμάτωση για τις περισσότερες ομάδες.
5. Ο μηχανισμός κανόνων, σε dry-run. Υπολογίστε τις αποφάσεις αποκλεισμού ιστοτόπων και καταγράψτε τι θα συνέβαινε για μία εβδομάδα πριν το αφήσετε να γράψει. Η σύγκριση των επιλογών του με αυτές που κάνετε με το χέρι είναι το φθηνότερο QA που θα τρέξετε ποτέ.

Το να πηδήξετε κατευθείαν στο βήμα πέντε είναι το τυπικό λάθος — τα σφάλματα διαδρομής εγγραφής ενάντια σε έναν ζωντανό λογαριασμό διαφημίσεων είναι ακριβά μαθήματα.

Όρια ρυθμού και πρακτικές παγίδες#

• Σεβαστείτε το ανώτατο όριο. Το Backstage επιβάλλει όρια ρυθμού ανά λογαριασμό· ομαδοποιήστε αναγνώσεις (ένα αίτημα αναφοράς ανά καμπάνια ανά ώρα, όχι ένα ανά λεπτό) και υποχωρήστε σε 429s. Ελέγξτε την αναφορά για τρέχοντα όρια αντί να υποθέτετε.

• Οι αναφορές καθυστερούν την εμφάνιση. Τα δεδομένα των πρόσφατων ωρών σταθεροποιούνται με το χρόνο· δημιουργήστε κανόνες με δεδομένα τουλάχιστον λίγων ωρών ή θα παύσετε καμπάνιες σε ελλιπείς αριθμούς.

• Οι επεξεργασίες δεν είναι άμεσες. Οι αλλαγές καμπανιών διαδίδονται στην εμφάνιση με καθυστέρηση και οι επεξεργασίες items μπορούν να επανεκκινήσουν αναθεώρηση. Ο αυτοματισμός πρέπει να ανέχεται το κενό αντί να επαναδίνει "αποτυχημένες" εγγραφές.

• Αποθηκεύστε IDs, όχι ονόματα. Τα ονόματα καμπανιών και items επεξεργάζονται από ανθρώπους· τα αριθμητικά IDs είναι σταθερά κλειδιά σύνδεσης.

• Προστατέψτε τη διαδρομή εγγραφής. Ένας μηχανισμός κανόνων με bug μπορεί να παύσει ολόκληρο το spend ενός λογαριασμού ή να 10×άρει μία προσφορά. Καταγράψτε κάθε μεταλλαγή, προσθέστε όρια λογικής (ποτέ μην αλλάξετε προσφορά περισσότερο από Χ% ανά πέρασμα) και ξεκινήστε οποιονδήποτε νέο κανόνα σε λειτουργία dry-run.

Το άλλο Taboola API: ανταγωνιστικά δεδομένα#

Όλα τα παραπάνω βλέπουν ακριβώς έναν λογαριασμό: τον δικό σας. Το Backstage δεν θα σας πει ποτέ ποιοι διαφημιστές κλιμακώνονται στον τομέα σας, τι δημιουργικά τρέχουν ή πόσο καιρό έχει επιβιώσει η καμπάνια ενός ανταγωνιστή — το δίκτυο δεν δημοσιεύει ad library δικό του και κανένα επίσημο endpoint δεν αποκαλύπτει τη δραστηριότητα άλλων διαφημιστών.

Αυτό είναι το κενό που καλύπτει το developer API του OpenAdLibrary. Ο δείκτης κρατά 206,000+ ενεργά δημιουργικά Taboola (Ιούλιος 2026) μέσα σε ένα corpus 725,000+ native ads σε 49 δίκτυα και τα ίδια δεδομένα πίσω από το Taboola ad library είναι ερωτήσιμα μέσω REST: αναζητήστε δημιουργικά ανά διαφημιστή, τομέα, γεωγραφική περιοχή και διάρκεια ζωής· τραβήξτε επικεφαλίδες και landing pages· παρακολουθήστε πότε οι ανταγωνιστές ξεκινούν και τερματίζουν καμπάνιες. Ο οδηγός native ad data API τεκμηριώνει τα endpoints και εάν η ροή εργασίας σας ζει σε έναν LLM agent υπάρχει ένας MCP server που εκθέτει το ίδιο corpus ως εργαλεία για Claude και ChatGPT. Ένα δωρεάν κλειδί καλύπτει ελαφριά χρήση και οι τιμές παραμένουν σταθερές για τα υπόλοιπα· ο ευρύτερος τομέας της προγραμματιστικής πρόσβασης ad-intel εξετάζεται στα ad spy tools με API.

Τα δύο APIs συνθέτονται φυσικά: Το Backstage αυτοματοποιεί την εκτέλεση στον λογαριασμό σας, το intelligence API αυτοματοποιεί την έρευνα σε όλους τους άλλους. Οι αγοραστές που αξιοποιούν περισσότερο τον αυτοματισμό τρέχουν και τα δύο — ένας μηχανισμός κανόνων που κρατά τις δικές τους καμπάνιες κουρεμένες και μία ανταγωνιστική τροφοδοσία που σηματοδοτεί όταν ένας νέος διαφημιστής αρχίζει να κλιμακώνεται στον τομέα τους, ώστε το επόμενο test να μην επιλέγεται ποτέ τυφλά. Ξεκινήστε με το Taboola spy tool για να δείτε το ανταγωνιστικό corpus σε έναν browser, μετά πάρτε τα ίδια ερωτήματα προγραμματιστικά όταν η ροή εργασίας αποδείξει την αξία της.