# Pinterest Profile Scraper (`scrapeflow/pinterest-profile-scraper`) Actor πŸ“Œ Pinterest Profile Scraper extracts public profile data: name, username, bio, website, followers/following, boards, pins & links. πŸ”Ž Perfect for influencer discovery, competitor research & content planning. πŸ“Š Fast, accurate, CSV/JSON exports. πŸš€ - **URL**: https://apify.com/scrapeflow/pinterest-profile-scraper.md - **Developed by:** [ScrapeFlow](https://apify.com/scrapeflow) (community) - **Categories:** Automation, Lead generation, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $19.99/month + usage To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ### Pinterest Profile Scraper Pinterest Profile Scraper is a fast, reliable Pinterest profile scraper that extracts public user data at scale β€” including profile info, follower/following counts, pins, boards, images, and SEO metadata. Built for marketers, developers, data analysts, and researchers, this Pinterest user scraper streamlines influencer discovery, competitor tracking, and content planning with structured datasets you can export and integrate. Use it to scrape Pinterest profiles by URL or username, automate Pinterest user data extraction, and power workflows from enrichment to reporting. ### What data / output can you get? Below are examples of structured fields this Pinterest profile data extractor saves to the Apify dataset. You can export to CSV, JSON, or Excel from the Apify platform. | Data type | Description | Example value | | --- | --- | --- | | username | Pinterest handle extracted from the profile | candyw8119 | | full_name | Full display name on the profile | Jane Doe | | about | Bio/description section | Curated recipes & crafts | | pin_count | Total number of pins | 39901 | | board_count | Total boards created | 118 | | follower_count | Number of followers | 26643 | | following_count | Number of accounts the user follows | 25827 | | created_at | Account creation timestamp (string) | Thu, 31 May 2018 04:28:16 +0000 | | id | Numeric user ID (string) | 695524873610553291 | | node_id | Encoded node identifier | VXNlcjo2OTU1MjQ4NzM2MTA1NTMyOTE= | | image_xlarge_url | High-resolution profile image URL | https://i.pinimg.com/280x280_RS/46/ef/9f/46ef9f7d.jpg | | seo_canonical_domain | Canonical domain reported by Pinterest | www.pinterest.com | Bonus fields can include: image_medium_url, last_pin_save_time, is_verified_merchant, is_private_profile, website_url, domain_verified, seo_title, seo_description, and more, depending on what’s publicly available on the profile. ### Key features - 🚦 Automatic proxy fallback & blocking detection Smart proxy management with a no-proxy β†’ datacenter β†’ residential fallback strategy and up to 3 residential attempts. Built-in detection for 403/429/5xx and blocked content. - πŸ“¦ Batch scraping & bulk automation Process multiple profiles in one run by passing usernames or profile URLs β€” ideal for large lists and recurring data pulls. - 🧠 Robust retry logic Per-request retries with exponential backoff to handle transient network issues and improve success rates. - 🧾 Structured dataset output Clean, structured items saved to the Apify dataset for easy export to JSON, CSV, or Excel and downstream analytics. - πŸ”Ž URL or username inputs Works as a Pinterest username scraper and Pinterest profile URL scraper β€” accepts either format for flexible ingestion. - 🧰 Developer-friendly Built with the Apify SDK (Python). Integrate via Apify API in your pipelines or connect to workflow tools. - πŸ“ˆ Real-time logging & progress tracking Transparent logs show proxy events, blocking, retries, and per-profile status to simplify monitoring. - 🧱 Production-ready reliability Error handling, graceful fallbacks, and stable HTTP fetching make this a dependable Pinterest profile scraping software. ### How to use Pinterest Profile Scraper - step by step 1. Sign in to your Apify account at https://console.apify.com (create one if you’re new). 2. Open the Pinterest Profile Scraper actor (pinterest-profile-scraper) from your Actors. 3. Add inputs in the startUrls field: - As usernames: e.g., candyw8119 - As full profile URLs: e.g., https://www.pinterest.com/username - You can also provide objects like {"url": "candyw8119"} β€” both formats are accepted. 4. (Optional) Configure proxyConfiguration. By default, no proxy is used; the actor will automatically fallback to datacenter, then residential proxies if needed. 5. Start the run. Watch logs to see live progress, proxy events, and per-profile results. 6. When finished, go to the OUTPUT tab to view the dataset. 7. Export your results to JSON, CSV, or Excel for analysis or integration. Pro tip: Trigger runs via the Apify API and chain this Pinterest profile scraper tool into your enrichment or analytics workflows. ### Use cases | Use case name | Description | | --- | --- | | Influencer discovery for marketing | Identify high-performing creators by extracting follower counts, pins, and boards to prioritize outreach. | | Competitor monitoring for brand teams | Track competitor profiles and engagement metrics to benchmark content strategy and growth. | | Audience research for analysts | Aggregate bios and stats to understand audience interests and cluster profiles by niche. | | Bulk enrichment for data pipelines | Feed structured Pinterest user data into ETL/ELT workflows for modeling and reporting. | | Academic research on social trends | Collect public profiles at scale to study network effects and topic diffusion. | | API-driven automation | Orchestrate scheduled runs via Apify API and export datasets to data warehouses or BI tools. | ### Why choose Pinterest Profile Scraper? A precision-focused Pinterest account scraper built for automation and reliability. - 🎯 Accurate public profile extraction: Targets structured fields directly from profile HTML and JSON data sources. - βš™οΈ Scale-ready: Handles multiple inputs per run β€” ideal to scrape Pinterest profiles in bulk. - 🧩 Developer access: Built on Apify’s SDK with API support for integration in Python or low-code automation tools. - πŸ›‘οΈ Safe-by-design: Scrapes public data only and includes proxy fallback to minimize blocking. - πŸ’Έ Cost-efficient vs. extensions: More stable than brittle browser extensions or one-off scripts, with repeatable outputs. - πŸ”— Export-friendly: Structured datasets export cleanly to JSON/CSV/Excel for analysis and syncing to downstream systems. - 🧱 Resilient infrastructure: Retry logic, blocking detection, and residential proxy fallback keep runs on track. Bottom line: This Pinterest profile crawler offers a stable, production-ready alternative to manual copy/paste and unstable scraping approaches. ### Is it legal / ethical to use Pinterest Profile Scraper? Yes β€” when used responsibly. This Pinterest public profile scraper collects data from publicly available Pinterest profiles only and does not access private or password-protected content. Guidelines for compliant use: - Only collect publicly visible information and respect platform terms. - Avoid scraping private profiles or gated endpoints. - Ensure your use complies with data protection laws (e.g., GDPR, CCPA) and organizational policies. - Use exported data responsibly and avoid spam or misuse. For edge cases, consult your legal team to confirm compliance in your jurisdiction and use case. ### Input parameters & output format #### Example JSON input ```json { "startUrls": [ "candyw8119", "https://www.pinterest.com/username", { "url": "anotheruser" } ], "proxyConfiguration": { "useApifyProxy": false } } ```` #### Parameters | Parameter | Type | Required | Default/Prefill | Description | | --- | --- | --- | --- | --- | | startUrls | array | Yes | \["candyw8119"] | List one or more Pinterest profile URLs (e.g., https://www.pinterest.com/username), usernames (e.g., username), or keywords for bulk scraping. Accepts strings or objects with a "url" key. | | proxyConfiguration | object | No | {"useApifyProxy": false} | Choose which proxies to use. By default, no proxy is used. If Pinterest blocks the request, it will automatically fallback to datacenter proxy, then residential proxy with 3 retries. | Notes: - The actor determines the best proxy mode by testing your first input, then applies the selected mode to the rest. - If a profile doesn’t expose certain fields publicly, those fields will be absent in the output for that item. #### Example JSON output ```json [ { "username": "candyw8119", "node_id": "VXNlcjo2OTU1MjQ4NzM2MTA1NTMyOTE=", "about": "Curated recipes & crafts", "pin_count": 39901, "image_xlarge_url": "https://i.pinimg.com/280x280_RS/46/ef/9f/46ef9f7db778b345adea2419bb09162b.jpg", "seo_canonical_domain": "www.pinterest.com", "last_pin_save_time": "Thu, 11 Dec 2025 13:04:17 +0000", "board_count": 118, "id": "695524873610553291", "eligible_profile_tabs": ["Created", "Saved"], "image_medium_url": "https://i.pinimg.com/160x160/46/ef/9f/46ef9f7db7.jpg", "profile_cover": null, "verified_identity": null, "full_name": "Jane Doe", "is_verified_merchant": false, "is_private_profile": false, "is_ads_only_profile": false, "website_url": "https://example.com", "domain_url": "example.com", "first_name": "Jane", "instagram_data": null, "interest_following_count": 120, "is_partner": false, "domain_verified": false, "partner": null, "type": "user", "impressum_url": null, "following_count": 25827, "is_primary_website_verified": false, "seo_noindex_reason": null, "ads_only_profile_site": null, "created_at": "Thu, 31 May 2018 04:28:16 +0000", "follower_count": 26643, "seo_title": "Jane Doe (jane) - Profile", "indexed": true, "seo_description": "Discover ideas saved by Jane Doe.", "is_inspirational_merchant": false } ] ``` This actor pushes each scraped profile as an item in the dataset with keys drawn from the following set when available: username, node\_id, about, pin\_count, image\_xlarge\_url, seo\_canonical\_domain, last\_pin\_save\_time, board\_count, id, eligible\_profile\_tabs, image\_medium\_url, profile\_cover, verified\_identity, full\_name, is\_verified\_merchant, is\_private\_profile, is\_ads\_only\_profile, website\_url, domain\_url, first\_name, instagram\_data, interest\_following\_count, is\_partner, domain\_verified, partner, type, impressum\_url, following\_count, is\_primary\_website\_verified, seo\_noindex\_reason, ads\_only\_profile\_site, created\_at, follower\_count, seo\_title, indexed, seo\_description, is\_inspirational\_merchant. ### FAQ #### Can this Pinterest profile scraper handle both usernames and full profile URLs? βœ… Yes. You can pass usernames like candyw8119 or full profile URLs like https://www.pinterest.com/username in startUrls. The actor normalizes both formats automatically. #### Does it scrape private profiles? ❌ No. The Pinterest public profile scraper only extracts data from publicly available profiles and does not access private or password-protected content. #### What happens if Pinterest blocks requests? βœ… The actor automatically falls back from no proxy to a datacenter proxy, and then to a residential proxy with up to 3 attempts. It detects common blocking signals (403/429/5xx and blocked content) and adjusts accordingly. #### How many profiles can I scrape in one run? βœ… You can list multiple items in startUrls. The Pinterest profile scraping software processes them sequentially with shared proxy mode determined from the first test profile. #### What data fields are included in the output? βœ… The Pinterest user scraper extracts 36+ fields when available, including username, full\_name, about, pin\_count, board\_count, follower\_count, following\_count, IDs, images, timestamps, and SEO metadata. See the Output Format section for the full set. #### Do I need to configure proxies? ℹ️ Not necessarily. By default, no proxy is used. If Pinterest rejects requests, the actor automatically transitions to datacenter and then residential proxies. #### How do I export results? πŸ’Ύ All items are saved to the Apify dataset. You can export to JSON, CSV, or Excel from the OUTPUT tab or use the Apify API to retrieve data programmatically. #### Can I integrate this Pinterest account scraper into my pipeline? 🧰 Yes. It’s built on the Apify SDK (Python) and works with the Apify API, making it easy to include in automated workflows for Pinterest user data extraction. ### Closing CTA / Final thoughts Pinterest Profile Scraper is built for accurate, scalable extraction of public Pinterest profile data. It helps marketers, developers, analysts, and researchers automate profile discovery and export clean datasets for analysis. With automatic proxy fallback, robust retry logic, and structured outputs, this Pinterest profile crawler delivers dependable results you can export to JSON/CSV or consume via the Apify API. Use it as a Pinterest followers scraper for audience tracking, a Pinterest username scraper for bulk discovery, or a Pinterest profile URL scraper for batch enrichment. Start extracting smarter Pinterest user insights at scale β€” and plug them into your analytics or automation pipeline with confidence. # Actor input Schema ## `startUrls` (type: `array`): List one or more Pinterest profile URLs (e.g., https://www.pinterest.com/username), usernames (e.g., username), or keywords for bulk scraping. ## `proxyConfiguration` (type: `object`): Choose which proxies to use. By default, no proxy is used. If Pinterest blocks the request, it will automatically fallback to datacenter proxy, then residential proxy with 3 retries. ## Actor input object example ```json { "startUrls": [ "candyw8119" ], "proxyConfiguration": { "useApifyProxy": false } } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ "candyw8119" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapeflow/pinterest-profile-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": ["candyw8119"], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("scrapeflow/pinterest-profile-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ "candyw8119" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call scrapeflow/pinterest-profile-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapeflow/pinterest-profile-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Profile Scraper", "description": "πŸ“Œ Pinterest Profile Scraper extracts public profile data: name, username, bio, website, followers/following, boards, pins & links. πŸ”Ž Perfect for influencer discovery, competitor research & content planning. πŸ“Š Fast, accurate, CSV/JSON exports. πŸš€", "version": "0.1", "x-build-id": "hANkLLghFgj3NApBM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapeflow~pinterest-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapeflow-pinterest-profile-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapeflow~pinterest-profile-scraper/runs": { "post": { "operationId": "runs-sync-scrapeflow-pinterest-profile-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapeflow~pinterest-profile-scraper/run-sync": { "post": { "operationId": "run-sync-scrapeflow-pinterest-profile-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "startUrls" ], "properties": { "startUrls": { "title": "Pinterest Profile URLs, Usernames, or Keywords", "type": "array", "description": "List one or more Pinterest profile URLs (e.g., https://www.pinterest.com/username), usernames (e.g., username), or keywords for bulk scraping.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Choose which proxies to use. By default, no proxy is used. If Pinterest blocks the request, it will automatically fallback to datacenter proxy, then residential proxy with 3 retries." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```