API para Pinterest: Buscar
Busque no Pinterest por palavra-chave e receba resultados de pins, vídeos, pastas ou perfis com títulos, imagens e links.
US$ 0,80/mil req., pague por requisição, sem assinatura.
Warm mid-century living room with walnut credenza
Living Room Ideas
{"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 campos a mais}
Preços e provedores
Preços do endpoint Buscar da API para Pinterest: uma API, 2 provedores intercambiáveis
O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.
Teste
Obtenha Buscar do Pinterest em uma só requisição
Este exemplo mostra 9 de 13 campos. Ver todos os campos
{
"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=="
}
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Uma requisição, um formato de resposta.
Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.
Última verificação em 2026-11-14 · disponibilidade e latência medidas em 30d
Corpo da requisição
JSON, enviado via POST para este endpoint.
- querystring
mid-century living room
Palavra-chave, tópico, marca ou tema a buscar no Pinterest (ex.: mid-century living room).
- cursorstring
Cursor de paginação opaco do nextCursor de uma resposta anterior. Omita na primeira página.
- 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
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `description` ou `videoUrl`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir null em um pin que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
- typeenum
Tipo de resultado a retornar: todos os pins, só pins de vídeo, pastas ou perfis (ex.: videos).
Resposta
JSON, um valor de exemplo por campo.
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.
- descriptionstringpode ser exigido
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.
- videoUrlstringpode ser exigido
Streaming (HLS) URL of the pin's video, or null when the pin is not a video or the source does not provide it.
- 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.
- 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.
Dúvidas frequentes
Sobre o endpoint Buscar da API para Pinterest
O endpoint Buscar da AnyAPI para Pinterest retorna dados de Pinterest em JSON normalizado com uma chamada POST para /v1/run/pinterest.search. Busque no Pinterest por palavra-chave e receba resultados de pins, vídeos, pastas ou perfis com títulos, imagens e links. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,80 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para Pinterest feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 4,1 segundos, em 14.347 chamadas medidas.