आपके गिफ़्टिंग डेटा के लिए इन्फ्लुएंसर API।

API किस काम का है

यह उस ऑप्स व्यक्ति या डेवलपर के लिए है जो Pozto का डेटा कहीं और चाहता है: Airtable बेस, डेटा वेयरहाउस, डैशबोर्ड, कोई इंटरनल टूल। या उल्टा: उस सिस्टम से क्रिएटर्स जोड़ना जो आपके गिफ़्ट शिप करता है, ताकि किसी को उन्हें दो बार टाइप न करना पड़े।

यह आपके अपने रोस्टर पर काम करता है, यानी उन क्रिएटर्स पर जिन्हें आपने प्रोडक्ट भेजा है। यह सर्च करने के लिए इन्फ्लुएंसर्स का डेटाबेस नहीं है। अगर आपको इन्फ्लुएंसर API से यही चाहिए, तो Pozto वह नहीं है।

कीज़, बेस URL और लिमिट

• बेस URL: https://pozto.co/api/v1
• कीज़: टीम का ओनर इन्हें सेटिंग्स → API में बनाता है, Brand प्लान पर। की pz_ से शुरू होती है और एक ही बार दिखती है: Pozto सिर्फ़ उसका फ़िंगरप्रिंट रखता है, इसलिए उसी समय कॉपी कर लें। हर की को उसके काम के नाम पर रखें, और कभी भी रद्द करें। सेटिंग्स में दिखता है कि हर की आख़िरी बार कब इस्तेमाल हुई।
• भेजना: हर रिक्वेस्ट पर Authorization: Bearer pz_…
• दायरा: एक की आपकी टीम के हर ब्रांड को पढ़ती है और उनमें जोड़ती है।
• रेट लिमिट: हर की के लिए प्रति मिनट 120 रिक्वेस्ट।
• पेज: GET /creators और GET /posts एक बार में 100 लौटाते हैं, या &limit= के साथ 500 तक। और होने पर जवाब में next_cursor होता है: अगले पेज के लिए उसे &cursor= के रूप में वापस भेजें। आख़िरी पेज पर यह null होता है।
• फ़ॉर्मेट: अंदर और बाहर JSON। Ids स्ट्रिंग होती हैं, और तारीख़ें ISO 8601 में।

एंडपॉइंट

एक क्रिएटर और एक पोस्ट में क्या होता है

क्रिएटर के साथ आता है उनका नाम, ईमेल, अकाउंट (और यह कि हर हैंडल मिला या नहीं), डिस्काउंट कोड, स्टेटस, और हर गिफ़्ट: प्रोडक्ट और बॉक्स की बाकी चीज़ें, उसका कैंपेन, शिप और डिलीवर होने की तारीख़ें, दिनों में डेडलाइन, ट्रैकिंग नंबर, फ़ीस, माँगी गई पोस्ट और अब तक की पोस्ट।

पोस्ट एक वीडियो है, हर उस प्लेटफ़ॉर्म के साथ जहाँ वह डाला गया: लिंक, कैप्शन, पोस्ट की तारीख़ और यह कि उसने आपको टैग किया या नहीं। फिर वह गिफ़्ट और प्रोडक्ट जिसके लिए वह गिना जाता है, और Pozto ने यह कैसे तय किया। फिर वीडियो चेक: आपका प्रोडक्ट मिला या नहीं, स्क्रीन पर हर पल सेकंड में, हर बार जब उसका नाम लिया गया कोट के साथ, और एक छोटा सारांश। और डिस्क्लोज़र: साफ़, कमज़ोर या कोई नहीं, वजह के साथ।

क्रिएटर्स और पोस्ट जोड़ना

POST /creators में brand_id और handles जाते हैं: @नाम, प्रोफ़ाइल लिंक या Linktree जैसे लिंक, छह तक। इसमें platform, name, email, codes, product (id या नाम; नया नाम प्रोडक्ट जोड़ देता है), shipped_at, delivered_at, due_days (छोड़ दें तो 21) और tracking भी जाते हैं। जो क्रिएटर पहले से लिस्ट में है, उनके किसी भी अकाउंट या ईमेल से मिलान होने पर, उसे डुप्लिकेट के बजाय गिफ़्ट मिल जाता है। नए क्रिएटर के लिए जवाब 201 और मौजूदा के लिए 200 होता है, क्रिएटर की id और गिफ़्ट की id के साथ।

POST /posts में brand_id और url जाते हैं, और वैकल्पिक रूप से creator_id और product_id। पोस्ट उस व्यक्ति के तहत रखी जाती है जिसका अकाउंट है, नए हों तो आपकी लिस्ट में जोड़े जाते हैं, और वीडियो चेक की कतार में डाली जाती है। जवाब में आता है कि पोस्ट नई थी या नहीं, हैंडल, प्लेटफ़ॉर्म और यह कि वह आपके बारे में पोस्ट गिनी जाती है या नहीं।

# एक ब्रांड में देर करने वाले क्रिएटर्स
curl "https://pozto.co/api/v1/creators?brand_id=BRAND_ID&status=late" \
  -H "Authorization: Bearer pz_…"

# एक क्रिएटर और उन्हें भेजा गया गिफ़्ट जोड़ें
curl -X POST https://pozto.co/api/v1/creators \
  -H "Authorization: Bearer pz_…" \
  -H "Content-Type: application/json" \
  -d '{"brand_id":"BRAND_ID","handles":["@maya.glows"],"product":"Glow Serum","shipped_at":"2026-10-14"}'

# 1 अक्टूबर से अब तक की पोस्ट, सबसे नई पहले
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01" \
  -H "Authorization: Bearer pz_…"

# अगला पेज: पिछले जवाब का next_cursor
curl "https://pozto.co/api/v1/posts?brand_id=BRAND_ID&since=2026-10-01&cursor=NEXT_CURSOR" \
  -H "Authorization: Bearer pz_…"

एरर

एरर JSON के रूप में एक सादे वाक्य के साथ लौटती है, जैसे {"error": "…"}, और 4xx स्टेटस के साथ:

• 400: बॉडी JSON नहीं है, या कोई फ़ील्ड मान्य नहीं है, जैसे भविष्य की डिलीवरी तारीख़।
• 401: कोई की नहीं, या की ग़लत है या रद्द हो चुकी है।
• 403: आपकी टीम Brand प्लान पर नहीं है।
• 404: आपकी टीम में उस brand_id का कोई ब्रांड नहीं।
• 409: ब्रांड लॉक है, क्योंकि आपके प्लान में आपकी टीम के इस्तेमाल से कम ब्रांड हैं।
• 429: एक मिनट में 120 से ज़्यादा रिक्वेस्ट।

API क्या नहीं करता

• कोई इन्फ्लुएंसर सर्च नहीं। यह आपकी अपनी लिस्ट पढ़ता है और उसमें जोड़ता है। क्रिएटर्स खोजना ऐप में क्रिएटर्स खोजें का काम है।
• जवाब में व्यूज़, लाइक्स या EMV नहीं। ये Starter से ऐप में और साप्ताहिक रिपोर्ट में हैं। इन्फ्लुएंसर रिपोर्टिंग देखें।
• कोई वेबहुक नहीं। नई पोस्ट पाने के लिए since के साथ GET /posts करें।
• कोई एडिट या डिलीट नहीं। API पढ़ता और जोड़ता है। बदलाव और हटाना ऐप में होता है।
• व्यक्तिगत कीज़ नहीं। कीज़ टीम की होती हैं, और सिर्फ़ ओनर उन्हें बनाता है।

पोस्ट में वही होता है जो ऐप में है: Pozto वीडियो, फ़्रेम, ऑडियो और कैप्शन देखकर पोस्ट ढूँढता है, इसलिए बिना टैग वाली पोस्ट भी आती हैं। इन्फ्लुएंसर ट्रैकिंग बताता है कि पोस्ट कैसे मिलती हैं।

प्राइसिंग

API Brand प्लान के साथ आता है: $999 प्रति माह, या सालाना पेमेंट पर $799 प्रति माह, 10 ब्रांड्स, 1,000 एक्टिव क्रिएटर्स, अनलिमिटेड सीट और सिंगल साइन-ऑन के साथ। Pozto की बाकी हर चीज़ निचले प्लान से शुरू होती है, और Free प्लान आपके पहले 10 क्रिएटर्स कवर करता है। प्लान देखें।