Felo API PlatformFelo API Platform
همه endpointهای 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