Pinterest Data Extractor — Pins, Boards, Profiles, Keywords

What is Pinterest Data Extractor — Pins, Boards, Profiles, Keywords?

Pinterest Data Extractor turns Pinterest URLs and search terms into one typed dataset of pins, boards, profiles and keyword records, with the input type detected for you. Pin rows carry the pin URL, full-size image and video download URLs, dimensions and dominant color, plus title, saves, board and creator when Pinterest shows them. Board and profile rows add counts, owner and bio; keyword rows list the top pin IDs for a search. Content marketers, SEO researchers, e-commerce teams and AI agents use it to study a niche visually without a Pinterest login.

Why marketers use this Pinterest extractor

• One input box for everything. Pin, board and profile URLs go in startUrls; topics go in searchTerms.
• Download-ready media. Every pin row has download_image_url, and video pins add download_video_url.
• Typed rows. A dataType field marks each row as pin, board, profile or keyword, so one dataset can feed several reports.
• Keyword snapshot per search. Each search term adds a keyword row with top_pin_ids and result_count for trend tracking.
• Focused output when you want it. resultsType keeps a single record type, such as only profiles.

Best fit for this Actor

• Best fit for mood boards, niche research, competitor brand pages and building image sets from public Pinterest content.
• Use searchTerms for topic research and startUrls for known brands, boards or pins.
• When you need the video files themselves from video pins, continue with Pinterest Video Downloader — MP4 + HLS Links.
• For every pin on a set of boards, pass the board URLs to Pinterest Board Scraper — Board Pins & User Boards.

What people and AI agents ask this Actor to do

Show me the top Pinterest pins for "home office decor" with image links. Pull Nike's Pinterest profile and its boards. Collect the images from this board for a mood board. Which pins come up first for "boho wedding" this month?

Request	Input to send
Pins for a topic	{"searchTerms": ["home office decor"], "maxItems": 50}
A brand profile	{"startUrls": ["https://www.pinterest.com/nike/"], "resultsType": "profiles"}
A board and its pins	{"startUrls": ["https://www.pinterest.com/nike/nike-running/"]}
One pin plus similar pins	{"startUrls": ["https://www.pinterest.com/pin/241294492639523463/"], "includeRelatedPins": true}
Keyword snapshot only	{"searchTerms": ["boho wedding"], "resultsType": "keywords"}

Example workflow: from a topic to a monthly visual trend report

A home-decor brand's content lead starts with five topics in searchTerms, such as home office decor and small balcony ideas, with maxItems at 30. The dataset returns pin rows with pin_url, download_image_url, dominant_color and image size, plus one keyword row per topic. She exports the images into a review board, compares the dominant colors and styles with last month's run, and schedules the same input monthly so the top_pin_ids lists show which pins hold the top spots over time.

Input

{
  "searchTerms": ["home office decor"],
  "startUrls": [],
  "resultsType": "auto",
  "maxItems": 50,
  "includeRelatedPins": false
}

Field	Type	What it controls
startUrls	array	Pinterest pin, board or profile URLs; type detected per URL
searchTerms	array	Keywords or topics to search
resultsType	string	auto, pins, boards, profiles or keywords. Default auto
maxItems	integer	Records per input. Default 50
includeRelatedPins	boolean	For pin URLs, add Pinterest's similar pins. Default false
proxyConfiguration	object	Apify Proxy; residential by default

Output

dataType	Key fields
pin	pin_id, pin_url, image_url, download_image_url, image_width, image_height, dominant_color, is_video, video_url, download_video_url, title, description, save_count, comment_count, hashtags, link, source_domain, price, board_name, board_url, pinner_username, pinner_display_name, pinner_follower_count, is_related, created_at
board	board_id, name, description, pin_count, follower_count, section_count, cover_image_url, owner_username
profile	username, full_name, bio, profile_url, profile_image_url, follower_count, following_count, pin_count, board_count, monthly_views, is_verified, website
keyword	query, related_queries, top_pin_ids, result_count, search_url

Every row also carries source_url and scraped_at. Search results deliver the image fields reliably; title, saves, board and creator fields fill in when Pinterest exposes them for that pin, and pin URLs in startUrls give the fullest pin rows.

A pin row from a search:

{
  "dataType": "pin",
  "pin_id": "1104789352375137849",
  "title": null,
  "description": null,
  "pin_url": "https://www.pinterest.com/pin/1104789352375137849/",
  "image_url": "https://i.pinimg.com/originals/9d/b0/a3/9db0a318ebab8d19e0839b05d267b4b3.jpg",
  "download_image_url": "https://i.pinimg.com/originals/9d/b0/a3/9db0a318ebab8d19e0839b05d267b4b3.jpg",
  "image_width": 736,
  "image_height": 1097,
  "dominant_color": "#b7a791",
  "is_video": false,
  "video_url": null,
  "download_video_url": null,
  "save_count": null,
  "comment_count": null,
  "hashtags": [],
  "link": null,
  "source_domain": null,
  "price": null,
  "board_name": null,
  "board_url": null,
  "pinner_username": null,
  "pinner_display_name": null,
  "pinner_follower_count": null,
  "is_related": false,
  "created_at": null,
  "scraped_at": "2026-10-01T20:55:36.761Z",
  "source_url": "https://www.pinterest.com/search/pins/?q=home%20office%20decor&rs=typed"
}

The keyword row for the same search:

{
  "dataType": "keyword",
  "query": "home office decor",
  "related_queries": [],
  "top_pin_ids": ["1104789352375137849", "568790627961315751", "15621929953067656"],
  "result_count": 5,
  "search_url": "https://www.pinterest.com/search/pins/?q=home%20office%20decor&rs=typed",
  "scraped_at": "2026-10-01T20:55:57.979Z",
  "source_url": "https://www.pinterest.com/search/pins/?q=home%20office%20decor&rs=typed"
}

Pricing

This Actor uses Pay per event plus Apify platform usage. Each run charges one Actor Start event, one Pin extracted event per pin row, and one Entity extracted event per board, profile or keyword row. Platform usage, including residential proxy traffic, is billed on top at Apify's standard rates. The live Pricing tab on this page shows the current event prices.

Worked example: one search term with maxItems at 50 costs up to 50 Pin extracted events, one Entity extracted event for the keyword row, and one Actor Start event. A single profile URL with resultsType set to profiles costs one Entity extracted event plus the start event.

API example

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~pinterest-data-extractor/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["home office decor"], "maxItems": 20}'

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("khadinakbar/pinterest-data-extractor").call(run_input={
    "searchTerms": ["small balcony ideas"],
    "maxItems": 30,
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    if row["dataType"] == "pin":
        print(row["pin_url"], row["download_image_url"], row["dominant_color"])

Use with AI agents (MCP)

Connect the Actor through Apify MCP in Claude, ChatGPT or Cursor and ask:

Find 20 Pinterest pins for "minimalist kitchen" and give me each pin link with its image download URL and dominant color.

The agent sends searchTerms and maxItems, reads rows with get-dataset-items, and filters on dataType. It should cite pin_url, source_url and scraped_at, and treat null fields as "not shown for this pin". Pins and entities bill per row, so a tight maxItems keeps agent requests small and predictable.

Best results

Starting situation	Helpful action	Expected outcome
A broad topic	Use two to four specific phrases in searchTerms	Focused pin sets per phrase
A known brand	Paste the profile URL and set resultsType to profiles	One profile row
You need full pin details	Paste the pin URL in startUrls	The fullest pin row
You need similar ideas	Add includeRelatedPins to a pin URL	The pin plus similar pins
Monthly trend tracking	Schedule the same searchTerms and compare top_pin_ids	A view of which pins hold top spots

Builder's note

I built this as one extractor with a dataType on every row because Pinterest research rarely stays on one object type: a search leads to a pin, the pin leads to a board, the board leads to a creator. I chose to return the original-size image URL on every pin so the dataset is immediately useful for mood boards and image sets.

FAQ

Do I need a Pinterest account?

No. The Actor reads public Pinterest pages without a login.

Can I download the images?

Yes. Use download_image_url on each pin row, and download_video_url for video pins.

How do I keep only one record type?

Set resultsType to pins, boards, profiles or keywords.

Responsible use

This Actor collects public Pinterest content. Pins and images are often copyrighted by their creators, and profile details can be personal data under laws such as the GDPR and CCPA, so use the data for research and reference, credit creators, and respect Pinterest's terms of service. Pinterest is a trademark of its owner, and this independent Actor is not affiliated with it. For questions, open a ticket in the Issues tab.