API للمؤثرين يخدم بيانات الإهداء لديك.

لمن صُمّم الـAPI

صُمّم لمسؤول العمليات أو المطوّر الذي يريد بيانات Pozto في مكان آخر: قاعدة Airtable، أو مستودع بيانات، أو لوحة تحكم، أو أداة داخلية. أو في الاتجاه المعاكس: إضافة صنّاع المحتوى من النظام الذي يشحن هداياك، فلا يُدخلهم أحد مرتين.

يعمل على قائمتك أنت، أي صنّاع المحتوى الذين أرسلت إليهم منتجات. وليس قاعدة بيانات للبحث عن المؤثرين. فإن كان هذا ما تحتاجه من API للمؤثرين، فـPozto ليس الخيار المناسب.

المفاتيح والرابط الأساسي والحدود

• الرابط الأساسي: https://pozto.co/api/v1
• المفاتيح: ينشئها مالك الفريق من الإعدادات ← API، ضمن خطة Brand. يبدأ المفتاح بـ pz_ ولا يُعرض إلا مرة واحدة: لا يحتفظ Pozto إلا ببصمته، فانسخه حينها. سمِّ كل مفتاح بحسب الغرض منه، ويمكنك إلغاؤه في أي وقت. وتُظهر الإعدادات آخر مرة استُخدم فيها كل مفتاح.
• طريقة إرساله: Authorization: Bearer pz_… في كل طلب.
• النطاق: مفتاح واحد يقرأ من كل علامات فريقك ويضيف إليها.
• حد الطلبات: 120 طلبًا في الدقيقة لكل مفتاح.
• الصفحات: يُعيد GET /creators وGET /posts ‏100 عنصر في كل مرة، أو حتى 500 باستخدام &limit=. عند وجود المزيد، تتضمن الاستجابة next_cursor: أرسله مرة أخرى بصيغة &cursor= للحصول على الصفحة التالية. وقيمته null في الصفحة الأخيرة.
• الصيغة: JSON في الإرسال والاستقبال. المعرّفات نصوص، والتواريخ بصيغة ISO 8601.

نقاط الوصول

ما يتضمنه صانع المحتوى والمنشور

يأتي صانع المحتوى مع اسمه، وبريده الإلكتروني، وحساباته (وهل عُثر على كل حساب)، وأكواد الخصم، وحالته، وكل هدية: المنتج وبقية محتويات الصندوق، وحملتها، وتاريخي الشحن والتسليم، والمهلة بالأيام، ورقم التتبع، والأجر، وعدد المنشورات المطلوبة والمنشورات حتى الآن.

المنشور فيديو واحد، مع كل منصة نُشر عليها: الرابط، والنص المرافق، وتاريخ النشر، وهل أشار إليك. ثم الهدية والمنتج اللذان يُحتسب لهما، وكيف قرر Pozto ذلك. ثم فحص الفيديو: هل عُثر على منتجك، وكل لحظة ظهوره على الشاشة بالثواني، وكل مرة ذُكر فيها مع الاقتباس، وملخص قصير. ثم الإفصاح: واضح أو ضعيف أو غائب، مع السبب.

إضافة صنّاع المحتوى والمنشورات

يقبل POST /creators الحقلين brand_id وhandles: أسماء @، أو روابط الملفات الشخصية، أو روابط على غرار Linktree، حتى ستة. ويقبل أيضًا platform، وname، وemail، وcodes، وproduct (معرّف أو اسم؛ والاسم الجديد يضيف المنتج)، وshipped_at، وdelivered_at، وdue_days (21 إن لم تحدده)، وtracking. أما صانع المحتوى الموجود في القائمة، ويُطابَق بأي من حساباته أو بريده الإلكتروني، فتُضاف إليه الهدية بدل إنشاء نسخة مكررة. ويُعيد 201 لصانع المحتوى الجديد و200 للموجود، مع معرّف صانع المحتوى ومعرّف الهدية.

يقبل 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، وفي التقرير الأسبوعي. اطّلع على تقارير المؤثرين.
• لا Webhooks. لالتقاط المنشورات الجديدة، استخدم GET /posts مع since.
• لا تعديل ولا حذف. يقرأ الـAPI ويضيف فقط. أما التعديلات والحذف فتجري في التطبيق.
• لا مفاتيح لكل شخص. المفاتيح ملك للفريق، والمالك وحده ينشئها.

ما تتضمنه المنشورات هو نفسه ما في التطبيق: يعثر Pozto على المنشورات بمشاهدة الفيديو، أي اللقطات والصوت والنص المرافق، لذا تصل المنشورات بلا إشارة أيضًا. ويشرح دليل متابعة المؤثرين كيف يُعثر على المنشورات.

الأسعار

يأتي الـAPI مع خطة Brand: $999 شهريًا، أو $799 شهريًا عند الدفع سنويًا، مع 10 علامات تجارية، و1,000 صانع محتوى نشط، ومقاعد بلا حدود، وتسجيل دخول موحّد. وكل ما عدا ذلك في Pozto يبدأ من خطط أقل، وتغطي الخطة المجانية أول 10 من صنّاع المحتوى. اطّلع على الخطط.