Felo API PlatformFelo API Platform
جميع endpoints الخاصة بـ DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

مهام Pinterest المباشرة في وسائل التواصل الاجتماعي

الخادم:https://openapi.felo.ai
مكتبات العملاء

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

مهام Pinterest المباشرة في وسائل التواصل الاجتماعي

​

عدد مرات تثبيت كل عنصر من targets على Pinterest. يعيد type وpage_url وpins_count لكل عنوان URL. الاستجابة مغلّفة في غلاف DataForSEO: البيانات في tasks[0].result، والنتيجة في tasks[0].status_code — ولا يزال الطلب المرفوض يعيد HTTP 200. يأخذ قائمة، لذا يمكنك فحص صفحات موقع كامل في استدعاء واحد. لمحتوى Pinterest بدلًا من الأعداد، يقرأ خادم pinterest المنصة مباشرة.

مرجع التسعير

  • القياس: تكلفة الاستجابة المُبلَّغ عنها.
  • تقدير الطلب المرجعي: 0.2428 دولار أمريكي.
  • مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

الجسم
مطلوب
application/json
  • النوع: array object[]
    • targets
      النوع: array string[]
      مطلوب

      عناوين URL المستهدفة حقل مطلوب يجب تحديد الصفحة الهدف بعنوان URL المطلق (بما في ذلك http:// أو https://) مثال: https://dataforseo.com/ملاحظة: يمكنك تحديد 10 أهداف كحد أقصى. وستُحتسب الرسوم عن كل عنوان URL تحدده في هذه المصفوفة

    • tag
      النوع: string

      معرّف مهمة يحدده المستخدم حقل اختياري الحد الأقصى للأحرف هو 255 يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة وستجد قيمة tag المحددة في كائن data في الاستجابة

الاستجابات
  • 200
    النوع: object

    استجابة ناجحة

    • result
      النوع: array string[]

      مصفوفة النتائج

    • result.page_url
      النوع: string

      عنوان URL للصفحة التي تُقدَّم لها البيانات عنوان URL المقابل الذي حددته في مصفوفة targets عند إعداد المهمة

    • result.pins_count
      النوع: integer

      عدد الدبابيس الخاصة بـ page_url المرتبط تقابل الدبابيس على Pinterest عمليات حفظ المحتوى؛ ويُظهر هذا الحقل عدد عمليات حفظ المحتوى المنفذة من page_url المرتبط باستخدام زر الحفظ في Pinterest

    • result.type
      النوع: string

      نوع العنصر = ‘social_media_pinterest_item’

    • tasks
      النوع: array string[]

      مصفوفة المهام

    • tasks.cost
      النوع: number

      تكلفة المهمة، بالدولار الأمريكي

    • tasks.data
      النوع: object

      يحتوي على المعاملات نفسها التي حددتها في طلب POST

    • tasks.id
      النوع: string

      معرّف مهمة فريد في نظامنا بصيغة معرّف فريد عالمي (UUID)

    • tasks.path
      النوع: array string[]

      مسار URL

    • tasks.result_count
      النوع: integer

      عدد العناصر في مصفوفة result

    • tasks.status_code
      النوع: integer

      رمز حالة المهمة الذي أنشأه DataForSEO؛ يمكن أن يقع ضمن النطاق التالي: 10000-60000

    • tasks.status_message
      النوع: string

      رسالة إعلامية للمهمة

    • tasks.time
      النوع: string

      وقت التنفيذ، بالثواني

    • version
      النوع: string

      الإصدار الحالي من API

    • version.cost
      النوع: number

      إجمالي تكلفة المهام، بالدولار الأمريكي

    • version.status_code
      النوع: integer

      رمز الحالة العام يمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا ملاحظة: نوصي بشدة بتصميم نظام لازم لمعالجة الحالات الاستثنائية أو حالات الخطأ ذات الصلة

    • version.status_message
      النوع: string

      رسالة إعلامية عامة يمكنك العثور على القائمة الكاملة للرسائل الإعلامية العامة هنا

    • version.tasks_count
      النوع: integer

      عدد المهام في مصفوفة tasks

    • version.tasks_error
      النوع: integer

      عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ

    • version.time
      النوع: string

      وقت التنفيذ، بالثواني

    application/json
  • 400

    تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

  • 401

    مطلوب مفتاح API صالح من Felo.

  • 402

    لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

  • 403

    الحساب غير مصرّح له بهذه العملية.

  • 429

    تم بلوغ حد الطلبات أو حد الإنفاق.

  • 502

    تعذّر على الخدمة إكمال الطلب.

  • 503

    خدمة API أو الفوترة غير متاحة مؤقتًا.

  • 504

    انتهت مهلة الخدمة أثناء معالجة الطلب.

  • default

    استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

    application/json
Request Example for post/v1/beta/dataforseo/business_data/social_media/pinterest/live
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/social_media/pinterest/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      ""
    ],
    "tag": ""
  }
]'
{
  "version": "string",
  "version.status_code": 1,
  "version.status_message": "string",
  "version.time": "string",
  "version.cost": 1,
  "version.tasks_count": 1,
  "version.tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "result": [
    "string"
  ],
  "result.type": "string",
  "result.page_url": "string",
  "result.pins_count": 1
}
Live Social Media Pinterest Tasks