API Pinterest

Pinterest Recherche API

Cherchez sur Pinterest par mot-clé et obtenez des résultats de pins, vidéos, tableaux ou profils avec titres, images et liens.

0,80 $US/1k req, paiement à la requête, sans abonnement.

mid-century living room | Pinterest
pinterest.com/search/pins/
mid-century living roomLog inSign up
IdeasDecor ideasModernMinimalist designVintage accents
Save

Warm mid-century living room with walnut credenza

Living Room Ideas

Ce que l’API a renvoyéitems[0]
{
"id": "998271640023841902",
"url": "https://www.pinterest.com/pin/998271640023841902/",
"title": "Warm mid-century living room with walnut credenza",
"description": "A sunlit living room mixing walnut furniture, a boucle sofa, and brass accents for a warm mid-century look.",
"image": "https://i.pinimg.com/736x/4a/2b/9c/midcentury-living-room.jpg",
"pinner": {...},
"boardName": "Living Room Ideas",
"domain": "havenandhearth.com",
... 4 champs de plus
}
Disponibilité
99,98%
30d · 29 405 appels
Requêtes
29 870
30 j · par semaine, 12 dernières sem.
Réponse
4,2s
médiane · 30d

Tarifs et fournisseurs

Tarifs de l’API Pinterest Recherche : une API, 2 fournisseurs interchangeables

Le fournisseur le moins cher répond en premier. S’il échoue, le suivant prend le relais dans le même appel.

Vous payez
8,00 $US
0,80 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 125 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez Pinterest Recherche en une requête

requireFieldsarray
Facultatif ; omettez-le et le routage est inchangé, la source la moins chère répondant. Nommez les champs de sortie que cette requête doit pouvoir renvoyer, par exemple `description` or `videoUrl`, et elle n’est servie que par une source qui les renvoie tous. Les champs que vous ne nommez pas sont quand même renvoyés chaque fois que la source qui répond les possède. Cela peut augmenter votre prix : quand la source la moins chère ne peut pas renvoyer un champ nommé, une source plus chère répond, et vous êtes facturé à son prix. Un champ nommé peut quand même être null sur un pin qui en est réellement dépourvu. Nommer une combinaison qu’aucune source unique ne renvoie ensemble est refusé comme entrée invalide, sans frais.
Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse
Les exécutions gratuites ne renvoient que les 3 premiers résultats. Alimentez une clé pour obtenir la réponse complète.

Cet exemple affiche 9 champs sur 13. Voir tous les champs

{
  "found": true,
  "data": {
    "items": [
      {
        "id": "998271640023841902",
        "url": "https://www.pinterest.com/pin/998271640023841902/",
        "title": "Warm mid-century living room with walnut credenza",
        "description": "A sunlit living room mixing walnut furniture, a boucle sofa, and brass accents for a warm mid-century look.",
        "image": "https://i.pinimg.com/736x/4a/2b/9c/midcentury-living-room.jpg",
        "pinner": {
          "username": "havenandhearth",
          "displayName": "Haven & Hearth Design"
        },
        "boardName": "Living Room Ideas",
        "domain": "havenandhearth.com",
        "saveCount": 4820
      },
      {
        "id": "672190384710025612",
        "url": "https://www.pinterest.com/pin/672190384710025612/",
        "title": "Sunken living room, 1962 case study house",
        "description": "Archival photo of a sunken conversation pit living room from a 1962 case study house.",
        "image": "https://i.pinimg.com/736x/7f/1e/33/case-study-house.jpg",
        "pinner": {
          "username": "modernarchive",
          "displayName": "Modern Archive"
        },
        "boardName": "Retro Interiors",
        "domain": "modernarchive.com",
        "saveCount": 12300
      },
      {
        "id": "554098271640023841",
        "url": "https://www.pinterest.com/pin/554098271640023841/",
        "title": "DIY mid-century TV console makeover",
        "description": "Step by step refinish of a thrifted teak console with new hairpin legs.",
        "image": "https://i.pinimg.com/736x/9b/44/12/tv-console-diy.jpg",
        "pinner": {
          "username": "thriftandtinker",
          "displayName": "Thrift & Tinker"
        },
        "boardName": "Furniture Flips",
        "domain": "thriftandtinker.com",
        "saveCount": 2190
      }
    ],
    "nextCursor": "QVFEc2ZncnRlaHRjS3ZaWA=="
  }
}

Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.

Référence

Une requête, une seule forme de réponse.

Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.

Dernière vérification : 2026-11-21 · disponibilité et latence mesurées sur 30d

Corps de la requête

JSON, envoyé à cet endpoint.

  • querystring

    mid-century living room

    Mot-clé, sujet, marque ou thème pour chercher sur Pinterest (p. ex. mid-century living room).

  • cursorstring

    Curseur de pagination opaque issu du nextCursor d’une réponse précédente. Omettez-le pour la première page.

  • limitinteger

    3

    Page size to ask for (1-20). Some sources return their whole page of about 20 pins whatever limit says: a page is never trimmed after the call, so nextCursor continues exactly where this response ended.

  • requireFieldsarray

    Facultatif ; omettez-le et le routage est inchangé, la source la moins chère répondant. Nommez les champs de sortie que cette requête doit pouvoir renvoyer, par exemple `description` or `videoUrl`, et elle n’est servie que par une source qui les renvoie tous. Les champs que vous ne nommez pas sont quand même renvoyés chaque fois que la source qui répond les possède. Cela peut augmenter votre prix : quand la source la moins chère ne peut pas renvoyer un champ nommé, une source plus chère répond, et vous êtes facturé à son prix. Un champ nommé peut quand même être null sur un pin qui en est réellement dépourvu. Nommer une combinaison qu’aucune source unique ne renvoie ensemble est refusé comme entrée invalide, sans frais.

  • typeenum

    Type de résultats à renvoyer : tous les pins, seulement les pins vidéo, les tableaux ou les profils (p. ex. videos).

Vous envoyez. Un petit corps JSON. Les valeurs affichées sont des exemples à remplacer par les vôtres.

Réponse

JSON, une valeur d’exemple par champ.

each itemdata.items[]

Matching Pinterest records: pin or board title, description, image/video URL, creator, and link. Populated whenever the provider has data for the entity.

  • authorstring

    Username (handle) of the account that saved the pin.

  • authorNamestring

    Display name of the account that saved the pin.

  • descriptionstringpeut exiger

    A sunlit living room mixing walnut furniture, a boucle sofa, and brass accents for a warm mid-century look.

    The pin's full description text, or null when the source does not provide it.

  • idstring

    998271640023841902

  • imagestring

    https://i.pinimg.com/736x/4a/2b/9c/midcentury-living-room.jpg

    URL of the pin's full-size image; for a video pin, its cover image.

  • titlestring

    Warm mid-century living room with walnut credenza

    Pin title, or the pin's description when the pin has no title.

  • urlstring

    https://www.pinterest.com/pin/998271640023841902/

    Populated whenever the provider has data for the entity.

  • videoUrlstringpeut exiger

    Streaming (HLS) URL of the pin's video, or null when the pin is not a video or the source does not provide it.

datadata
  • nextCursorstring

    QVFEc2ZncnRlaHRjS3ZaWA==

    Opaque cursor for the next page of results, or null/empty when there are no more. Pass it back as cursor to continue.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Vous recevez. Des champs nommés et typés, dans la même forme quelle que soit la source qui répond.

FAQ

À propos de l’API Pinterest Recherche

L’API Pinterest Recherche d’AnyAPI renvoie des données Pinterest en JSON normalisé à partir d’un appel POST à /v1/run/pinterest.search. Cherchez sur Pinterest par mot-clé et obtenez des résultats de pins, vidéos, tableaux ou profils avec titres, images et liens. AnyAPI route chaque requête sur 2 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 0,80 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 100,0% des appels Pinterest Recherche passés par AnyAPI ont réussi, avec un temps de réponse médian de 4,2 secondes, sur 29 405 appels mesurés.

Elle coûte à partir de 0,80 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Vous alimentez un portefeuille en USD et chaque appel le débite. Certaines requêtes échouées financées par le portefeuille entraînent des frais de traitement que nous répercutons au prix coûtant, sans marge ; la réponse d’erreur indique le montant facturé.

Cherchez sur Pinterest par mot-clé et obtenez des résultats de pins, vidéos, tableaux ou profils avec titres, images et liens. La réponse est du JSON normalisé avec la même enveloppe que celle de tous les endpoints AnyAPI, donc analyser un second endpoint revient à changer l’URL et rien d’autre.

Ces 30 derniers jours, 100,0% des appels Pinterest Recherche passés par AnyAPI ont réussi, avec un temps de réponse médian de 4,2 secondes, sur 29 405 appels mesurés. Ce sont les propres mesures d’AnyAPI du trafic passant par la passerelle, recalculées en continu, et non un objectif de niveau de service publié.

Oui. Un nouveau compte AnyAPI démarre avec 0,10 $US de solde gratuit, sans carte, ce qui couvre 125 appels Pinterest Recherche à 0,0008 $US chacun.

AnyAPI interroge la suivante de ses 2 sources dans la même requête, la moins chère d’abord, donc la panne d’une source ne fait pas échouer votre appel.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/pinterest.search avec votre clé AnyAPI dans un en-tête « Authorization: Bearer » et l’entrée en corps JSON. La même clé et le même portefeuille fonctionnent sur tous les endpoints AnyAPI.

Non. Vous ajoutez des dollars US à un solde AnyAPI prépayé unique et chaque requête le débite. Il n’y a ni forfait mensuel ni minimum, et le même solde paie tous les endpoints AnyAPI.

Oui. Installez @getanyapi/sdk depuis npm pour TypeScript ou getanyapi depuis pip pour Python. Les deux appellent chaque endpoint AnyAPI avec la même clé, et n’importe quel client HTTP fonctionne aussi.

Oui. Un agent peut se connecter au serveur MCP d’AnyAPI à https://api.getanyapi.com/mcp, ou créer sa propre clé d’essai gratuit avec un seul POST non authentifié vers https://api.getanyapi.com/agent/signup et appeler cet endpoint en HTTP.