Pins, boards and public profile content.
ピン
URL（pinterest.com/pin/ の形式）で 1 つのピンを取得します。レスポンスは検索結果とは異なる形です。entityId、description、category、totalReactionCount、aggregatedPinData、richMetadata、pinner、originPinner、genAiTopics などの camelCase フィールドを含みます。キーワードでピンを探すには get_pinterest_search、ピンが属するボードをページングするには get_pinterest_board を使用してください。解決できるのは標準的な数値のピン URL のみです。12 件の検索結果をそのまま渡したところ、URL がショートコード（dwA0UYrl 形式）で終わる 3 件はすべて 404 を返し、数値 id の 1 件も同様でした。そのため、呼び出す前に末尾が数値 id かどうかを確認し、削除済みのピンでは 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
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
}