# Pinterest Profile Scraper (Cheap) (`data_api/pinterest-profile-scraper-cheap`) Actor Pinterest profile scraper that pulls follower counts, pin totals, board numbers, bio, and website from any public account, giving marketers and researchers a fast way to track audience data without logging in. - **URL**: https://apify.com/data\_api/pinterest-profile-scraper-cheap.md - **Developed by:** [Data API](https://apify.com/data_api) (community) - **Categories:** Social media, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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](cover.jpg) Pinterest shows you a profile in the browser, but getting those numbers into a spreadsheet is another story. There is no public API for follower counts, monthly reach, pin totals, or the website a creator links to. This scraper closes that gap. Hand it a Pinterest handle or a profile link and it pulls the account back as one tidy row: followers, following, monthly reach, pins, boards, bio, website, verification flags, avatar and cover images, and the join date. Run it on a single account or feed it a list of hundreds. ### What you get Each handle turns into one row with the same shape every time. Fields that an account does not expose come back empty rather than disappearing, so your columns line up when you drop the results into a sheet or database. The data splits into a few groups: - **Identity** — `accountId`, `handle`, `profileLink`, `displayName`, `givenName`, `bioText` - **Engagement** — `followersTotal`, `followingTotal`, `monthlyReach`, `pinsTotal`, `originalPinsTotal`, `boardsTotal`, `groupBoardsTotal` - **Website and domain** — `siteLink`, `domainConfirmed`, `domainLink` - **Images** — `avatarLink`, `avatarLinkLarge`, `coverLink`, `usesDefaultAvatar` - **Account flags** — `accountKind`, `identityVerified`, `merchantVerified`, `creatorProfileOn`, `searchIndexed`, `createdDate` - **Run metadata** — `collectedAt`, `errorMessage` ### Quick start 1. Press **Try for free** and open the input form. 2. Type a single handle into **Pinterest handle**, or paste a list into **Pinterest handles (bulk)** — plain handles and full profile links both work. 3. Choose a proxy type and set a **Profile cap** if you want to limit the run. 4. Click **Start**, then download the rows as JSON, CSV, Excel, or XML once it wraps up. ![How it works](how-it-works.jpg) ### Use cases - **Creator outreach** — size up Pinterest creators by followers, monthly reach, and pin volume before you pitch a partnership. - **Competitor tracking** — keep tabs on rival brand accounts and watch their audience and pin counts shift over time. - **Niche benchmarking** — stack your own account metrics against the leading profiles in your category. - **Lead enrichment** — attach Pinterest stats and website links to handles you already hold. - **Scheduled monitoring** — run a fixed handle list on a weekly schedule to chart follower growth. - **Social audits** — fold Pinterest reach and engagement numbers into a wider cross-platform report. ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `profileHandle` | string | One of `profileHandle` or `profileHandles` | A single Pinterest handle or profile link to pull. Example `etsy`. | | `profileHandles` | array of strings | One of `profileHandle` or `profileHandles` | A batch of handles or profile links, one per line, for multi-account runs. | | `resultsLimit` | integer | No | Upper limit on profiles handled per run. Default `50`; use `0` to lift the cap. | | `requestTimeoutSeconds` | integer | No | Seconds to wait on each HTTP call before giving up. Default `45`; raise it if timeouts recur. | | `proxyConfiguration` | object | No | Proxies that route the requests. Defaults to Datacenter (Anywhere); switch to Residential if Pinterest blocks datacenter IPs. | #### Example input ```json { "profileHandle": "etsy", "profileHandles": ["ikea", "sephora"], "resultsLimit": 50, "requestTimeoutSeconds": 45, "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output Every handle produces one row, and each field is always present — values an account does not share come back as `null` so the dataset stays rectangular. #### Example output ```json { "accountId": "340639538913975836", "handle": "etsy", "profileLink": "https://www.pinterest.com/etsy/", "displayName": "Etsy", "givenName": "Etsy", "bioText": "Handmade and vintage finds from independent sellers.", "followersTotal": 1450000, "followingTotal": 320, "monthlyReach": 9800000, "pinsTotal": 12600, "originalPinsTotal": 4100, "boardsTotal": 78, "groupBoardsTotal": 5, "siteLink": "https://www.etsy.com", "domainConfirmed": true, "domainLink": "etsy.com", "avatarLink": "https://i.pinimg.com/75x75_RS/ab/cd/ef/abcdef123456.jpg", "avatarLinkLarge": "https://i.pinimg.com/280x280_RS/ab/cd/ef/abcdef123456.jpg", "coverLink": "https://i.pinimg.com/1200x/ab/cd/ef/abcdef123456.jpg", "usesDefaultAvatar": false, "accountKind": "business", "identityVerified": true, "merchantVerified": true, "creatorProfileOn": true, "searchIndexed": true, "createdDate": "Tue, 12 Jun 2007 00:00:00 +0000", "collectedAt": "2026-06-29T12:00:00+00:00", "errorMessage": null } ``` #### Output fields | Field | Type | Description | |-------|------|-------------| | `accountId` | string | Pinterest's internal numeric account ID, stable across handle changes | | `handle` | string | The handle used in the profile link | | `profileLink` | string | Full web address of the profile page | | `displayName` | string | Name shown on the profile | | `givenName` | string | First-name portion of the display name, when listed separately | | `bioText` | string | The bio or about blurb on the profile | | `followersTotal` | integer | Count of accounts following this profile | | `followingTotal` | integer | Count of accounts this profile follows | | `monthlyReach` | integer | Monthly views Pinterest displays as reach | | `pinsTotal` | integer | All pins saved, repins included | | `originalPinsTotal` | integer | Pins the account created itself, repins excluded | | `boardsTotal` | integer | How many boards sit on the profile | | `groupBoardsTotal` | integer | Shared or collaborative boards the account joins | | `siteLink` | string | Website address listed on the profile | | `domainConfirmed` | boolean | Whether Pinterest confirmed the website domain | | `domainLink` | string | The confirmed domain address, when active | | `avatarLink` | string | Medium-size profile avatar address | | `avatarLinkLarge` | string | High-resolution profile avatar address | | `coverLink` | string | Cover or banner image at the top of the profile | | `usesDefaultAvatar` | boolean | True when the account still shows Pinterest's stock avatar | | `accountKind` | string | `personal` or `business` | | `identityVerified` | boolean | Whether the account holds a verified-identity badge | | `merchantVerified` | boolean | Whether Pinterest approved the account as a merchant | | `creatorProfileOn` | boolean | Whether creator-profile features are switched on | | `searchIndexed` | boolean | Whether the profile is indexed and shows up in search | | `createdDate` | string | Account open date in RFC 2822 form | | `collectedAt` | string | ISO 8601 timestamp of when the row was captured | | `errorMessage` | string | Reason a profile failed; `null` on success | ### Tips for best results - **Start with a handful.** Run five or ten handles first so any proxy or handle-format snags show up early. - **Switch to Residential when blocked.** Datacenter proxies clear most accounts; residential helps when 403s or rate limits pile up on big batches. - **Cap test runs with `resultsLimit`.** Hold it at 20–50 while you confirm the columns fit your pipeline, then set it to `0` for the full list. - **Raise `requestTimeoutSeconds` to ~60** for large batches or slower residential proxies. - **Mixed handles and links are fine.** You can paste plain handles and full profile URLs in the same list; the actor reads either. ### How can I use Pinterest profile data? **How can I use the Pinterest Profile Scraper to find creators for a campaign?** Paste a list of Pinterest handles for the niche you care about and the scraper returns each account's followers, monthly reach, pin volume, bio, and website link. Sort the rows by reach or follower count to shortlist creators worth approaching, then use the website and bio fields to plan your outreach. **How can I track competitor Pinterest accounts over time?** Save a fixed list of handles and schedule the actor to run on a regular cadence. Each run writes one row per account with current `followersTotal`, `pinsTotal`, `boardsTotal`, and `monthlyReach`, so you can append the results and chart how a rival's audience and posting activity move week to week. **How can I export Pinterest follower and engagement data to a spreadsheet?** Run the scraper on any set of handles and download the dataset as CSV, Excel, or JSON. Every account comes back as a flat row of follower counts, reach, pins, boards, and verification flags, ready to drop into Google Sheets, a BI dashboard, or your own database without extra cleanup. **How can I enrich a list of Pinterest handles I already have?** Already sitting on handles from another tool? Set `resultsLimit` to `0` and feed the whole list. Each handle returns a full profile row — stats, website, domain status, and avatar links — turning a bare list of names into an enriched Pinterest dataset you can join with your existing records. ### Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses or private contact information. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). ### Support Questions, feature requests, or a field you'd like added? Reach out at and we'll get back to you. # Actor input Schema ## `profileHandle` (type: `string`): One Pinterest handle or profile link to pull (for example 'etsy' or 'https://www.pinterest.com/etsy/'). Pick this when you only need a single account. ## `profileHandles` (type: `array`): A batch of Pinterest handles or profile links to pull. Add one handle or link per line. Pick this when you want several accounts in a single run. ## `resultsLimit` (type: `integer`): Upper limit on how many profiles a single run will handle — handy for trimming spend on long input lists. Use 0 to lift the cap. ## `requestTimeoutSeconds` (type: `integer`): How long to wait on each HTTP call before giving up. Bump it up if timeout errors keep appearing. ## `proxyConfiguration` (type: `object`): Choose which proxies route the requests. Useful for sidestepping IP blocks and rate limits. Datacenter proxies run fastest; residential proxies are tougher to spot. ## Actor input object example ```json { "profileHandle": "etsy", "profileHandles": [ "etsy", "ikea", "sephora" ], "resultsLimit": 50, "requestTimeoutSeconds": 45, "proxyConfiguration": { "useApifyProxy": true } } ``` # 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 = { "profileHandle": "etsy", "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("data_api/pinterest-profile-scraper-cheap").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 = { "profileHandle": "etsy", "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("data_api/pinterest-profile-scraper-cheap").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 '{ "profileHandle": "etsy", "proxyConfiguration": { "useApifyProxy": true } }' | apify call data_api/pinterest-profile-scraper-cheap --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=data_api/pinterest-profile-scraper-cheap", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pinterest Profile Scraper (Cheap)", "description": "Pinterest profile scraper that pulls follower counts, pin totals, board numbers, bio, and website from any public account, giving marketers and researchers a fast way to track audience data without logging in.", "version": "0.0", "x-build-id": "taKp13s2AruFd2U4N" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/data_api~pinterest-profile-scraper-cheap/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-data_api-pinterest-profile-scraper-cheap", "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/data_api~pinterest-profile-scraper-cheap/runs": { "post": { "operationId": "runs-sync-data_api-pinterest-profile-scraper-cheap", "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/data_api~pinterest-profile-scraper-cheap/run-sync": { "post": { "operationId": "run-sync-data_api-pinterest-profile-scraper-cheap", "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", "properties": { "profileHandle": { "title": "Pinterest handle", "type": "string", "description": "One Pinterest handle or profile link to pull (for example 'etsy' or 'https://www.pinterest.com/etsy/'). Pick this when you only need a single account." }, "profileHandles": { "title": "Pinterest handles (bulk)", "type": "array", "description": "A batch of Pinterest handles or profile links to pull. Add one handle or link per line. Pick this when you want several accounts in a single run.", "items": { "type": "string" } }, "resultsLimit": { "title": "Profile cap", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Upper limit on how many profiles a single run will handle — handy for trimming spend on long input lists. Use 0 to lift the cap.", "default": 50 }, "requestTimeoutSeconds": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "How long to wait on each HTTP call before giving up. Bump it up if timeout errors keep appearing.", "default": 45 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Choose which proxies route the requests. Useful for sidestepping IP blocks and rate limits. Datacenter proxies run fastest; residential proxies are tougher to spot." } } }, "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 } } } } } } } } } } ```