Pinterest Pin Search Scraper

Find public Pinterest pins by keyword and export each matching pin as a separate dataset row. Pinterest Pin Search Scraper collects titles, descriptions, image and video links, source websites, creators and board context from the public search results.

Start with a topic to build a content research sample, discover source websites or collect visual references. Choose the regular pin search or video search and a page budget for each query.

At a glance	Details
📥 Input	Enter keyword queries or canonical Pinterest /search/pins/?q= or /search/videos/?q= URLs. A search URL selects its own mode; plain text uses Mode.
📤 Output	One pin per success row with the input source retained
📄 Pagination	Result pages per input; page sizes and availability are controlled by Pinterest
🔐 Login required	No
⚡ Processing	Up to 5 HTTP requests concurrently; up to 5 attempts for temporary failures
💾 Delivery	One Apify dataset view with individual records and complete nested JSON

What the Pinterest pin search scraper collects 🔎

The Actor follows Pinterest search pagination and keeps useful pin records while excluding interface modules. Search results retain the original query so you can compare several topics in one export.

Data can include:

• Pin identifiers, canonical links, text and source-query context
• Images with available dimensions and variants
• Video variants or playlists when Pinterest supplies them
• External links, domains, creator and board fields
• Visible engagement and other optional pin metadata exposed in search

Mode	Input	Result
all	Keywords or /search/pins/ URL	Regular pin search
videos	Keywords or /search/videos/ URL	Video pin search

A search URL selects its own mode; plain text follows the mode input.

How to collect pin search results from Pinterest 🚀

1. Enter one or more supported inputs.
2. Set the page budget and any collection option you need.
3. Start the Actor.
4. Open the Pins dataset view and review success or failed rows.
5. Export the dataset or retrieve records from your application.

{
  "inputList": [
    "modern kitchen"
  ],
  "mode": "all",
  "pagesPerSearch": 1
}

Each page setting counts result pages per query. Pinterest chooses page sizes and ranking; observed sample sizes are not a fixed number of saved results. The video option selects the website’s video search.

Pinterest pin search results output fields 📦

Field	Type	Meaning
input	string	Original submitted input.
status	string	Whether this entity was successfully collected.
page	integer or null	One-based page within this input's collection.
query	string or null	Resolved keyword query used for this result.
mode	string or null	Search mode, or created for profile Created-tab pins.
id	string or null	Id when supplied by Pinterest.
url	string or null	Url when supplied by Pinterest.
title	string or null	Title when supplied by Pinterest.
description	string or null	Description when supplied by Pinterest.
created_at	string or null	Created at when supplied by Pinterest.
link	string or null	Link when supplied by Pinterest.
domain	string or null	Domain when supplied by Pinterest.
alt_text	string or null	Alt text when supplied by Pinterest.
auto_alt_text	string or null	Auto alt text when supplied by Pinterest.
seo_title	string or null	Seo title when supplied by Pinterest.
seo_description	string or null	Seo description when supplied by Pinterest.
seo_alt_text	string or null	Seo alt text when supplied by Pinterest.
dominant_color	string or null	Dominant color when supplied by Pinterest.
image_url	string or null	Image url when supplied by Pinterest.
images	array or null	Available image variants, preserved in one dataset cell.
videos	array or null	Available video variants with duration in milliseconds, preserved in one dataset cell.
has_video	boolean or null	Whether video variants were present in this response.
is_video_raw	boolean or null	Raw Pinterest is_video flag; video variants can exist when it is false.
is_repin	boolean or null	Is repin when supplied by Pinterest.
is_promoted	boolean or null	Is promoted when supplied by Pinterest.
repin_count	integer or null	Repin count reported for this pin; separate from aggregate saves.
comment_count	integer or null	Comment count reported for this individual pin.
favorite_user_count	integer or null	Favorite user count when supplied by Pinterest.
share_count	integer or null	Share count when supplied by Pinterest.
comments_disabled	boolean or null	Comments disabled when supplied by Pinterest.
aggregated_pin_id	string or null	Pinterest aggregate ID shared by related copies of the pin.
aggregated_comment_count	integer or null	Comment count reported for the aggregated pin.
aggregated_save_count	integer or null	Save count reported for the aggregated pin.
aggregated_done_count	integer or null	Tried-it count reported for the aggregated pin.
reactions	array or null	Reactions when supplied by Pinterest.
author	object or null	Author when supplied by Pinterest.
board	object or null	Board when supplied by Pinterest.
section	object or null	Section when supplied by Pinterest.
product	object or null	Product fields when product metadata exists. Raw zero prices do not establish a free product.

Nested field structure:

• images[]: variant, url, width, height, dominant_color.
• videos[]: variant, url, width, height, duration_ms, thumbnail_url.
• reactions[]: type, count.
• author: id, username, name, url, image_url, image_large_url, is_verified, is_verified_merchant, is_private, follower_count.
• board: id, url, name, description, pin_count, follower_count, section_count, sectionless_pin_count, collaborator_count, is_collaborative, privacy, category, cover_image_url, cover_image_hd_url, last_modified_at, owner, images.
• board.owner: id, username, name, url, image_url, image_large_url, is_verified, is_verified_merchant, is_private, follower_count.
• board.images[]: variant, url, width, height, dominant_color.
• section: id, title, slug, description, pin_count, url.
• product: metadata_id, price_value_raw, price_currency, availability, is_out_of_stock, is_stale.

The examples below use normalized public response data. Values are snapshots and may change; every top-level output field is included. Different media variants and nested objects remain inside the same row.

Complete representative success result:

{
  "input": "modern kitchen",
  "status": "success",
  "page": 1,
  "query": "modern kitchen",
  "mode": "all",
  "id": "71142869302291068",
  "url": "https://www.pinterest.com/pin/71142869302291068/",
  "title": "Warm Modern Kitchen with Wood Cabinetry & Island",
  "description": "Cozy luxury kitchen with warm wood cabinetry, expansive island, soft ambient lighting, and elegant pendant lights. Neutral finishes create inviting, timeless charm perfect for stylish home design inspiration",
  "created_at": "2026-09-02T15:23:23Z",
  "link": null,
  "domain": "Uploaded by user",
  "alt_text": null,
  "auto_alt_text": "a modern kitchen with an island and bar stools",
  "seo_title": null,
  "seo_description": null,
  "seo_alt_text": "a modern kitchen with an island and bar stools",
  "dominant_color": "#977352",
  "image_url": "https://i.pinimg.com/originals/c1/ca/e6/c1cae6a0dc4753c07d855295284871bf.png",
  "images": [
    {
      "variant": "170x",
      "url": "https://i.pinimg.com/236x/c1/ca/e6/c1cae6a0dc4753c07d855295284871bf.jpg",
      "width": 236,
      "height": 354,
      "dominant_color": null
    },
    {
      "variant": "474x",
      "url": "https://i.pinimg.com/474x/c1/ca/e6/c1cae6a0dc4753c07d855295284871bf.jpg",
      "width": 474,
      "height": 712,
      "dominant_color": null
    },
    {
      "variant": "736x",
      "url": "https://i.pinimg.com/736x/c1/ca/e6/c1cae6a0dc4753c07d855295284871bf.jpg",
      "width": 736,
      "height": 1105,
      "dominant_color": null
    },
    {
      "variant": "orig",
      "url": "https://i.pinimg.com/originals/c1/ca/e6/c1cae6a0dc4753c07d855295284871bf.png",
      "width": 1023,
      "height": 1537,
      "dominant_color": null
    }
  ],
  "videos": [],
  "has_video": false,
  "is_video_raw": null,
  "is_repin": null,
  "is_promoted": false,
  "repin_count": null,
  "comment_count": null,
  "favorite_user_count": null,
  "share_count": null,
  "comments_disabled": null,
  "aggregated_pin_id": null,
  "aggregated_comment_count": null,
  "aggregated_save_count": null,
  "aggregated_done_count": null,
  "reactions": [
    {
      "type": "1",
      "count": 34
    }
  ],
  "author": {
    "id": "71143006522082483",
    "username": "karina_manafova",
    "name": "Карина Манафова",
    "url": "https://www.pinterest.com/karina_manafova/",
    "image_url": "https://i.pinimg.com/75x75_RS/39/1e/d1/391ed1648eabe1c2e59c51dd0c9d2156.jpg",
    "image_large_url": "https://i.pinimg.com/140x140_RS/39/1e/d1/391ed1648eabe1c2e59c51dd0c9d2156.jpg",
    "is_verified": null,
    "is_verified_merchant": false,
    "is_private": null,
    "follower_count": 49
  },
  "board": {
    "id": "71142937803026623",
    "url": "https://www.pinterest.com/karina_manafova/%D0%BA%D1%83%D1%85%D0%BD%D1%8F/",
    "name": "Кухня",
    "description": null,
    "pin_count": 64,
    "follower_count": null,
    "section_count": 0,
    "sectionless_pin_count": null,
    "collaborator_count": 0,
    "is_collaborative": false,
    "privacy": null,
    "category": null,
    "cover_image_url": "https://i.pinimg.com/200x150/2a/30/b5/2a30b58396263be381ae41232ab8cccd.jpg",
    "cover_image_hd_url": "https://i.pinimg.com/474x/2a/30/b5/2a30b58396263be381ae41232ab8cccd.jpg",
    "last_modified_at": "2026-09-02T15:23:24Z",
    "owner": {
      "id": "71143006522082483",
      "username": "karina_manafova",
      "name": "Карина Манафова",
      "url": "https://www.pinterest.com/karina_manafova/",
      "image_url": "https://i.pinimg.com/75x75_RS/39/1e/d1/391ed1648eabe1c2e59c51dd0c9d2156.jpg",
      "image_large_url": "https://i.pinimg.com/140x140_RS/39/1e/d1/391ed1648eabe1c2e59c51dd0c9d2156.jpg",
      "is_verified": null,
      "is_verified_merchant": false,
      "is_private": null,
      "follower_count": 49
    },
    "images": [
      {
        "variant": "236x.0",
        "url": "https://i.pinimg.com/236x/fd/80/2c/fd802c3019ad7c10c826236e31ecf6d4.jpg",
        "width": 236,
        "height": 304,
        "dominant_color": "#7A6C5D"
      },
      {
        "variant": "236x.1",
        "url": "https://i.pinimg.com/236x/8f/bf/3c/8fbf3c906a310a9d40354ec1cca165f5.jpg",
        "width": 236,
        "height": 282,
        "dominant_color": "#A59889"
      },
      {
        "variant": "236x.2",
        "url": "https://i.pinimg.com/236x/c1/ca/e6/c1cae6a0dc4753c07d855295284871bf.jpg",
        "width": 236,
        "height": 354,
        "dominant_color": "#977352"
      },
      {
        "variant": "236x.3",
        "url": "https://i.pinimg.com/236x/cb/cc/ea/cbccea7ec2c62ec94ca060bdaa276ab4.jpg",
        "width": 236,
        "height": 349,
        "dominant_color": "#B2A390"
      },
      {
        "variant": "236x.4",
        "url": "https://i.pinimg.com/236x/34/fa/66/34fa66af00fb7ed47a46d9491b21c228.jpg",
        "width": 236,
        "height": 347,
        "dominant_color": "#C5B49E"
      },
      {
        "variant": "236x.5",
        "url": "https://i.pinimg.com/236x/ac/4f/c3/ac4fc389ab13efc6b124bcbe0316bfa6.jpg",
        "width": 236,
        "height": 348,
        "dominant_color": "#D0C4B3"
      },
      {
        "variant": "236x.6",
        "url": "https://i.pinimg.com/236x/4b/d9/40/4bd9402c15176eacc79cef741e8f6eb9.jpg",
        "width": 236,
        "height": 295,
        "dominant_color": "#8C8B82"
      },
      {
        "variant": "236x.7",
        "url": "https://i.pinimg.com/236x/c7/c6/f1/c7c6f123ae720d2220e0f21fba1b6913.jpg",
        "width": 236,
        "height": 289,
        "dominant_color": "#8F857A"
      },
      {
        "variant": "236x.8",
        "url": "https://i.pinimg.com/236x/ef/ea/5c/efea5ca96502e33fb035a9b39f3f680c.jpg",
        "width": 236,
        "height": 295,
        "dominant_color": "#AEA49F"
      },
      {
        "variant": "236x.9",
        "url": "https://i.pinimg.com/236x/18/24/eb/1824eb9c72fbf573a3d2d00b4f8f1416.jpg",
        "width": 236,
        "height": 295,
        "dominant_color": "#9E948C"
      },
      {
        "variant": "236x.10",
        "url": "https://i.pinimg.com/236x/e0/aa/20/e0aa2048b2ed12a9a9758f6c457ddb04.jpg",
        "width": 236,
        "height": 419,
        "dominant_color": "#BEB7AC"
      },
      {
        "variant": "236x.11",
        "url": "https://i.pinimg.com/236x/aa/66/1c/aa661c654991aa5efdef762295c0ba19.jpg",
        "width": 236,
        "height": 238,
        "dominant_color": "#B3A69A"
      },
      {
        "variant": "236x.12",
        "url": "https://i.pinimg.com/236x/68/98/d0/6898d03384e05b6f21790630b427fad7.jpg",
        "width": 236,
        "height": 229,
        "dominant_color": "#9A8E83"
      },
      {
        "variant": "236x.13",
        "url": "https://i.pinimg.com/236x/53/a8/00/53a800066664664cce9af1cd78ba7ed0.jpg",
        "width": 236,
        "height": 295,
        "dominant_color": "#928879"
      },
      {
        "variant": "236x.14",
        "url": "https://i.pinimg.com/236x/cd/f3/54/cdf35408d8f0f5fed34b796fb6c0c345.jpg",
        "width": 236,
        "height": 234,
        "dominant_color": "#ADA298"
      }
    ]
  },
  "section": null,
  "product": null
}

Complete videos result:

{
  "input": "modern kitchen",
  "status": "success",
  "page": 1,
  "query": "modern kitchen",
  "mode": "videos",
  "id": "655766395790242922",
  "url": "https://www.pinterest.com/pin/655766395790242922/",
  "title": "",
  "description": "Simple, warm, and made for everyday life. 🤍\n\n#unitrenderspace",
  "created_at": "2026-08-12T20:59:05Z",
  "link": "https://www.instagram.com/reel/DaftA-Rt0kk/",
  "domain": "instagram.com",
  "alt_text": null,
  "auto_alt_text": "a kitchen with marble counter tops and wooden stools next to an island in the middle",
  "seo_title": null,
  "seo_description": null,
  "seo_alt_text": "a kitchen with marble counter tops and wooden stools next to an island in the middle",
  "dominant_color": "#80644d",
  "image_url": "https://i.pinimg.com/originals/51/7f/ad/517fadae5897bfe0659b29af82f90eb0.jpg",
  "images": [
    {
      "variant": "170x",
      "url": "https://i.pinimg.com/236x/51/7f/ad/517fadae5897bfe0659b29af82f90eb0.jpg",
      "width": 236,
      "height": 418,
      "dominant_color": null
    },
    {
      "variant": "474x",
      "url": "https://i.pinimg.com/474x/51/7f/ad/517fadae5897bfe0659b29af82f90eb0.jpg",
      "width": 474,
      "height": 841,
      "dominant_color": null
    },
    {
      "variant": "736x",
      "url": "https://i.pinimg.com/736x/51/7f/ad/517fadae5897bfe0659b29af82f90eb0.jpg",
      "width": 640,
      "height": 1136,
      "dominant_color": null
    },
    {
      "variant": "orig",
      "url": "https://i.pinimg.com/originals/51/7f/ad/517fadae5897bfe0659b29af82f90eb0.jpg",
      "width": 640,
      "height": 1136,
      "dominant_color": null
    }
  ],
  "videos": [
    {
      "variant": "V_HLSV4",
      "url": "https://v1.pinimg.com/videos/iht/hls/16/9e/3d/169e3d7b0c992f967ae1644d8cf05c36.m3u8",
      "width": 720,
      "height": 1280,
      "duration_ms": 5042,
      "thumbnail_url": "https://i.pinimg.com/videos/thumbnails/originals/16/9e/3d/169e3d7b0c992f967ae1644d8cf05c36.0000000.jpg"
    },
    {
      "variant": "V_HLSV3_MOBILE",
      "url": "https://v1.pinimg.com/videos/iht/hls/16/9e/3d/169e3d7b0c992f967ae1644d8cf05c36.m3u8",
      "width": 720,
      "height": 1280,
      "duration_ms": 5042,
      "thumbnail_url": "https://i.pinimg.com/videos/thumbnails/originals/16/9e/3d/169e3d7b0c992f967ae1644d8cf05c36.0000000.jpg"
    }
  ],
  "has_video": true,
  "is_video_raw": null,
  "is_repin": null,
  "is_promoted": false,
  "repin_count": null,
  "comment_count": null,
  "favorite_user_count": null,
  "share_count": null,
  "comments_disabled": null,
  "aggregated_pin_id": null,
  "aggregated_comment_count": null,
  "aggregated_save_count": null,
  "aggregated_done_count": null,
  "reactions": [
    {
      "type": "1",
      "count": 41
    }
  ],
  "author": {
    "id": "655766533150203732",
    "username": "unitrenderspace",
    "name": "UnitRenderSpace",
    "url": "https://www.pinterest.com/unitrenderspace/",
    "image_url": "https://i.pinimg.com/75x75_RS/32/fd/37/32fd379107983c5d1c2e3c4c42cae220.jpg",
    "image_large_url": "https://i.pinimg.com/140x140_RS/32/fd/37/32fd379107983c5d1c2e3c4c42cae220.jpg",
    "is_verified": null,
    "is_verified_merchant": false,
    "is_private": null,
    "follower_count": 2487
  },
  "board": {
    "id": "655766464432337999",
    "url": "https://www.pinterest.com/unitrenderspace/_tpd_social/",
    "name": "Social",
    "description": null,
    "pin_count": 9505,
    "follower_count": null,
    "section_count": 0,
    "sectionless_pin_count": null,
    "collaborator_count": 0,
    "is_collaborative": false,
    "privacy": null,
    "category": null,
    "cover_image_url": "https://i.pinimg.com/200x150/13/95/30/13953023399ba172939a3f2e2d82022c.jpg",
    "cover_image_hd_url": "https://i.pinimg.com/474x/13/95/30/13953023399ba172939a3f2e2d82022c.jpg",
    "last_modified_at": "2026-09-10T14:13:40Z",
    "owner": {
      "id": "655766533150203732",
      "username": "unitrenderspace",
      "name": "UnitRenderSpace",
      "url": "https://www.pinterest.com/unitrenderspace/",
      "image_url": "https://i.pinimg.com/75x75_RS/32/fd/37/32fd379107983c5d1c2e3c4c42cae220.jpg",
      "image_large_url": "https://i.pinimg.com/140x140_RS/32/fd/37/32fd379107983c5d1c2e3c4c42cae220.jpg",
      "is_verified": null,
      "is_verified_merchant": false,
      "is_private": null,
      "follower_count": 2487
    },
    "images": [
      {
        "variant": "236x.0",
        "url": "https://i.pinimg.com/236x/b5/23/1e/b5231e619f6cb1b5de5db994bf3cb1b0.jpg",
        "width": 236,
        "height": 295,
        "dominant_color": "#F0F0F0"
      },
      {
        "variant": "236x.1",
        "url": "https://i.pinimg.com/236x/19/11/14/1911141251cb91fd6bec3d1a2c41366f.jpg",
        "width": 236,
        "height": 294,
        "dominant_color": "#F0F0F0"
      },
      {
        "variant": "236x.2",
        "url": "https://i.pinimg.com/236x/b9/a4/e0/b9a4e0e498b76b68f1870462d05a075c.jpg",
        "width": 236,
        "height": 314,
        "dominant_color": "#383420"
      },
      {
        "variant": "236x.3",
        "url": "https://i.pinimg.com/236x/d5/1f/8e/d51f8e7977d362704d4539a2aeb680c0.jpg",
        "width": 236,
        "height": 288,
        "dominant_color": "#AA9889"
      },
      {
        "variant": "236x.4",
        "url": "https://i.pinimg.com/236x/76/4c/9a/764c9ad36875df52cace9aed49267d09.jpg",
        "width": 236,
        "height": 314,
        "dominant_color": "#373B33"
      },
      {
        "variant": "236x.5",
        "url": "https://i.pinimg.com/236x/04/56/95/0456951e9ef25646af6bd15afd34252a.jpg",
        "width": 236,
        "height": 294,
        "dominant_color": "#8B7E72"
      },
      {
        "variant": "236x.6",
        "url": "https://i.pinimg.com/236x/46/41/f1/4641f17f7382905be028aef30a268c4e.jpg",
        "width": 236,
        "height": 294,
        "dominant_color": "#9B928A"
      },
      {
        "variant": "236x.7",
        "url": "https://i.pinimg.com/236x/ed/57/d2/ed57d2c8da7922b78ad39a9dab06d256.jpg",
        "width": 236,
        "height": 314,
        "dominant_color": "#2B2820"
      },
      {
        "variant": "236x.8",
        "url": "https://i.pinimg.com/236x/ac/68/ec/ac68ecd56d03e65e88a89c90e201dbbb.jpg",
        "width": 236,
        "height": 314,
        "dominant_color": "#D0C1B1"
      },
      {
        "variant": "236x.9",
        "url": "https://i.pinimg.com/236x/56/6d/75/566d75f73cc258a48cbb5d494f57d7f1.jpg",
        "width": 236,
        "height": 314,
        "dominant_color": "#252A1E"
      },
      {
        "variant": "236x.10",
        "url": "https://i.pinimg.com/236x/a8/f4/8d/a8f48d5d3cedfe96f1afa906471029ef.jpg",
        "width": 236,
        "height": 314,
        "dominant_color": "#9D775A"
      },
      {
        "variant": "236x.11",
        "url": "https://i.pinimg.com/236x/04/02/3f/04023f98bcf99e5c1be2b8245576e8cb.jpg",
        "width": 236,
        "height": 294,
        "dominant_color": "#B5A294"
      },
      {
        "variant": "236x.12",
        "url": "https://i.pinimg.com/236x/38/ad/4f/38ad4fb1bddd8264e31bafdae386b4eb.jpg",
        "width": 236,
        "height": 314,
        "dominant_color": "#AC8058"
      },
      {
        "variant": "236x.13",
        "url": "https://i.pinimg.com/236x/36/51/88/3651888baf94b1ece6f17f8cc43bb109.jpg",
        "width": 236,
        "height": 294,
        "dominant_color": "#CAAE8F"
      },
      {
        "variant": "236x.14",
        "url": "https://i.pinimg.com/236x/8c/86/8c/8c868ca145d8920dc295a6528607e92d.jpg",
        "width": 236,
        "height": 294,
        "dominant_color": "#A18C79"
      }
    ]
  },
  "section": null,
  "product": null
}

Complete failed dataset item:

{
  "input": "invalid input",
  "status": "failed",
  "page": null,
  "query": null,
  "mode": null,
  "id": null,
  "url": null,
  "title": null,
  "description": null,
  "created_at": null,
  "link": null,
  "domain": null,
  "alt_text": null,
  "auto_alt_text": null,
  "seo_title": null,
  "seo_description": null,
  "seo_alt_text": null,
  "dominant_color": null,
  "image_url": null,
  "images": null,
  "videos": null,
  "has_video": null,
  "is_video_raw": null,
  "is_repin": null,
  "is_promoted": null,
  "repin_count": null,
  "comment_count": null,
  "favorite_user_count": null,
  "share_count": null,
  "comments_disabled": null,
  "aggregated_pin_id": null,
  "aggregated_comment_count": null,
  "aggregated_save_count": null,
  "aggregated_done_count": null,
  "reactions": null,
  "author": null,
  "board": null,
  "section": null,
  "product": null
}

A failed row preserves input, sets status to failed, and sets every other top-level field to null. The reason is written to the run log. Optional successful values remain null or empty when Pinterest omits them. The single dataset view exposes object fields as useful columns; arrays are kept in their parent row rather than expanded into additional rows or views.

Input and pagination settings ⚙️

Parameter	Type	Required	Default	Rules
inputList	array of strings	Yes	None	Enter keyword queries or canonical Pinterest /search/pins/?q= or /search/videos/?q= URLs. A search URL selects its own mode; plain text uses Mode.
mode	string	No	"all"	Mode for plain keyword inputs. A Pinterest search URL selects the mode indicated in its path. Allowed: all, videos.
pagesPerSearch	integer	No	1	Maximum result pages per input. Website page sizes vary; short pages can still have a continuation. Preparation requests do not count as result pages. Minimum 1.

Enter nonblank search phrases or canonical Pinterest /search/pins/?q= or /search/videos/?q= links. Plain text uses the selected mode; a search URL uses the mode in its own path. Use Pin Scraper when you already know the exact publication.

Use canonical HTTPS links on www.pinterest.com or pinterest.com. Country-specific hosts, shortened pin.it links and unsupported paths are not accepted. Search inputs must contain a nonblank query of at most 1,000 characters. A matching canonical Pinterest search URL with one q parameter is also accepted.

Duplicate normalized inputs are processed once. A returned identifier is deduplicated within the pagination of one source input; the same object found under different source inputs retains each source relationship.

The first result request counts as page 1. Source validation and preparation requests do not consume result pages. A short or filtered page can continue if it supplies a usable cursor. Collection stops at the page budget or the end of pagination; a repeated cursor does not trigger an endless loop.

Pinterest pin search results use cases 🎯

Visual reference discovery

Search a design or product theme and review images, titles and original pin links. Keep source references when selecting materials for your own research.

Source website research

Collect outgoing links and domains from a topic sample. Review the linked websites separately before adding them to a qualified source list.

Video content research

Use video search to collect playback references and descriptions around a topic. The export supports a media inventory without downloading video files.

Pricing and saved-result behavior 💰

Check the Actor’s Pricing tab for the active charging model and current rate. Store settings may change, so this README does not state an unverified fixed price or runtime.

Under dataset-item pricing:

• Each unique success result represents one pin for its source input.
• An invalid or unavailable input, an input with no accessible results, or a request that exhausts retries can produce a failed row.
• Retry attempts and supporting metadata requests do not create extra dataset rows by themselves.
• Nested media, author and source fields stay inside their parent result.
• A normal empty continuation after earlier successes creates no additional result row.
• Saved failed rows are not assumed to be free. Check the active pricing configuration for their treatment.

Larger page budgets and more inputs can produce more saved rows. Start with a small run and check actual usage before increasing the workload.

Pinterest pin search results API 🔌

Replace $ACTOR_ID with the identifier shown in this Actor’s API tab and $APIFY_TOKEN with your Apify token.

curl -X POST "https://api.apify.com/v2/acts/$ACTOR_ID/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"inputList":["modern kitchen"],"mode":"all","pagesPerSearch":1}'

Download JSON, CSV, Excel, XML or other formats available in the Console, or retrieve the dataset through the Apify API. Schedules, webhooks and Apify integrations can connect results to Google Sheets, Make, Zapier, n8n, cloud storage or your own backend. These are connection options rather than integrations already configured by the Actor.

Reliability, retries, and public-data limits ⚠️

Collection uses pure HTTP with up to five concurrent requests. Invalid syntax and confirmed missing, removed or inaccessible targets stop without unnecessary retries. Temporary network or proxy failures, timeouts, blocking responses, malformed data, throttling and server errors are retried up to five total attempts per request.

Earlier successful pages remain saved when a later request fails. A normal end after previously saved results is not retried. An input that produces no accessible results can receive a failed row; this does not by itself prove the underlying account or collection does not exist. A later exhausted request can append a failed row while keeping earlier output.

Pinterest controls public availability, ranking, fields and pagination. Private, deleted, restricted or otherwise unavailable data can be omitted. Counts can change during collection, and media links can expire. Successful HTTP research confirms the supported request paths and pagination on tested sources, rather than future availability or exhaustive coverage.

Search returns a ranked sample of matching pins, not every pin related to a topic. Search rows can contain fewer details than a dedicated pin lookup. Video results may expose HLS playlists rather than a direct MP4, and media files are not downloaded.

An invalid string within a valid input list does not stop other inputs. A configuration that fails validation, such as a non-string list item or an invalid page-count type, exits before requests start. Infrastructure errors such as startup failure, unavailable dataset storage or an unrecoverable result-save error can stop the whole run. A failed dataset save is not retried as a new scraping request.

Frequently asked questions ❓

Can I search only for videos?

Yes. Select the video search option before starting the run. Returned video variants depend on what Pinterest exposes for each result.

Does it search inside a specific profile or board?

This Actor searches Pinterest by keyword. Use Profile Pins Scraper or Board Pins Scraper for a known account or collection.

Does it return an exact number of pins?

No. You choose pages per query. Search ranking, duplicates, unavailable pins and variable page sizes affect the saved total.

Does it require Pinterest login or personal cookies?

No. The Actor uses HTTP requests from the public website. It does not require a Pinterest account, password or personal session cookie, and does not launch a browser.

What happens to invalid or unavailable inputs?

Invalid individual inputs are saved as failed rows without a source request. Confirmed unavailable targets stop without unnecessary retries. Temporary failures allow up to five total attempts; other inputs and previously saved results remain available.

Can I export results or schedule runs?

Yes. Download the default dataset in supported formats or retrieve it through the Apify API. Apify schedules and completion webhooks can connect repeated runs to your own workflow.

Support, responsible use, and related actors 🛟

For a reproducible issue, use the Actor’s Issues tab and provide the run ID, approximate time, safe public input, expected behavior and actual result. Include the selected mode or page count when applicable. Do not share access tokens, cookies or proxy credentials.

Use public data responsibly and follow applicable privacy, copyright, contractual and platform requirements before storing, analyzing or redistributing collected information.