Pins, boards and public profile content.
Pin
Pobiera jeden pin według URL-a w formacie pinterest.com/pin/. Odpowiedź ma inny kształt niż wyniki wyszukiwania: pola w camelCase, w tym entityId, description, category, totalReactionCount, aggregatedPinData, richMetadata, pinner, originPinner i genAiTopics. Aby znaleźć piny według słowa kluczowego, użyj get_pinterest_search; aby przejrzeć tablicę, do której należy pin, użyj get_pinterest_board. Działają tylko standardowe numeryczne adresy URL pinów: spośród 12 wyników wyszukiwania przesłanych bezpośrednio z powrotem 3, których adres kończył się krótkim kodem (w stylu dwA0UYrl), zwróciły 404, podobnie jak jeden numeryczny identyfikator — dlatego przed wywołaniem sprawdź, czy na końcu znajduje się numeryczny identyfikator, i licz się z okazjonalnymi błędami 404 przy usuniętych pinach.
Cennik referencyjny
- Rozliczanie: według liczby wyników.
- Szacunek referencyjny dla żądania: USD 0.00188.
- Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.
Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.
- Typ: stringtrim
- Typ: stringurl
- Typ: object · ResponseD03A0F58B24A_PinterestPinResponse200
Pomyślna odpowiedź
- Typ: stringcreated
At - Typ: integercredits
_remaining Integer numbers.
- Typ: stringdescription
- Typ: stringentity
Id - Typ: object | nullorigin
Pinner - propertyTyp: anything
Name
- Typ: objectpinner
- propertyTyp: anything
Name
- Typ: integerrepin
Count Integer numbers.
- Typ: booleansuccess
- Typ: integertotal
Reaction Count Integer numbers.
- Typ: anythingproperty
Name
application/json - 400
Nie można przetworzyć żądania. Sprawdź parametry żądania.
- 401
Wymagany jest prawidłowy klucz API Felo.
- 402
Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
- 403
Konto nie ma uprawnień do wykonania tej operacji.
- 429
Osiągnięto limit żądań lub wydatków.
- 502
Usługa nie mogła ukończyć żądania.
- 503
API lub usługa rozliczeniowa jest tymczasowo niedostępna.
- 504
Upłynął limit czasu usługi podczas przetwarzania żądania.
- default
Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy
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
}