Pins, boards and public profile content.
Pin
Récupère un pin par URL, au format pinterest.com/pin/. La réponse a une forme différente de celle des résultats de recherche : des champs camelCase dont entityId, description, category, totalReactionCount, aggregatedPinData, richMetadata, pinner, originPinner et genAiTopics. Pour trouver des pins par mot-clé, utilisez get_pinterest_search ; pour parcourir le tableau auquel appartient un pin, utilisez get_pinterest_board. Seules les URL de pin numériques standard se résolvent : sur 12 résultats de recherche renvoyés directement, les 3 dont l'URL se terminait par un shortcode (style dwA0UYrl) ont tous répondu 404, et un id numérique aussi ; vérifiez donc la présence d'un id numérique final avant d'appeler et attendez-vous à des 404 occasionnels sur des pins supprimés.
Référence tarifaire
- Mesure : comptage des résultats mesurés.
- Estimation de référence par requête : USD 0.00188.
- Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: stringtrim
- Type: stringurl
- Type: object · ResponseD03A0F58B24A_PinterestPinResponse200
Réponse réussie
- Type: stringcreated
At - Type: integercredits
_remaining Integer numbers.
- Type: stringdescription
- Type: stringentity
Id - Type: object | nullorigin
Pinner - propertyType: anything
Name
- Type: objectpinner
- propertyType: anything
Name
- Type: integerrepin
Count Integer numbers.
- Type: booleansuccess
- Type: integertotal
Reaction Count Integer numbers.
- Type: anythingproperty
Name
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
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
}