{ "openapi": "3.0.1", "info": { "title": "Pinterest Comment Scraper (Flattened Bulk Export)", "description": "Pinterest Comment Scraper extracts comments from Pinterest pins with flattened bulk export, including comment text, user details, timestamps, replies, reactions, and pin URLs. Ideal for audience research, sentiment analysis, engagement tracking, content insights, and social media intelligence.", "version": "0.1", "x-build-id": "ytQhJDM3z3z1B0SA8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~pinterest-comment-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-pinterest-comment-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/simpleapi~pinterest-comment-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-pinterest-comment-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/simpleapi~pinterest-comment-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-pinterest-comment-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": [ "urls" ], "properties": { "urls": { "title": "๐Ÿ“Ž Pin URLs or IDs (bulk)", "type": "array", "description": "Paste Pinterest pin links or numeric IDs โ€” one per line. Bulk-friendly: add as many pins as you like. Example: https://www.pinterest.com/pin/636977941054343221/", "items": { "type": "string" } }, "domain": { "title": "๐ŸŒ Region / Domain", "enum": [ "www.pinterest.com", "jp.pinterest.com", "br.pinterest.com", "uk.pinterest.com", "au.pinterest.com", "nz.pinterest.com", "co.pinterest.com", "de.pinterest.com", "fr.pinterest.com", "in.pinterest.com", "es.pinterest.com", "it.pinterest.com", "nl.pinterest.com", "pl.pinterest.com", "ru.pinterest.com", "tr.pinterest.com", "mx.pinterest.com", "ar.pinterest.com", "id.pinterest.com", "ph.pinterest.com", "th.pinterest.com", "kr.pinterest.com" ], "type": "string", "description": "Pick the Pinterest region that matches where your pins live โ€” e.g. jp.pinterest.com for Japan, uk.pinterest.com for the UK.", "default": "www.pinterest.com" }, "limit": { "title": "๐Ÿ’ฌ Comments per pin", "minimum": 1, "type": "integer", "description": "Cap comments fetched per pin. Default: 10. Increase (e.g. 100+) for fuller extraction.", "default": 10 }, "flattenedOutput": { "title": "๐Ÿงพ Flatten to spreadsheet columns", "type": "boolean", "description": "ON (default): each row is flattened to dot-separated columns (user.username, images.0.url, โ€ฆ) so CSV/Excel export needs zero post-processing. OFF: keep the original nested JSON objects.", "default": true }, "maxConcurrency": { "title": "โšก Parallel pins", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many pins to process in parallel (1โ€“20). Higher = faster bulk runs. Default: 10.", "default": 10 }, "maxTotalChargeUsd": { "title": "๐Ÿ’ต Hard spend cap (USD)", "minimum": 0, "type": "number", "description": "Stop the run cleanly once the estimated pay-per-event spend reaches this many US dollars. Default: 10. Estimated at $0.005 per charged row; Apify's own charge limit still applies on top.", "default": 10 }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy", "type": "object", "description": "Optional. Start with no proxy for speed; the actor auto-escalates none โ†’ datacenter โ†’ residential if Pinterest blocks." } } }, "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 } } } } } } } } } }