Skip to content
BranchesTags

Repository files navigation

Pinterest Board Scraper — Web Scraping, Data Extraction, E-Commerce Intelligence

Extract Pinterest boards, pins, and visual trends for e-commerce product research, influencer marketing, and visual content intelligence. No API key required.

Apify Store: https://apify.com/red.cars/pinterest-board-scraper Pricing: $0.01–$0.05 per run (Pay-per-event, PPE) MCP Available: Yes — exposes tools for AI agent integration

What This Actor Does

Pinterest Board Scraper extracts public Pinterest boards, pins, follower analytics, and visual trends at scale. It returns clean structured data including pin images, descriptions, save counts, board metadata, and engagement metrics. Built for e-commerce product discovery, visual trend research, and influencer identification.

Search intent keywords: "Pinterest scraper API", "Pinterest board extraction", "visual trend research tool", "e-commerce product discovery", "Pinterest analytics scraper"

Who It's For

  • E-commerce brands discovering trending products and visual styles
  • Marketers researching Pinterest visual content strategies
  • Influencer marketers identifying potential partners by board engagement
  • Product teams gathering visual inspiration from top-performing Pinterest content
  • AI agents building visual content knowledge bases

Quick Start

# Option 1: Apify Console (no code)
# Open https://apify.com/red.cars/pinterest-board-scraper
# Click "Run" and configure input

# Option 2: API (cURL)
curl -X POST https://api.apify.com/v2/acts/red.cars~pinterest-board-scraper/runs?token=*** \
  -H "Content-Type: application/json" \
  -d '{"input": {"boardUrls": ["https://pinterest.com/pinterest/home-decor/"]}}'

# Option 3: Node.js
const Apify = require('apify');
const actor = new Apify.Actor('red.cars/pinterest-board-scraper');
await actor.call({ boardUrls: ['https://pinterest.com/pinterest/home-decor/'] });

# Option 4: MCP (AI agents) — RECOMMENDED
# Configure @apify/mcp-server in your AI client
# Then ask: "Find trending home decor pins from recent boards"

Smoke Test (Free, <5 seconds)

# Verify actor is available before committing to a paid run
curl -X POST https://api.apify.com/v2/acts/red.cars~pinterest-board-scraper/runs?token=*** \
  -d '{"input": {"checkOnly": true}}'

Features

  • Board extraction — Complete board metadata including follower counts and pin totals
  • Pin data — High-resolution image URLs, descriptions, links, and save counts
  • User profiles — Extract all boards from Pinterest user profiles
  • Keyword search — Find boards by search terms (home decor, fashion trends)
  • Analytics metrics — Board engagement and follower analytics
  • Proxy rotation — Datacenter (faster) or Residential (more reliable) proxy options
  • Multi-format output — JSON, CSV, or markdown for downstream processing
  • Zero-result guard — No charge when extraction returns no results

MCP Tools

AI agents discover and call this actor via Model Context Protocol.

Install the Apify MCP server:

npm install -g @apify/mcp-server

Add to your MCP configuration:

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["@apify/mcp-server"]
    }
  }
}

Connect to Apify MCP: https://apify.actor/mcp

Tool: pinterest-board-extract

What it does: Extract pins, metadata, and analytics from Pinterest boards by URL.

Input parameters:

Parameter Type Required Description
boardUrls array Yes Pinterest board URLs to extract
maxPinsPerBoard integer No Maximum pins per board (default: 5, max: 250)
includeImages boolean No Extract high-res image URLs (default: true)
extractMetrics boolean No Calculate engagement metrics (default: true)

Example MCP call:

{
  "name": "pinterest-board-extract",
  "description": "Extract pins, metadata, and analytics from Pinterest boards by URL.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "boardUrls": {
        "type": "array",
        "description": "Pinterest board URLs"
      },
      "maxPinsPerBoard": {
        "type": "integer",
        "description": "Max pins per board (1-250, default: 5)"
      },
      "includeImages": {
        "type": "boolean",
        "description": "Extract image URLs"
      }
    },
    "required": ["boardUrls"]
  }
}

Cost: $0.01–$0.03 per board extraction (included in Apify PPE pricing)

Tool: pinterest-user-boards

What it does: Extract all boards from a Pinterest user profile.

Input parameters:

Parameter Type Required Description
userUrls array Yes Pinterest user profile URLs
maxPinsPerBoard integer No Maximum pins per board (default: 5)

Example MCP call:

{
  "name": "pinterest-user-boards",
  "description": "Extract all boards from a Pinterest user profile.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "userUrls": {
        "type": "array",
        "description": "Pinterest profile URLs"
      }
    },
    "required": ["userUrls"]
  }
}

Cost: $0.02 per user profile

Tool: pinterest-search

What it does: Search for Pinterest boards by keyword.

Input parameters:

Parameter Type Required Description
searchTerms array Yes Keywords to search (e.g., "home decor", "fashion trends")
maxResults integer No Maximum boards to return (default: 10)

Example MCP call:

{
  "name": "pinterest-search",
  "description": "Search for Pinterest boards by keyword.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "searchTerms": {
        "type": "array",
        "description": "Search keywords"
      }
    },
    "required": ["searchTerms"]
  }
}

Cost: $0.01 per search

Pricing

This actor uses Apify's Pay-Per-Event (PPE) model — you are charged per result returned. No charge for queries that return zero results.

Event Type Price Description
Board extraction $0.01–$0.03 Per board extracted
User profile extraction $0.02 Per user profile
Keyword search $0.01 Per search query
Image URL extraction $0.005 Per image URL

Proxy options: Datacenter (standard speed) or Residential (higher reliability, slight premium)

Free tier: 30 minutes compute/month, 100MB storage Paid plans: Starter from $49/month for higher compute limits

Input Parameters

Parameter Type Required Default Description
boardUrls array No — Pinterest board URLs to extract
userUrls array No — Pinterest user profile URLs
searchTerms array No — Keywords to search boards
maxPinsPerBoard integer No 5 Maximum pins per board (max: 250)
proxyType enum No RESIDENTIAL DATACENTER or RESIDENTIAL
includeImages boolean No true Extract high-res image URLs
extractMetrics boolean No true Calculate engagement metrics
debugMode boolean No false Health check mode
checkOnly boolean No false Free smoke test — no charge

Output

Board Extraction Response

{
  "results": [
    {
      "boardId": "123456789",
      "name": "Home Decor Inspiration",
      "url": "https://pinterest.com/username/home-decor/",
      "pinCount": 842,
      "followerCount": 12500,
      "owner": "username",
      "isSecret": false,
      "pins": [
        {
          "pinId": "987654321",
          "imageUrl": "https://i.pinimg.com/400x/image.jpg",
          "link": "https://example.com/product",
          "description": "Modern farmhouse living room idea",
          "savesCount": 234,
          "createdAt": "2026-03-15T10:30:00Z"
        }
      ],
      "analytics": {
        "avgSavesPerPin": 156,
        "engagementRate": 0.045
      },
      "scrapedAt": "2026-04-10T12:00:00Z"
    }
  ]
}

Use Cases

Use Case 1: E-Commerce Product Discovery

Find trending products by extracting boards in your niche:

{
  "input": {
    "searchTerms": ["modern furniture", "home organization"],
    "maxPinsPerBoard": 50,
    "extractMetrics": true
  }
}

Use Case 2: Visual Trend Research

Analyze color palettes and styles from top-performing pins:

{
  "input": {
    "boardUrls": ["https://pinterest.com/pinterest/home-decor/"],
    "maxPinsPerBoard": 100,
    "includeImages": true
  }
}

Use Case 3: Influencer Marketing

Identify influencers by board engagement:

{
  "input": {
    "userUrls": ["https://pinterest.com/interior.designer/"],
    "maxPinsPerBoard": 50,
    "extractMetrics": true
  }
}

Use Case 4: AI Agent Visual Knowledge Base

Build a visual content database for ML training:

// Pseudocode: AI agent Pinterest knowledge base
const boards = await callActor('red.cars/pinterest-board-scraper', {
  searchTerms: ['product photography', 'lifestyle'],
  maxPinsPerBoard: 100
});

// Store for visual similarity search
for (const board of boards) {
  for (const pin of board.pins) {
    await vectorStore.upsert({
      id: pin.pinId,
      imageUrl: pin.imageUrl,
      description: pin.description,
      boardName: board.name
    });
  }
}

Error Handling

Error Code Cause Fix
EXTRACTION_ERROR Board is private or not found Verify URL is public
NETWORK_ERROR Connectivity issue Check internet, retry with proxy
RATE_LIMIT_ERROR Too many requests Wait and retry, use residential proxy
VALIDATION_ERROR Invalid input parameters Review input schema, fix format

Zero-result handling: If no boards match your criteria, no charge is incurred under PPE billing.

Known Limitations

  • Private accounts: Cannot extract data from private boards without following
  • Rate limiting: Pinterest may temporarily block repeated requests from same IP
  • Data freshness: Extracted data reflects moment of extraction
  • Proxy requirements: High-security targets may require residential proxy
  • Content limits: Pinterest imposes limits on historical pin retrieval

Legal

Data Source: Pinterest (pinterest.com) — publicly available boards and pins

Terms of Service: This actor is provided for legitimate data collection purposes only. Users must comply with Pinterest's Terms of Service and applicable laws. Do not use extracted data for spam or unauthorized commercial purposes.

Attribution: When using Pinterest content, comply with their attribution requirements.

red.cars Intelligence Fleet — apify.com/red.cars

About

No description, website, or topics provided.

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages