Taboola API गाइड: बैकस्टेज एंडपॉइंट्स, ऑथेंटिकेशन और वास्तविक उपयोग

Taboola का बैकस्टेज API आपके अपने खाते में सब कुछ स्वचालित करता है — कैंपेन, क्रिएटिव्स, रिपोर्ट्स। यहाँ है ऑथ फ्लो, महत्वपूर्ण एंडपॉइंट्स, खरीदार वास्तव में क्या ऑटोमेट करते हैं, और वह प्रतिस्पर्धी डेटा कहाँ से प्राप्त करें जो बैकस्टेज आपको कभी नहीं दिखाएगा।

OpenAdLibrary टीमविज्ञापन इंटेलिजेंस और नेटिव विज्ञापन अनुसंधान

21 अगस्त 2026 · 6 मिनट पढ़ने का समय

संपादकीय चित्रण: Taboola API गाइड: बैकस्टेज एंडपॉइंट्स, ऑथ और वास्तविक उपयोग

Taboola API — आधिकारिक तौर पर बैकस्टेज API — विज्ञापनदाताओं के लिए Taboola का REST इंटरफ़ेस है। आप OAuth 2.0 क्लाइंट क्रेडेंशियल्स के साथ प्रमाणित होते हैं, फिर Ads Console में आप जो कुछ भी छू सकते हैं उसे पढ़ और लिख सकते हैं: कैंपेन, क्रिएटिव आइटम, टार्गेटिंग, बजट और परफॉर्मेंस रिपोर्ट्स, सभी https://backstage.taboola.com/backstage/api/1.0/{account_id}/… के अंतर्गत। यह वह परत है जिसका उपयोग मीडिया खरीदार बिड और बजट परिवर्तनों को स्वचालित करने, क्रिएटिव्स को बल्क-अपलोड करने, खर्च को वेयरहाउस में सिंक करने और उन नियम इंजनों को बनाने के लिए करते हैं जो Taboola का UI प्रदान नहीं करता है। जो चीज़ यह जानबूझकर एक्सपोज़ नहीं करती है वह है किसी और का डेटा — नेटवर्क के प्रतिस्पर्धी दृश्य के लिए आपको पूरी तरह से एक अलग API की आवश्यकता होती है, जिसे हम अंत में कवर करते हैं।

बैकस्टेज API क्या कवर करता है#

बैकस्टेज एडवरटाइज़र कंसोल को लगभग एक-से-एक दर्पण करता है। व्यवहार में, चार क्षेत्र अधिकांश काम करते हैं:

कैंपेन प्रबंधन। कैंपेन बनाएं, पढ़ें, अपडेट करें और पॉज़ करें; CPCs, दैनिक और कुल बजट, जियो/प्लेटफ़ॉर्म टार्गेटिंग और साइट ब्लॉकिंग सेट करें। रात भर के नंबर चेक करने के बाद सुबह 7 बजे हाथ से जो कुछ भी बदलेंगे, वह एक स्क्रिप्ट हो सकता है।
आइटम (क्रिएटिव्स)। प्रत्येक कैंपेन में आइटम होते हैं — वे इमेज-प्लस-हेडलाइन यूनिट जो वास्तव में सर्व करती हैं। API आपको बल्क में आइटम जोड़ने, उनकी स्थिति अपडेट करने और प्रति-आइटम रिव्यू स्टेट पढ़ने देता है, जिससे बड़े खाते UI को छुए बिना दर्जनों क्रिएटिव वेरिएंट शिप करते हैं। (यदि आप अभी भी अपने पहले कैंपेन मैन्युअली सेट अप कर रहे हैं, तो हमारे Taboola कैंपेन सेटअप वॉकथ्रू से शुरुआत करें — API मानता है कि आप पहले से ही कंसोल की अवधारणाओं को जानते हैं।)
रिपोर्टिंग। आयामों द्वारा विभाजित एकत्रित प्रदर्शन एंडपॉइंट्स — दिन, कैंपेन, साइट, देश, प्लेटफ़ॉर्म, आइटम — किसी भी स्वचालित ऑप्टिमाइज़ेशन के लिए कच्चा माल।
शब्दकोश। उन एन्यूमरेशन के लिए लुकअप एंडपॉइंट्स जिन पर बाकी सब निर्भर करता है: देश कोड, प्लेटफ़ॉर्म, ऑडियंस सेगमेंट।

एक्सेस एक क्लाइंट ID और सीक्रेट के रूप में आता है जो आपके खाते के लिए जारी किया जाता है — ऐतिहासिक रूप से आपके Taboola अकाउंट मैनेजर के माध्यम से अनुरोध किया गया — और आधिकारिक बैकस्टेज संदर्भ वर्तमान एंडपॉइंट आकार और एक्सेस प्रक्रियाओं का स्रोत सत्य है। नीचे दिए गए एंडपॉइंट पथ इस लेखन के समय वर्तमान हैं; निर्माण से पहले संदर्भ के विरुद्ध सत्यापित करें।

प्रमाणीकरण: क्लाइंट क्रेडेंशियल्स से बेयरर टोकन#

बैकस्टेज मानक OAuth 2.0 क्लाइंट-क्रेडेंशियल्स फ्लो का उपयोग करता है। अपने ID और सीक्रेट को टोकन के लिए एक्सचेंज करें:

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 होता है जिसे आप हर कॉल पर बेयरर हैडर के रूप में भेजते हैं:

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

वह allowed-accounts कॉल सही पहला अनुरोध है: यह account_id वैल्यूज़ (संख्यात्मक ID और पठनीय नाम) लौटाता है जिनकी आवश्यकता हर दूसरे एंडपॉइंट को अपने पथ में होती है। टोकन समाप्त हो जाते हैं — एक को कैश करें और 401 पर रिफ्रेश करें, प्रति अनुरोध एक ताज़ा टोकन जनरेट करने के बजाय, दोनों लेटेंसी के लिए और क्योंकि टोकन अनुरोधों पर डेटा अनुरोधों की तुलना में अधिक आक्रामक रूप से रेट-लिमिट किया जाता है।

वे एंडपॉइंट जिनका आप वास्तव में उपयोग करेंगे#

कार्य	विधि और पथ (`/backstage/api/1.0/` के अंतर्गत)
अपने खातों की सूची बनाएं	`GET users/current/allowed-accounts`
कैंपेन की सूची बनाएं	`GET {account_id}/campaigns`
एक कैंपेन बनाएं	`POST {account_id}/campaigns`
बजट/CPC/स्थिति अपडेट करें	`PUT {account_id}/campaigns/{campaign_id}`
एक कैंपेन के क्रिएटिव्स की सूची बनाएं	`GET {account_id}/campaigns/{campaign_id}/items`
एक क्रिएटिव जोड़ें	`POST {account_id}/campaigns/{campaign_id}/items`
आयाम द्वारा प्रदर्शन	`GET {account_id}/reports/campaign-summary/dimensions/{dimension}`
प्रति-क्रिएटिव प्रदर्शन	`GET {account_id}/reports/top-campaign-content/dimensions/item_breakdown`

रिपोर्टिंग एंडपॉइंट start_date और end_date क्वेरी पैरामीटर प्लस वैकल्पिक फ़िल्टर लेते हैं, और dimension सेगमेंट (day, campaign_breakdown, site_breakdown, country_breakdown, platform_breakdown…) स्लाइस तय करता है। site_breakdown वह है जो ऑप्टिमाइज़ेशन के लिए सबसे अधिक मायने रखता है: यह प्रति-पब्लिशर प्रदर्शन फ़ीड है जो ब्लॉक-लिस्ट ऑटोमेशन को चलाती है।

मीडिया खरीदार वास्तव में क्या ऑटोमेट करते हैं#

API अपनी सेटअप लागत चार आवर्ती कार्यों में अर्जित करता है:

नियम इंजन। क्लासिक: हर घंटे, सक्रिय कैंपेन के लिए site_breakdown खींचें; कोई भी साइट जिसने शून्य कन्वर्ज़न के साथ टार्गेट CPA के N× से अधिक खर्च किया है, कैंपेन अपडेट के माध्यम से कैंपेन की ब्लॉक्ड-साइट्स सूची में चली जाती है। यह वही कट-द-लूज़र्स लूप है जो हर गंभीर Taboola विज्ञापनदाता मैन्युअली चलाता है — एनकोडेड, भावनाहीन और रात 3 बजे चल रहा।
बिड प्रबंधन। उन दिनों और जियो पर कैंपेन CPCs (और प्रति-साइट बिड मॉडिफ़ायर जहां उपलब्ध हैं) को ऊपर धकेलना जो टार्गेट को हरा देते हैं, नीचे जब CPA बहती है — छोटे, लगातार, उबाऊ समायोजन जो संयुक्त होते हैं।
बल्क क्रिएटिव ऑपरेशन। प्रति कैंपेन 30 हेडलाइन/इमेज वेरिएंट अपलोड करना, साप्ताहिक रूप से मीडियन CTR से नीचे वाली हर चीज़ को पॉज़ करना और क्लिकिंग के एक दोपहर के बिना थकान से आगे क्रिएटिव रोटेशन रखना।
खर्च पाइपलाइन। एक रात का कार्य जो campaign-summary को दिन के हिसाब से वेयरहाउस में खींचता है, ताकि Taboola खर्च कन्वर्ज़न राजस्व और हर दूसरे चैनल के बगल में एक डैशबोर्ड में पहुंचे।

एक न्यूनतम एकीकरण योजना#

यदि आप शून्य से शुरू कर रहे हैं, तो यह क्रम आपको लगभग एक दिन के काम में उपयोगी ऑटोमेशन तक ले जाता है, प्रत्येक चरण अगले से पहले सत्यापन योग्य:

टोकन राउंड-ट्रिप। क्रेडेंशियल्स को टोकन के लिए एक्सचेंज करें और allowed-accounts को कॉल करें। यदि यह काम करता है, तो ऑथ और अनुमतियाँ हल हो गई हैं।
केवल-पढ़ने योग्य रिपोर्टिंग। पिछले सप्ताह के लिए दिन के हिसाब से campaign-summary खींचें और संख्याओं को Ads Console के विरुद्ध मिलाएं। जब तक आपके पढ़ने UI द्वारा दिखाई गई चीज़ से मेल नहीं खाते, तब तक कुछ भी न लिखें।
एक सुरक्षित म्यूटेशन। PUT के माध्यम से एक टेस्ट कैंपेन को पॉज़ और अनपॉज़ करें। पुष्टि करें कि परिवर्तन कंसोल में दिखाई देता है और सर्विंग स्थिति उसका अनुसरण करती है।
रात का खर्च सिंक। अपने डेटाबेस में रिपोर्टिंग पुल को शेड्यूल करें। यह अकेले अधिकांश टीमों के लिए एकीकरण को उचित ठहराता है।
नियम इंजन, ड्राई-रन में। साइट-ब्लॉक निर्णयों की गणना करें और एक सप्ताह के लिए लॉग करें कि क्या होगा इससे पहले कि इसे लिखने दें। इसके विकल्पों की तुलना आपके द्वारा हाथ से बनाए गए विकल्पों से करना सबसे सस्ता QA होगा जो आप कभी चलाएंगे।

सीधे चरण पाँच पर जाना मानक गलती है — लाइव विज्ञापन खाते के खिलाफ राइट-पाथ बग्स महंगे सबक हैं।

रेट लिमिट्स और व्यावहारिक ध्यान देने योग्य बातें#

सीमा का सम्मान करें। बैकस्टेज प्रति-खाता रेट लिमिट लागू करता है; बैच रीड्स (प्रति घंटे प्रति कैंपेन एक रिपोर्ट कॉल, प्रति मिनट एक नहीं) और 429s पर बैक ऑफ करें। मान लेने के बजाय वर्तमान लिमिट्स के लिए संदर्भ जांचें।
रिपोर्टिंग सर्विंग से लैग करती है। हाल के घंटों का डेटा समय के साथ सेटल होता है; कम से कम कुछ घंटे पुराने डेटा के खिलाफ नियम बनाएं नहीं तो आप अपूर्ण संख्याओं पर कैंपेन पॉज़ कर देंगे।
संपादन तत्काल नहीं हैं। कैंपेन परिवर्तन विलंब के साथ सर्विंग में प्रचारित होते हैं, और आइटम संपादन रिव्यू को फिर से ट्रिगर कर सकते हैं। ऑटोमेशन को "विफल" राइट्स को फिर से जारी करने के बजाय अंतर को सहन करना चाहिए।
नाम नहीं, ID स्टोर करें। कैंपेन और आइटम नाम मनुष्यों द्वारा संपादित किए जाते हैं; संख्यात्मक ID स्थिर जॉइन कुंजी हैं।
राइट पाथ की रक्षा करें। एक बग वाला नियम इंजन किसी खाते के पूरे खर्च को पॉज़ कर सकता है या किसी बिड को 10× कर सकता है। हर म्यूटेशन को लॉग करें, सैनिटी बाउंड जोड़ें (कभी भी किसी बिड को प्रति पास X% से अधिक न बदलें), और किसी भी नए नियम को ड्राई-रन मोड में शुरू करें।

दूसरा Taboola API: प्रतिस्पर्धी डेटा#

ऊपर की हर चीज़ बिल्कुल एक खाता देखती है: आपका। बैकस्टेज आपको कभी नहीं बताएगा कि आपके वर्टिकल में कौन से विज्ञापनदाता स्केल कर रहे हैं, वे कौन से क्रिएटिव चला रहे हैं, या किसी प्रतियोगी के कैंपेन की दीर्घायु कितनी है — नेटवर्क अपनी कोई विज्ञापन लाइब्रेरी प्रकाशित नहीं करता है, और कोई आधिकारिक एंडपॉइंट अन्य विज्ञापनदाताओं की गतिविधि को एक्सपोज़ नहीं करता है।

यही अंतर OpenAdLibrary के डेवलपर API द्वारा कवर किया जाता है। इंडेक्स 206,000+ लाइव Taboola क्रिएटिव्स (जुलाई 2026) को 49 नेटवर्क्स में 725,000+ नेटिव विज्ञापनों के एक कोर्पस के अंदर रखता है, और Taboola विज्ञापन लाइब्रेरी के पीछे का वही डेटा REST पर क्वेरी करने योग्य है: विज्ञापनदाता, वर्टिकल, जियो और दीर्घायु द्वारा क्रिएटिव्स खोजें; हेडलाइन और लैंडिंग पेज खींचें; ट्रैक करें कि प्रतियोगी कब कैंपेन लॉन्च और बंद करते हैं। नेटिव विज्ञापन डेटा API गाइड एंडपॉइंट्स को दस्तावेज़ करता है, और यदि आपका वर्कफ़्लो एक LLM एजेंट में रहता है तो एक MCP सर्वर है जो उसी कोर्पस को Claude और ChatGPT के लिए टूल्स के रूप में एक्सपोज़ करता है। एक मुफ़्त कुंजी हल्के उपयोग को कवर करती है और मूल्य निर्धारण बाकी के लिए सपाट रहता है; प्रोग्रामेटिक विज्ञापन-खुफिया एक्सेस के व्यापक परिदृश्य का सर्वेक्षण API के साथ विज्ञापन जासूसी उपकरण में किया गया है।

दोनों API स्वाभाविक रूप से संयोजित होते हैं: बैकस्टेज आपके खाते पर निष्पादन को स्वचालित करता है, इंटेलिजेंस API हर किसी और पर अनुसंधान को स्वचालित करता है। ऑटोमेशन से सबसे अधिक लाभ उठाने वाले खरीदार दोनों चलाते हैं — एक नियम इंजन अपने स्वयं के कैंपेन को छँटा हुआ रखता है, और एक प्रतिस्पर्धी फ़ीड फ़्लैग करता है जब एक नया विज्ञापनदाता उनके वर्टिकल में स्केल करना शुरू करता है ताकि अगला परीक्षण कभी भी अंधेरे में न चुना जाए। प्रतिस्पर्धी कोर्पस को ब्राउज़र में देखने के लिए Taboola जासूसी उपकरण से शुरुआत करें, फिर जब वर्कफ़्लो सिद्ध हो जाए तो उन्हीं क्वेरीज़ को प्रोग्रामेटिक रूप से लें।

अक्सर पूछे जाने वाले प्रश्न

क्या Taboola बैकस्टेज API का उपयोग मुफ़्त है?

कोई अलग API शुल्क नहीं है — एक्वेस एक एडवरटाइज़र खाते के साथ आता है, और आप मीडिया खर्च के लिए हमेशा की तरह भुगतान करते हैं। बाधा कीमत नहीं, बल्कि एक्सेस है: API क्रेडेंशियल्स (एक क्लाइंट ID और सीक्रेट) आपके खाते के लिए जारी किए जाते हैं, ऐतिहासिक रूप से आपके Taboola अकाउंट मैनेजर के माध्यम से, इसलिए निर्माण शुरू करने से पहले आपके पास एक सक्रिय एडवरटाइज़र संबंध होना चाहिए।

Taboola API के साथ मैं कैसे प्रमाणित हो सकता हूँ?

बैकस्टेज OAuth 2.0 क्लाइंट-क्रेडेंशियल्स फ्लो का उपयोग करता है: अपना क्लाइंट ID और सीक्रेट backstage.taboola.com पर टोकन एंडपॉइंट को POST करें और एक बेयरर टोकन प्राप्त करें, जिसे आप हर अनुरोध पर Authorization हैडर में भेजते हैं। टोकन समाप्त हो जाते हैं, इसलिए एक को कैश करें और 401 पर रिफ्रेश करें — प्रति कॉल नया टोकन मांगने के बजाय, क्योंकि टोकन जनरेट करने पर रेट लिमिट लागू होती है।

क्या Taboola API मुझे प्रतिस्पर्धियों के विज्ञापन दिखा सकता है?

नहीं। बैकस्टेज पूरी तरह से उन खातों तक सीमित है जो आपके स्वामित्व में हैं — आपके अपने खर्च के लिए कैंपेन, क्रिएटिव्स और रिपोर्ट्स। Taboola कोई विज्ञापन लाइब्रेरी या प्रतिस्पर्धी एंडपॉइंट प्रकाशित नहीं करता है। नेटवर्क-स्तरीय दृश्यता स्वतंत्र कैप्चर से आती है: OpenAdLibrary 206,000+ लाइव Taboola क्रिएटिव्स (जुलाई 2026) को एडवरटाइज़र्स, दीर्घायु और लैंडिंग पेजों के साथ इंडेक्स करता है, जो REST API और MCP के माध्यम से क्वेरी करने योग्य है।

बैकस्टेज API के साथ मुझे सबसे पहले क्या ऑटोमेट करना चाहिए?

साइट-ब्लॉकिंग नियम इंजन सबसे तेज़ रिटर्न देता है: एक शेड्यूल पर site_breakdown रिपोर्ट खींचें, किसी भी पब्लिशर को ब्लॉक करें जिसने शून्य कन्वर्ज़न के साथ टार्गेट CPA के एक गुणक से अधिक खर्च किया है, और हर एक्शन को लॉग करें। यह वही कट-द-लूज़र्स लूप एनकोड करता है जो हर Taboola खरीदार पहले से ही मैन्युअली चलाता है, और यह बजट की रक्षा घड़ी के चारों ओर करता है, न कि केवल तब जब आप चेक करते हैं।

क्या Taboola API की रेट लिमिट्स हैं?

हाँ — प्रति-खाता लिमिट लागू होती हैं, और टोकन अनुरोधों पर डेटा अनुरोधों की तुलना में अधिक आक्रामक रूप से थ्रॉटलिंग की जाती है। व्यावहारिक मार्गदर्शन: रिपोर्ट पुल को बैच करें (प्रति मिनट प्रति कैंपेन पोलिंग न करें), 429 प्रतिक्रियाओं पर बैक ऑफ करें, और कुछ घंटे पुराने डेटा के खिलाफ निर्माण करें क्योंकि हाल के घंटों की रिपोर्टिंग समय के साथ सेटल होती है। वर्तमान लिमिट वैल्यूज़ के लिए आधिकारिक संदर्भ जांचें।

लेखकOpenAdLibrary टीम

विज्ञापन इंटेलिजेंस और नेटिव विज्ञापन अनुसंधान

हम OpenAdLibrary बनाते हैं, जो एक खुला विज्ञापन-पारदर्शिता प्लेटफॉर्म है। हर दिन हमारी प्रणालियाँ Taboola, Outbrain, MGID, Revcontent, Teads, Yahoo और MSN पर लाइव नेटिव विज्ञापन कैप्चर करती हैं, प्रत्येक विज्ञापन के पीछे के वास्तविक विज्ञापनदाता की पहचान करती हैं, और क्लिक को उसके लैंडिंग पेज तक फॉलो करती हैं। ये गाइड उस डेटा में हम जो देखते हैं, उसका सार प्रस्तुत करती हैं ताकि आप बाजार का तेजी से शोध कर सकें।