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 有所准备。
计费参考
- 计量方式:按结果数量计量。
- 参考请求估算: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
}