Pins, boards and public profile content.
Pinterest 操作
Pin
依 URL 取得單一 Pin,URL 形式為 pinterest.com/pin/。回應結構與搜尋結果不同:包含 entityId、description、category、totalReactionCount、aggregatedPinData、richMetadata、pinner、originPinner 與 genAiTopics 等 camelCase 欄位。若要依關鍵字尋找 Pin,請使用 get_pinterest_search;若要翻遍某個 Pin 所在的圖板,請使用 get_pinterest_board。只有標準的數字 Pin URL 能解析:將 12 筆搜尋結果直接回傳時,其中 3 筆 URL 以短代碼(dwA0UYrl 這種形式)結尾的全部回傳 404,另有一個數字 id 也是如此。因此呼叫前請確認結尾是數字 id,並對已刪除 Pin 偶爾出現的 404 有所準備。
定價參考
- 計量方式:依結果筆數計量。
- 參考請求預估:USD 0.00188。
- 參考客戶乘數:1.0。不得再次套用於已結算的客戶金額。
僅供參考的中繼資料,並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
查詢參數
- 類型: stringtrim
- 類型: stringurl
回應
- 類型: object · ResponseD03A0F58B24A_PinterestPinResponse200
成功回應
- 類型: stringcreated
At - 類型: integercredits
_remaining Integer numbers.
- 類型: stringdescription
- 類型: stringentity
Id - 類型: object | nullorigin
Pinner - property類型: anything
Name
- 類型: objectpinner
- property類型: anything
Name
- 類型: integerrepin
Count Integer numbers.
- 類型: booleansuccess
- 類型: integertotal
Reaction Count Integer numbers.
- 類型: anythingproperty
Name
application/json - 400
無法處理該要求。請檢查請求參數。
- 401
需要有效的 Felo API 金鑰。
- 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
}