{ "openapi": "3.0.1", "info": { "title": "Pinterest Scraper ยท Exact Saves for Search, Boards & Profiles", "description": "Pinterest scraper for keyword search, boards, profiles and pin URLs. Returns the exact save count Pinterest shows on each pin (not repin_count), saves per day, flat CSV-ready rows, filters for minimum saves and date. No login, no residential proxy, pay only per pin written.", "version": "0.1", "x-build-id": "A4PgmSU9A7KY3WKFm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thequietstack~pinterest-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thequietstack-pinterest-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/thequietstack~pinterest-scraper/runs": { "post": { "operationId": "runs-sync-thequietstack-pinterest-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/thequietstack~pinterest-scraper/run-sync": { "post": { "operationId": "run-sync-thequietstack-pinterest-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", "properties": { "searchTerms": { "title": "Search keywords", "type": "array", "description": "Pinterest pin search, same as typing into pinterest.com. Search results do not contain save counts, so each pin's own data is fetched to get the exact number (see 'Exact save counts').", "items": { "type": "string" } }, "boardUrls": { "title": "Board URLs", "type": "array", "description": "https://www.pinterest.com/// (any country domain, pin.it short links work).", "items": { "type": "string" } }, "profileUrls": { "title": "Profile URLs or usernames", "type": "array", "description": "https://www.pinterest.com// or just the username. Returns the pins on that profile, newest first.", "items": { "type": "string" } }, "pinUrls": { "title": "Pin URLs or pin IDs", "type": "array", "description": "https://www.pinterest.com/pin// or the numeric ID. One row per pin with full detail.", "items": { "type": "string" } }, "maxPinsPerSource": { "title": "Max pins per keyword / board / profile", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stops each source after this many written pins.", "default": 100 }, "maxPins": { "title": "Max pins in total (hard cap)", "minimum": 1, "type": "integer", "description": "The run stops here, whatever the sources say. You are charged per written pin only, so this is also your spending cap.", "default": 1000 }, "exactSaves": { "title": "Exact save counts", "type": "boolean", "description": "Board and profile feeds already include saves. Search results do not; with this on, each search hit's own pin data is fetched to get the save count Pinterest shows on the pin. Off = faster, saves stay empty for search hits.", "default": true }, "minSaves": { "title": "Only pins with at least N saves", "minimum": 0, "type": "integer", "description": "Filtered pins are not written and not charged." }, "sinceDate": { "title": "Only pins created after (date)", "type": "string", "description": "YYYY-MM-DD. Filtered pins are not written and not charged." }, "sortBy": { "title": "Order per source", "enum": [ "pinterest", "saves", "savesPerDay", "newest" ], "type": "string", "description": "Sorts the pins collected per source before writing them.", "default": "pinterest" }, "skipPromoted": { "title": "Skip promoted pins (ads)", "type": "boolean", "description": "Promoted pins are skipped and not charged.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed: Pinterest answered from Apify's plain IP. Turn on the datacenter proxy only if you see HTTP 429 in the run summary.", "default": { "useApifyProxy": false } } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }