📌 Pinterest Intelligence — Pin Search, Images, Pinner Profiles & Board Data

🔗 View on Apify Store | 🇺🇸 English | 🇧🇷 Português

Search Pinterest pins by keyword and extract full pin data including titles, descriptions, SEO alt text, high-resolution images, pinner profiles, board info, and content type classification. Uses Pinterest's internal search API for fast, reliable extraction. Pure HTTP — no browser or API key needed.

✨ Features

• Keyword search — Search any topic on Pinterest and get matching pins
• High-res images — Original quality images with dimensions and dominant color
• SEO alt text — Pinterest-generated rich descriptions for each pin
• Pinner profiles — Creator name, username, follower count, verified merchant status
• Board info — Board name and URL for each pin
• Content type detection — Identifies video pins, idea pins, and promoted pins
• Link extraction — External link URLs and domains from pins
• Anti-placeholder guardrails — Every result validated against placeholder patterns
• Pure HTTP — Uses Pinterest internal BaseSearchResource API, no browser needed
• Pagination — Bookmark-based cursor, up to 100 pins per query
• Deduplication — Seen pin IDs tracked across queries to avoid duplicates

📥 Input

Parameter	Type	Required	Default	Description
searchQueries	string[]	Yes	—	Keywords to search for on Pinterest (1-20 queries)
maxPinsPerQuery	integer	No	25	Maximum number of pins to extract per search query (1-100)
proxyConfiguration	object	No	Apify Proxy	Proxy settings. Pinterest may block datacenter IPs — residential proxy recommended for large runs

Input Example

{
  "searchQueries": [
    "home decor ideas",
    "healthy recipes",
    "minimalist fashion"
  ],
  "maxPinsPerQuery": 50
}

📤 Output

Field	Type	Description
pinId	string	Pinterest pin ID
pinUrl	string	Direct URL to the pin page
title	string	Pin title
description	string	Pin description text
seoAltText	string	Pinterest-generated SEO alt text (rich, detailed)
imageUrl	string	Highest resolution image URL available
imageWidth	number	Image width in pixels
imageHeight	number	Image height in pixels
isVideo	boolean	Whether the pin contains video content
isIdeaPin	boolean	Whether the pin is an idea pin (story pin)
dominantColor	string	Dominant color hex code (e.g., "#e8dfd4")
isPromoted	boolean	Whether the pin is a promoted (ad) pin
linkUrl	string	External link URL from the pin
linkDomain	string	External link domain name
pinnerName	string	Creator's full name
pinnerUsername	string	Creator's Pinterest username
pinnerFollowers	number	Creator's follower count
pinnerImageUrl	string	Creator's profile image URL
pinnerIsVerifiedMerchant	boolean	Whether the pinner is a verified merchant
boardName	string	Board name where the pin was saved
boardUrl	string	Full board URL
searchQuery	string	Original search query that matched this pin
platform	string	Always "pinterest"
scrapedAt	string	ISO 8601 timestamp of when the pin was scraped

Output Example

{
  "pinId": "314126142771856729",
  "pinUrl": "https://pinterest.com/pin/314126142771856729/",
  "title": "Modern Living Room Ideas for Small Spaces",
  "description": "Transform your small living room with these 15 modern design ideas. Minimalist furniture, smart storage solutions, and neutral color palettes that make any space feel larger.",
  "seoAltText": "A modern living room with a light grey sectional sofa, floating wooden shelves, indoor plants, and large windows with natural light streaming in",
  "imageUrl": "https://i.pinimg.com/originals/a3/5b/c8/a35bc8e4f27d912c6b1a847e3c5f9d21.jpg",
  "imageWidth": 1200,
  "imageHeight": 1800,
  "isVideo": false,
  "isIdeaPin": false,
  "dominantColor": "#e8dfd4",
  "isPromoted": false,
  "linkUrl": "https://www.architecturaldigest.com/gallery/small-living-room-ideas",
  "linkDomain": "architecturaldigest.com",
  "pinnerName": "Architectural Digest",
  "pinnerUsername": "archdigest",
  "pinnerFollowers": 1284350,
  "pinnerImageUrl": "https://i.pinimg.com/75x75_RS/ab/cd/ef/abcdef1234567890.jpg",
  "pinnerIsVerifiedMerchant": true,
  "boardName": "Living Room Inspiration",
  "boardUrl": "https://pinterest.com/archdigest/living-room-inspiration/",
  "searchQuery": "home decor ideas",
  "platform": "pinterest",
  "scrapedAt": "2026-03-06T15:45:22.987Z"
}

📋 Use Cases

• Content Inspiration — Discover trending visual content ideas in any niche
• Visual Trend Analysis — Track which aesthetics, colors, and styles are popular
• Competitor Research — Analyze what pins competitors are creating and promoting
• SEO Research — Extract Pinterest-generated alt text for keyword insights
• E-commerce Research — Find product pins with external links and merchant profiles
• Influencer Discovery — Identify top pinners by follower count in your niche
• Ad Intelligence — Monitor promoted pins in your category

❓ FAQ

Q: Does this actor extract save/repin counts for each pin? A: No. Pinterest's search API does not return save or repin counts. Those metrics require individual pin page fetches, which are not included for cost efficiency. The actor focuses on search-based discovery data.

Q: How many pins can I get per run? A: Up to 20 search queries per run, with up to 100 pins per query. The actor paginates up to 4 pages of results per query (25 pins per page). Total theoretical maximum is 2,000 pins per run.

Q: Do I need a Pinterest API key or account? A: No. The actor uses Pinterest's internal BaseSearchResource API via HTTP requests with session cookies. No API key, developer account, or Pinterest login is required.

Q: What happens if Pinterest blocks my requests? A: The actor handles 429 (rate limit) and 403 (forbidden) responses with automatic retries and exponential backoff. For large runs, use a residential proxy configuration to avoid IP-based blocking.

Q: Can I search in languages other than English? A: Yes. Pinterest returns results based on the search query language. Search in Portuguese, Spanish, French, or any other language and get relevant pins in that language.

💰 Pricing

This actor uses Pay Per Event (PPE) pricing:

Metric	Cost
pin-scraped	$0.05 per pin

Example: scraping 3 queries x 25 pins = 75 pins = $3.75

🔗 Related Actors

• Google Trends Scraper — Validate trending topics from Pinterest
• eBay Product Scraper — Find products discovered on Pinterest
• Instagram Reels Scraper — Cross-platform visual content analysis
• Influencer Discovery Agent — Find YouTube creators in the same niche

📝 Changelog

v1.0 (Current)

• Keyword search via Pinterest internal BaseSearchResource API
• Full pin data extraction (title, description, SEO alt text, images)
• High-resolution image URLs with dimensions and dominant color
• Pinner profiles (name, username, followers, verified merchant)
• Board info (name, URL)
• Content type detection (video, idea pin, promoted)
• External link extraction (URL + domain)
• Pagination with bookmark-based cursor (up to 100 pins per query)
• Session establishment with CSRF token handling
• Anti-placeholder guardrails + deduplication
• Rate limit handling with exponential backoff
• PPE billing integration

---

📌 Pinterest Intelligence — Busca de Pins, Imagens, Perfis de Pinners e Dados de Boards

🔗 Ver na Apify Store | 🇺🇸 English | 🇧🇷 Português

Busque pins no Pinterest por palavra-chave e extraia dados completos incluindo títulos, descrições, texto alt SEO, imagens em alta resolução, perfis de pinners, informações de boards e classificação de tipo de conteúdo. Usa a API interna de busca do Pinterest para extração rápida e confiável. HTTP puro — sem browser ou chave de API.

✨ Funcionalidades

• Busca por palavra-chave — Busque qualquer tópico no Pinterest e obtenha pins correspondentes
• Imagens em alta resolução — Qualidade original com dimensões e cor dominante
• Texto alt SEO — Descrições ricas geradas pelo Pinterest para cada pin
• Perfis de pinners — Nome do criador, username, número de seguidores, status de merchant verificado
• Informação do board — Nome e URL do board de cada pin
• Detecção de tipo de conteúdo — Identifica pins de vídeo, idea pins e pins promovidos
• Extração de links — URLs externos e domínios dos pins
• Guardrails anti-placeholder — Todo resultado validado contra padrões falsos
• HTTP puro — Usa API interna BaseSearchResource do Pinterest, sem browser
• Paginação — Cursor baseado em bookmark, até 100 pins por query
• Deduplicação — IDs de pins rastreados entre queries para evitar duplicatas

📥 Entrada

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
searchQueries	string[]	Sim	—	Palavras-chave para busca no Pinterest (1-20 queries)
maxPinsPerQuery	inteiro	Não	25	Número máximo de pins por query de busca (1-100)
proxyConfiguration	objeto	Não	Apify Proxy	Configuração de proxy. Pinterest pode bloquear IPs de datacenter — proxy residencial recomendado para grandes volumes

Exemplo de Entrada

{
  "searchQueries": [
    "decoração de casa",
    "receitas saudáveis",
    "moda minimalista"
  ],
  "maxPinsPerQuery": 50
}

📤 Saída

Campo	Tipo	Descrição
pinId	string	ID do pin no Pinterest
pinUrl	string	URL direta para a página do pin
title	string	Título do pin
description	string	Texto de descrição do pin
seoAltText	string	Texto alt SEO gerado pelo Pinterest (rico e detalhado)
imageUrl	string	URL da imagem na maior resolução disponível
imageWidth	número	Largura da imagem em pixels
imageHeight	número	Altura da imagem em pixels
isVideo	boolean	Se o pin contém conteúdo de vídeo
isIdeaPin	boolean	Se o pin é um idea pin (story pin)
dominantColor	string	Código hex da cor dominante (ex: "#e8dfd4")
isPromoted	boolean	Se o pin é promovido (anúncio)
linkUrl	string	URL do link externo do pin
linkDomain	string	Nome do domínio do link externo
pinnerName	string	Nome completo do criador
pinnerUsername	string	Username do criador no Pinterest
pinnerFollowers	número	Contagem de seguidores do criador
pinnerImageUrl	string	URL da foto de perfil do criador
pinnerIsVerifiedMerchant	boolean	Se o pinner é um merchant verificado
boardName	string	Nome do board onde o pin foi salvo
boardUrl	string	URL completa do board
searchQuery	string	Query de busca original que encontrou este pin
platform	string	Sempre "pinterest"
scrapedAt	string	Timestamp ISO 8601 de quando o pin foi extraído

Exemplo de Saída

{
  "pinId": "314126142771856729",
  "pinUrl": "https://pinterest.com/pin/314126142771856729/",
  "title": "Modern Living Room Ideas for Small Spaces",
  "description": "Transform your small living room with these 15 modern design ideas. Minimalist furniture, smart storage solutions, and neutral color palettes that make any space feel larger.",
  "seoAltText": "A modern living room with a light grey sectional sofa, floating wooden shelves, indoor plants, and large windows with natural light streaming in",
  "imageUrl": "https://i.pinimg.com/originals/a3/5b/c8/a35bc8e4f27d912c6b1a847e3c5f9d21.jpg",
  "imageWidth": 1200,
  "imageHeight": 1800,
  "isVideo": false,
  "isIdeaPin": false,
  "dominantColor": "#e8dfd4",
  "isPromoted": false,
  "linkUrl": "https://www.architecturaldigest.com/gallery/small-living-room-ideas",
  "linkDomain": "architecturaldigest.com",
  "pinnerName": "Architectural Digest",
  "pinnerUsername": "archdigest",
  "pinnerFollowers": 1284350,
  "pinnerImageUrl": "https://i.pinimg.com/75x75_RS/ab/cd/ef/abcdef1234567890.jpg",
  "pinnerIsVerifiedMerchant": true,
  "boardName": "Living Room Inspiration",
  "boardUrl": "https://pinterest.com/archdigest/living-room-inspiration/",
  "searchQuery": "home decor ideas",
  "platform": "pinterest",
  "scrapedAt": "2026-03-06T15:45:22.987Z"
}

📋 Casos de Uso

• Inspiração de Conteúdo — Descubra ideias de conteúdo visual em alta em qualquer nicho
• Análise de Tendências Visuais — Acompanhe quais estéticas, cores e estilos são populares
• Pesquisa de Concorrentes — Analise quais pins concorrentes estão criando e promovendo
• Pesquisa de SEO — Extraia texto alt gerado pelo Pinterest para insights de palavras-chave
• Pesquisa E-commerce — Encontre pins de produtos com links externos e perfis de merchants
• Descoberta de Influenciadores — Identifique top pinners por número de seguidores no seu nicho
• Inteligência de Anúncios — Monitore pins promovidos na sua categoria

❓ Perguntas Frequentes

P: Este actor extrai contagem de saves/repins de cada pin? R: Não. A API de busca do Pinterest não retorna contagens de saves ou repins. Essas métricas exigem buscas individuais em páginas de pins, que não estão incluídas por eficiência de custo. O actor foca em dados de descoberta baseados em busca.

P: Quantos pins posso obter por execução? R: Até 20 queries de busca por execução, com até 100 pins por query. O actor pagina até 4 páginas de resultados por query (25 pins por página). O máximo teórico total é de 2.000 pins por execução.

P: Preciso de uma chave de API ou conta do Pinterest? R: Não. O actor usa a API interna BaseSearchResource do Pinterest via requisições HTTP com cookies de sessão. Nenhuma chave de API, conta de desenvolvedor ou login do Pinterest é necessário.

P: O que acontece se o Pinterest bloquear minhas requisições? R: O actor trata respostas 429 (rate limit) e 403 (proibido) com retentativas automáticas e backoff exponencial. Para grandes volumes, use configuração de proxy residencial para evitar bloqueio baseado em IP.

P: Posso buscar em idiomas diferentes do inglês? R: Sim. O Pinterest retorna resultados baseados no idioma da query de busca. Busque em português, espanhol, francês ou qualquer outro idioma e obtenha pins relevantes nesse idioma.

💰 Preços

Este actor usa precificação Pay Per Event (PPE):

Métrica	Custo
pin-scraped	$0.05 por pin

Exemplo: extrair 3 queries x 25 pins = 75 pins = $3.75

🔗 Actors Relacionados

• Google Trends Scraper — Valide tópicos em alta do Pinterest
• eBay Product Scraper — Encontre produtos descobertos no Pinterest
• Instagram Reels Scraper — Análise de conteúdo visual cross-platform
• Influencer Discovery Agent — Encontre criadores do YouTube no mesmo nicho

📝 Changelog

v1.0 (Atual)

• Busca por keyword via API interna BaseSearchResource do Pinterest
• Extração completa de dados (título, descrição, texto alt SEO, imagens)
• URLs de imagens em alta resolução com dimensões e cor dominante
• Perfis de pinners (nome, username, seguidores, merchant verificado)
• Informação de boards (nome, URL)
• Detecção de tipo de conteúdo (vídeo, idea pin, promovido)
• Extração de links externos (URL + domínio)
• Paginação com cursor baseado em bookmark (até 100 pins por query)
• Estabelecimento de sessão com tratamento de token CSRF
• Guardrails anti-placeholder + deduplicação
• Tratamento de rate limit com backoff exponencial
• Integração com cobrança PPE