API क्या पढ़ता है

Gloriads API का हर एंडपॉइंट — परफ़ॉर्मेंस और तुलना, प्रोडक्ट, Streaming TV, कैम्पेन, कीवर्ड और ऐड, नियम और ऐक्टिविटी — उसके पैरामीटर, एक उदाहरण, और आँकड़े कितने ताज़ा हैं, इसके साथ.

पिछला अपडेट: 11 अक्टू॰ 2026

API वही आँकड़े पढ़ता है जो आपकी Gloriads स्क्रीन पर दिखते हैं. यह आपके अकाउंट या आपके ऐड में कभी कुछ नहीं बदलता.

एंडपॉइंट

एंडपॉइंट	यह क्या देता है
`GET /api/v1/account`	आपका सब्सक्रिप्शन, Amazon Ads कनेक्ट है या नहीं, और आँकड़े किस दिन तक के हैं. इसे सबसे पहले कॉल करें.
`GET /api/v1/marketplaces`	आपके कनेक्ट किए गए मार्केटप्लेस, उनकी करेंसी के साथ, और हर एक में कितने कैम्पेन, ऐड ग्रुप और ऐड चल रहे हैं.
`GET /api/v1/summary`	किसी अवधि के कुल आँकड़े: डैशबोर्ड की टाइल, हर मार्केटप्लेस और हर ऐड प्रकार के हिसाब से भी.
`GET /api/v1/timeline`	वही आँकड़े दिन या महीने के हिसाब से: डैशबोर्ड का चार्ट.
`GET /api/v1/reports/products`	किसी अवधि में ऐड वाले हर प्रोडक्ट के आँकड़े: प्रोडक्ट पेज.
`GET /api/v1/reports/streaming-tv`	किसी एक मार्केटप्लेस के Streaming TV कैम्पेन और उनके आँकड़े.
`GET /api/v1/campaigns`	किसी एक मार्केटप्लेस के कैम्पेन, बजट, टार्गेटिंग और स्थिति के साथ.
`GET /api/v1/ad-groups`	किसी एक मार्केटप्लेस के ऐड ग्रुप, उनकी डिफ़ॉल्ट बोली के साथ.
`GET /api/v1/targets`	किसी एक कैम्पेन के कीवर्ड और दूसरे टार्गेट, मैच के प्रकार और बोली के साथ.
`GET /api/v1/ads`	किसी एक कैम्पेन के ऐड: वे प्रोडक्ट जिनके ऐड वह चलाता है.
`GET /api/v1/rules`	आपके नियम: चालू या बंद, वे कहाँ काम करते हैं, उनका शेड्यूल, उनका पिछला रन.
`GET /api/v1/rules/{rule_id}/runs`	किसी एक नियम के पिछले 20 रन.
`GET /api/v1/activity`	Gloriads ने Amazon पर जो कुछ किया, सबसे नया पहले.
`GET /api/v1/activity/{operation_id}`	कोई एक ऑपरेशन.
`GET /api/v1/activity/{operation_id}/lines`	किसी एक ऑपरेशन ने लाइन दर लाइन क्या बनाया, बदला या आर्काइव किया.

हर पैरामीटर और हर फ़ील्ड API रेफ़रेंस में है, Try it बटन के साथ.

अवधि

/summary, /timeline और /reports/products किसी अवधि के आँकड़े देते हैं. इनमें से एक भेजें:

पैरामीटर	उदाहरण	मतलब
`range`	`last_30_days`	`today`, `yesterday`, `last_7_days`, `last_14_days`, `last_30_days`, `last_60_days`, `last_90_days`, `this_month`, `last_month`, `this_year`, `last_year`, `all_time`
`start_date` + `end_date`	`2026-09-01` और `2026-09-30`	दो तारीखें, दोनों शामिल, आपस में ज़्यादा से ज़्यादा छह साल का अंतर

कुछ न भेजें, तो last_30_days, डैशबोर्ड की तरह.
range पूरे दिनों को कवर करता है, यानी वही दिन जिन्हें डैशबोर्ड जोड़ता है: last_30_days कल पर खत्म होने वाले 30 दिन हैं, और this_month और this_year कल पर रुक जाते हैं. Amazon किसी बिक्री को उसके क्लिक के खाते में कुछ दिन बाद गिनता है, इसलिए आज का दिन कभी पूरा नहीं होता.
today आज का दिन है, और महीने की 1 तारीख को this_month भी (तब उसमें अभी कोई पूरा दिन नहीं होता).
all_time Gloriads के पास मौजूद सबसे पुराने दिन से शुरू होकर आज तक जाता है, डैशबोर्ड के लाइफ़टाइम की तरह.
आज को शामिल करने के लिए, start_date और end_date भेजें, end_date = आज.
timezone (Asia/Kolkata, Europe/Paris, America/New_York…) तय करता है कि “आज” कौन-सा दिन है. डिफ़ॉल्ट रूप से UTC.
हर जवाब period में बताता है कि वह किन दिनों का है.

दो अवधियों की तुलना करें

/summary, /timeline या /reports/products में compare जोड़ें, डैशबोर्ड के तुलना करें की तरह:

`compare`	किससे तुलना
`previous_period`	ठीक पहले के उतने ही दिन. इस महीने के अब तक के दिनों की तुलना पिछले महीने के उन्हीं दिनों से होती है, और पिछले महीने की तुलना उससे पहले वाले महीने से.
`same_period_last_year`	एक साल पहले की वही तारीखें.

जवाब में एक comparison जुड़ जाता है: तुलना वाली अवधि के आँकड़े, और खर्च, बिक्री, ACOS, इम्प्रेशन, क्लिक, CPC और खरीदारी में से हर एक कितना बदला:

"changes": {
  "spend": { "kind": "change", "percent": 18.2, "direction": "up", "tone": "neutral" },
  "acos": { "kind": "change", "percent": -6.5, "direction": "down", "tone": "good" }
}

दोनों अवधियाँ कल पर खत्म होती हैं, डैशबोर्ड की तरह: जो तारीखें आज तक पहुँचती हैं, उनमें से आज हट जाता है, और period यह बताता है.
kind: "new" का मतलब है कि पहले आँकड़ा शून्य था; kind: "none" का मतलब है कि तुलना के लिए कुछ नहीं है (बिना बिक्री का ACOS).
tone बताता है कि बदलाव अच्छी खबर है या नहीं, डैशबोर्ड के रंगों की तरह. खर्च हमेशा neutral होता है.
all_time से पहले कुछ नहीं है, और today में कोई पूरा दिन नहीं होता: तब comparison अपने unavailable में वजह बताता है.
जब तुलना वाली अवधि की कोई हिस्ट्री Gloriads के पास नहीं होती, तो उसके आँकड़े null होते हैं और history_covered का मान false होता है.

फ़िल्टर

पैरामीटर	उदाहरण	क्या रखता है
`marketplaces`	`US,UK`	सिर्फ़ ये देश (`GB` भी चलता है)
`ad_products`	`SPONSORED_PRODUCTS`	`SPONSORED_PRODUCTS`, `SPONSORED_BRANDS` या `SPONSORED_DISPLAY`

अनजान वैल्यू को 400 मिलता है, जो उस वैल्यू का नाम बताता है. उसके बदले कभी शून्य वाला जवाब नहीं आता.

किसी अवधि के कुल आँकड़े

curl "https://gloriads.com/api/v1/summary?range=last_month&marketplaces=US" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "period": { "start_date": "2026-09-01", "end_date": "2026-09-30", "range": "last_month", "timezone": "UTC" },
  "currency": "USD",
  "spend": 13140.53,
  "sales": 46562.2,
  "acos": 28.22,
  "roas": 3.54,
  "impressions": 3945723,
  "clicks": 13973,
  "ctr": 0.35,
  "average_cpc": 0.94,
  "purchases": 1479,
  "conversion_rate": 10.58,
  "by_marketplace": [ … ],
  "by_ad_product": [ … ],
  "meta": { "data_last_date": "2026-10-09", "history_covered": true, "truncated": false }
}

acos, ctr और conversion_rate प्रतिशत हैं: 28.22 का मतलब 28.22% है.
purchases ऑर्डर गिनता है, यूनिट नहीं, कंसोल की खरीदारी (Purchases) की तरह.
जिस अनुपात का आधार न हो (बिना बिक्री का ACOS), वह null होता है, 0 कभी नहीं.

दिन के हिसाब से या महीने के हिसाब से

/timeline वही अवधि और फ़िल्टर लेता है, और data में हर दिन या हर महीने का एक पॉइंट देता है.

granularity=auto (डिफ़ॉल्ट) 92 दिन तक दिन चुनता है, उससे ज़्यादा पर महीने, डैशबोर्ड के चार्ट की तरह.
92 दिन से लंबी अवधि पर granularity=day मना हो जाता है.
जिस दिन का कोई आँकड़ा नहीं है, वह छोड़ दिया जाता है.

हर प्रोडक्ट के हिसाब से

/reports/products ऐड वाले हर प्रोडक्ट (ASIN) की एक पंक्ति देता है, sort (डिफ़ॉल्ट spend) और order (डिफ़ॉल्ट desc) के हिसाब से क्रम में.

product_id: null में वह सब जुड़ता है जिसे Amazon किसी प्रोडक्ट से नहीं जोड़ता, ज़्यादातर Sponsored Brands.
title प्रोडक्ट का वह नाम है जो Amazon की प्रोडक्ट रिपोर्ट देती है, उस मार्केटप्लेस पर जहाँ उसने इस अवधि में सबसे ज़्यादा खर्च किया. product_id: null के लिए यह null होता है, और तब तक भी जब तक Gloriads को Amazon से खाते के प्रोडक्ट के नाम नहीं मिल जाते.
पंक्तियाँ पेज में आती हैं: देखें सीमाएँ और एरर.

Streaming TV

बाकी रिपोर्ट Streaming TV (Prime Video और स्ट्रीमिंग ऐप पर टीवी ऐड) को शामिल नहीं करतीं, डैशबोर्ड की तरह: Amazon इसे उस रिपोर्ट में नहीं डालता जिससे वे आती हैं. /reports/streaming-tv इसे Amazon की एक अलग रिपोर्ट से पढ़ता है, एक मार्केटप्लेस के लिए.

curl "https://gloriads.com/api/v1/reports/streaming-tv?marketplace_id=3478512345678901&range=last_30_days" \
  -H "Authorization: Bearer YOUR_API_KEY"

अवधि ज़्यादा से ज़्यादा 31 दिन की हो, पिछले 95 दिनों के अंदर: इस रिपोर्ट के लिए Amazon की सीमाएँ.
किसी अवधि की पहली कॉल का जवाब "status": "pending" हो सकता है, जब तक Amazon रिपोर्ट बनाता है, आमतौर पर कुछ मिनट. meta.retry_after_seconds के बाद फिर से कॉल करें. उसके बाद रिपोर्ट 3 घंटे तक रखी जाती है.
हर कैम्पेन के साथ उसका खर्च, इम्प्रेशन, cpm (प्रति 1,000 इम्प्रेशन की लागत), क्लिक, बिक्री, खरीदारी और units_sold आते हैं.
रकम मार्केटप्लेस की अपनी करेंसी में होती है, USD में नहीं.
"status": "unavailable": Amazon इस अकाउंट को Streaming TV नहीं देता, उदाहरण के लिए किसी KDP लेखक के अकाउंट को.

कैम्पेन और ऐड ग्रुप

दोनों को marketplace_id चाहिए: /marketplaces का कोई id.

curl "https://gloriads.com/api/v1/campaigns?marketplace_id=3478512345678901&states=ENABLED" \
  -H "Authorization: Bearer YOUR_API_KEY"

इनमें Sponsored Products, Sponsored Brands और Display के चालू और रुके हुए कैम्पेन आते हैं. आर्काइव किए गए कैम्पेन कभी नहीं आते.
बजट और बोलियाँ मार्केटप्लेस की अपनी करेंसी में होती हैं (/marketplaces में currency_code).
provenance बताता है कि कैम्पेन Gloriads ने बनाया, बदला, या कभी छुआ ही नहीं.
/ad-groups?campaign_id=… सिर्फ़ एक कैम्पेन के ऐड ग्रुप रखता है.
हर पेज पर 1,000 पंक्तियाँ तक (डिफ़ॉल्ट 100).

कीवर्ड, टार्गेट और ऐड

/targets और /ads वह सब लिस्ट करते हैं जो किसी एक कैम्पेन के अंदर है. दोनों को marketplace_id और campaign_id चाहिए; ad_group_id उसका सिर्फ़ एक ऐड ग्रुप रखता है.

curl "https://gloriads.com/api/v1/targets?marketplace_id=3478512345678901&campaign_id=28430987654321" \
  -H "Authorization: Bearer YOUR_API_KEY"

/targets हर कीवर्ड को उसके match_type (EXACT, PHRASE, BROAD) के साथ देता है, और प्रोडक्ट टार्गेट (ASIN), कैटेगरी, ऑटो-टार्गेटिंग ग्रुप और नेगेटिव भी, उनकी bid और स्थिति के साथ. bid: null का मतलब है कि वह ऐड ग्रुप की डिफ़ॉल्ट बोली इस्तेमाल करता है.
/ads हर ऐड को उन प्रोडक्ट के साथ देता है जिनका वह ऐड है (product_ids).
ये उसी समय Amazon से पढ़े जाते हैं जब आप माँगते हैं, और इनमें कोई आँकड़ा नहीं होता.
Sponsored Products, Sponsored Brands और Display. आर्काइव किए गए कभी लिस्ट में नहीं आते.
हर पेज पर 1,000 पंक्तियाँ तक (डिफ़ॉल्ट 100).

नियम और ऐक्टिविटी

/rules हर नियम की लिस्ट देता है, सबसे हाल में बदला गया पहले.
/rules/{rule_id}/runs दिखाता है कि हाल के हर रन ने क्या देखा और क्या बदला. टेस्ट लिस्ट में नहीं आते.
/activity में हर वह ऑपरेशन आता है जो Gloriads ने Amazon पर चलाया: कोई कैम्पेन बनाया या कॉपी किया गया, प्रोडक्ट जोड़े गए, किसी नियम के बदलाव, किसी बदलाव को वापस लेना. किसी नियम का एक रन हर मार्केटप्लेस के लिए एक बार आता है, एक ही rule_run_id के साथ. tool=rule सिर्फ़ नियमों के ऑपरेशन रखता है.
/activity/{operation_id} कोई एक ऑपरेशन पढ़ता है: जो ऑपरेशन अभी चल रहा है, उसे फ़ॉलो करने के लिए इसे बार-बार कॉल करें.
/activity/{operation_id}/lines लाइन दर लाइन बताता है कि ऑपरेशन ने क्या किया: कैम्पेन, ऐड ग्रुप, ऐड या टार्गेट, उसे बनाया, बदला या आर्काइव किया गया, हर वैल्यू पहले और बाद में, और जब कोई लाइन नाकाम हुई, तो Amazon का एरर. हर पेज पर 500 लाइनें तक: किसी नियम के एक रन में 5,000 लाइनें हो सकती हैं.

आँकड़े कितने ताज़ा हैं

ये आपके डैशबोर्ड वाले ही आँकड़े हैं, उसी डेटा से, उसी कोड से पढ़े गए.
परफ़ॉर्मेंस की रकम USD में होती है. Amazon हर मार्केटप्लेस के आँकड़े US डॉलर में बदलता है.
Amazon बिक्री को क्लिक के कई दिन बाद गिनता है, इसलिए किसी अवधि के आखिरी दिन कुछ समय तक बढ़ते रहते हैं. meta.data_last_date बताता है कि आँकड़े किस दिन तक के हैं.
कैम्पेन Amazon से ज़्यादा से ज़्यादा हर 30 मिनट में एक बार पढ़े जाते हैं, हर मार्केटप्लेस के लिए. meta.synced_at बताता है कि कब. किसी मार्केटप्लेस की सबसे पहली कॉल पर लिस्ट खाली हो सकती है, meta.syncing: true के साथ: एक मिनट बाद फिर से कॉल करें.
प्रोडक्ट के आँकड़े दिन में एक बार अपडेट होते हैं. जो अवधि Gloriads के पास मौजूद हिस्ट्री से पहले शुरू होती है, उस पर meta.history_covered: false आता है.
कीवर्ड, टार्गेट और ऐड Amazon से लाइव पढ़े जाते हैं, हर कॉल पर: meta.read_at बताता है कि कब.
Streaming TV के आँकड़े 3 घंटे तक रखे जाते हैं, Amazon के उनकी रिपोर्ट बनाने के बाद: meta.report_ready_at बताता है कि कब.

API से शुरुआत करें ऑथेंटिकेशन और API कुंजियाँ