Pinterest Details Scraper

Pinterest Details Scraper

A production‑ready Apify Actor for scraping structured Pinterest data using search queries and direct Pinterest URLs (pins, profiles, and boards).

This actor communicates with a backend API and is suitable for Apify Cloud, AWS Lambda, or any HTTP‑based automation workflow.

---

Product Features

• Keyword Search Scraping – Collect Pinterest pins using plain text search queries (no search URLs required)
• Direct URL Scraping – Scrape data directly from:
  • Pins
  • User profiles
  • Boards
• Automatic URL Classification – Actor automatically detects whether a URL is a pin, profile, or board
• Pin Details Extraction – Title, description, media URLs, engagement metrics, and metadata
• Optional Comments Scraping – Enable comments extraction for pin details
• User & Board Insights – Extract profile or board information with optional user-only mode
• Pagination Control – Limit results using max_items and end_page
• Secure API Access – Uses API key authentication via environment variables
• Retry & Error Handling – Automatic retries and safe failure handling
• Structured JSON Output – Clean, normalized output ready for analytics or storage

---

Instructions (How to Use)

Choose Your Input Method

You can use search queries, start URLs, or both.

Search Using Queries

Provide keywords to search Pinterest pins:

{
  "queries": ["home decor", "fashion ideas"]
}

---

Scrape Using Direct URLs

Provide Pinterest pin, profile, board, ideas, or search URLs:

{
  "start_urls": [
    "https://www.pinterest.com/pin/123456789/",
    "https://www.pinterest.com/username/",
    "https://www.pinterest.com/username/boardname/",
    "https://www.pinterest.com/search/pins/?q=Valentine%E2%80%99s%20Nail%20Art",
    "https://www.pinterest.com/ideas/beauty/935541271955/"
  ]
}

---

Configure Optional Settings

Fine-tune scraping behavior using optional parameters:

{
  "max_items": 50,
  "end_page": 2,
  "include_comments": true,
  "only_user_info": false
}

---

Run the Actor

• Save your input configuration
• Click Run in Apify Console
• Monitor logs for progress and errors

---

Access Results

• All scraped data is stored in the Apify Dataset
• Each search or URL produces a separate dataset item
• Data is returned in structured JSON format

Input

queries (optional)

List of keyword searches to discover Pinterest pins.

{
  "queries": ["home decor", "kitchen ideas"]
}

---

start_urls (optional)

List of direct Pinterest URLs to scrape.

Supported URL types

• Pin URL
• User profile URL
• Board URL
• Search URL
• Ideas URL

{
  "start_urls": [
    "https://www.pinterest.com/pin/123456789/",
    "https://www.pinterest.com/username/",
    "https://www.pinterest.com/username/boardname/",
    "https://www.pinterest.com/search/pins/?q=Valentine%E2%80%99s%20Nail%20Art",
    "https://www.pinterest.com/ideas/beauty/935541271955/"
  ]
}

---

include_comments (optional)

Include comments when scraping pin details.

• Type: boolean
• Default: false

---

only_user_info (optional)

Fetch only user profile information when scraping profiles or boards.

• Type: boolean
• Default: false

---

---

Output

Each result is stored as a separate dataset item.

Search Result Item

{
  "action": "search_pins",
  "query": "dress",
  "count": 15,
  "items": [
    {
      "pin_id": "846324954995310675",
      "url": "https://www.pinterest.com/pin/846324954995310675",
      "title": "Red Sequins V-neck Long 1920s Dress",
      "description": "Fabric: Sequins...",
      "link": "https://zapaka.com/products/red-sequins-v-neck-long-1920s-dress",
      "dominant_color": "#732e2b",
      "image_original": "https://i.pinimg.com/originals/48/a0/f5/48a0f5c04d109ff6856a2a918810798b.jpg",
      "image_236": "https://i.pinimg.com/236x/48/a0/f5/48a0f5c04d109ff6856a2a918810798b.jpg",
      "creator_username": "zapakaretro",
      "creator_fullname": "zapakaretro",
      "creator_profile_url": "https://www.pinterest.com/zapakaretro/",
      "is_promoted": false
    }
  ]
}

URL Result Item

{
  "action": "pin_detail",
  "items": [
    {
      "type": "pin",
      "url": "https://www.pinterest.com/pin/4222193395681386/",
      "id": "4222193395681386",
      "description": " ",
      "dominant_color": "#65625e",
      "created_at": "Sun, 23 Nov 2025 23:29:44 +0000",
      "repin_count": 179,
      "favorite_user_count": 0,
      "share_count": 12,
      "comment_count": 0,
      "images": {
        "236x": {
          "url": "https://i.pinimg.com/236x/55/86/54/558654c52902665a87ce83466ce0fb92.jpg"
        },
        "564x": {
          "url": "https://i.pinimg.com/564x/55/86/54/558654c52902665a87ce83466ce0fb92.jpg"
        },
        "orig": {
          "url": "https://i.pinimg.com/originals/55/86/54/558654c52902665a87ce83466ce0fb92.jpg"
        }
      },
      "board": {
        "name": "arreglo personal",
        "privacy": "public",
        "owner": {
          "username": "patriciagar0865",
          "full_name": "patricia garcia"
        }
      },
      "comments": []
    }
  ]
}

---

How It Works

1. Reads input from Apify (queries and start_urls)
2. Executes keyword searches for queries
3. Automatically classifies URLs as pin, profile, or board
4. Sends requests to the backend API
5. Normalizes responses and pushes data to the dataset

Error Handling

• Automatic retries for temporary failures
• Unsupported URLs are safely skipped
• Clear error logs via Actor.log

---

Use Cases

• Pinterest market & trend research
• Content inspiration & discovery
• Social media analytics
• Lead generation
• Data aggregation for dashboards

Support

• You are free to extend or customize this actor for your needs.