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

دبوس

Felo API Support
MIT
الخادم:https://openapi.felo.ai
مكتبات العملاء
Shell Curl

Pinterest

​

Pins, boards and public profile content.

Pinterest العمليات

دبوس

​

جلب دبوس واحد عبر URL بالصيغة pinterest.com/pin/. تختلف الاستجابة عن نتائج البحث: حقول camelCase تشمل entityId وdescription وcategory وtotalReactionCount وaggregatedPinData وrichMetadata وpinner وoriginPinner وgenAiTopics. للعثور على الدبابيس بالكلمة المفتاحية استخدم get_pinterest_search؛ وللتنقّل في اللوحة التي يوجد فيها الدبوس استخدم get_pinterest_board. لا تُحلّ سوى عناوين URL الرقمية القياسية للدبابيس: من بين 12 نتيجة بحث أُعيد إرسالها مباشرةً، أعادت الثلاثة التي انتهى URL الخاص بها إلى shortcode (بنمط dwA0UYrl) الاستجابة 404، وكذلك فعل معرّف رقمي واحد، لذا تحقّق من وجود معرّف رقمي في النهاية قبل الاستدعاء وتوقّع استجابات 404 عرضية للدبابيس المحذوفة.

مرجع التسعير

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

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

معاملات الاستعلام
  • trim
    النوع: string
  • url
    النوع: string
الاستجابات
  • 200
    النوع: object · ResponseD03A0F58B24A_PinterestPinResponse

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

    • createdAt
      النوع: string
    • credits_remaining
      النوع: integer

      Integer numbers.

    • description
      النوع: string
    • entityId
      النوع: string
    • originPinner
      النوع: object | null
      • propertyName
        النوع: anything
    • pinner
      النوع: object
      • propertyName
        النوع: anything
    • repinCount
      النوع: integer

      Integer numbers.

    • success
      النوع: boolean
    • totalReactionCount
      النوع: integer

      Integer numbers.

    • propertyName
      النوع: anything
    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for get/v1/beta/pinterest/pin
curl https://openapi.felo.ai/v1/beta/pinterest/pin \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "success": true,
  "entityId": "36662184461578355",
  "seoAltText": "a small brown dog sitting in the back seat of a car with its head hanging out",
  "originPinner": {
    "entityId": "1144125617743372495",
    "id": "VXNlcjoxMTQ0MTI1NjE3NzQzMzcyNDk1",
    "username": "Chloe_hi15",
    "imageMediumUrl": "https://i.pinimg.com/75x75_RS/90/99/6f/90996f6eac9c9fd4836fba948699fd28.jpg",
    "blockedByMe": false,
    "explicitlyFollowedByMe": false,
    "followerCount": 55,
    "fullName": "Chloe Marie Monroe",
    "imageLargeUrl": "https://i.pinimg.com/140x140_RS/90/99/6f/90996f6eac9c9fd4836fba948699fd28.jpg",
    "imageSmallUrl": "https://i.pinimg.com/30x30_RS/90/99/6f/90996f6eac9c9fd4836fba948699fd28.jpg",
    "isVerifiedMerchant": false,
    "verifiedIdentity": {
      "verified": null
    }
  },
  "pinner": {
    "blockedByMe": false,
    "id": "VXNlcjozNjY2MjMyMTg3NDk5NjcxNQ==",
    "entityId": "36662321874996715",
    "__typename": "User",
    "fullName": "Crystal Catlett",
    "imageSmallUrl": "https://i.pinimg.com/30x30_RS/51/76/82/5176824c31aaeec633f0f09bf1ca12e4.jpg",
    "imageLargeUrl": "https://i.pinimg.com/140x140_RS/51/76/82/5176824c31aaeec633f0f09bf1ca12e4.jpg",
    "explicitlyFollowedByMe": false,
    "username": "cc1025",
    "imageMediumUrl": "https://i.pinimg.com/75x75_RS/51/76/82/5176824c31aaeec633f0f09bf1ca12e4.jpg",
    "firstName": "Crystal",
    "followerCount": 347,
    "isVerifiedMerchant": false,
    "verifiedIdentity": {
      "verified": null
    }
  },
  "imageSpec_orig": {
    "url": "https://i.pinimg.com/originals/71/5c/5d/715c5d48feb038e16f48a28e6f8ca1f3.jpg"
  },
  "description": " ",
  "shareCount": 0,
  "nativeCreator": null,
  "createdAt": "Mon, 09 Jun 2025 04:04:22 +0000",
  "repinCount": 88,
  "totalReactionCount": 88
}

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

Pin