API से शुरुआत करें

Gloriads API से आपके अपने टूल — कोई स्प्रेडशीट, स्क्रिप्ट या ऑटोमेशन — आपका अकाउंट पढ़ सकते हैं.

यह सिर्फ़ पढ़ने के लिए है. कुंजी आपका अकाउंट पढ़ती है और कुछ नहीं बदलती. API हर प्लान में और मुफ़्त ट्रायल के दौरान शामिल है.

किसी AI असिस्टेंट से अपने अकाउंट के बारे में पूछने के लिए, किसी कुंजी की ज़रूरत नहीं: देखें AI असिस्टेंट कनेक्ट करें.

1. कुंजी बनाएँ

सेटिंग → API → कुंजी बनाएँ. इसे उस टूल का नाम दें जो इसका इस्तेमाल करेगा, फिर कुंजी कॉपी करें. यह key_live_ से शुरू होती है और सिर्फ़ एक बार दिखाई जाती है.

आप कितनी कुंजियाँ रख सकते हैं और कोई कुंजी कैसे रिवोक करें: ऑथेंटिकेशन और API कुंजियाँ.

2. अपनी पहली कॉल करें

हर रिक्वेस्ट https://gloriads.com/api/v1 पर जाती है और Authorization हेडर में आपकी कुंजी लेकर जाती है:

curl https://gloriads.com/api/v1/account \
  -H "Authorization: Bearer YOUR_API_KEY"

/account साबित करता है कि कुंजी काम करती है, बताता है कि वह किस अकाउंट की है, और यह भी कि आपके Amazon Ads आँकड़े किस दिन तक के हैं:

{
  "is_demo": false,
  "subscription": { "status": "active" },
  "api_key": {
    "name": "My script",
    "start": "key_live_ab12",
    "scopes": ["read"],
    "created_at": "2026-09-15T07:55:00.000Z",
    "last_used_at": null
  },
  "connected_app": null,
  "amazon_ads": {
    "connection": "connected",
    "marketplaces": 3,
    "performance_data": {
      "currency": "USD",
      "first_date": "2021-03-01",
      "last_date": "2026-10-09",
      "synced_at": "2026-10-10T06:12:00.000Z",
      "is_syncing": false,
      "history_complete": true
    }
  }
}

अगर connection का मान error है, तो सेटिंग → Amazon Ads में Amazon Ads फिर से कनेक्ट करें: जब तक आप ऐसा नहीं करते, आँकड़े अपडेट नहीं होते.

3. हर एंडपॉइंट देखें

किसी पहले की अवधि से तुलना के साथ आपकी परफ़ॉर्मेंस, आपके प्रोडक्ट, आपके Streaming TV कैम्पेन, कीवर्ड और ऐड के साथ आपके कैम्पेन, आपके नियम और Gloriads ने Amazon पर जो कुछ किया: API क्या पढ़ता है में हर एंडपॉइंट एक उदाहरण के साथ है. API रेफ़रेंस में हर पैरामीटर और जवाब है, Try it बटन के साथ.

सीमाएँ

हर अकाउंट के लिए 60 रिक्वेस्ट प्रति मिनट और 10,000 प्रति दिन. इनमें से कोई भी सीमा पार होने पर, API Retry-After हेडर के साथ 429 जवाब देता है: देखें एरर.