{ "openapi": "3.0.1", "info": { "title": "Pinterest Search Scraper: Product Page Details Extractor", "description": "Pinterest Search Scraper extracts product page details from search results, including titles, prices, descriptions, images, product links, sellers, ratings, and availability. Ideal for product research, competitor analysis, trend discovery, price monitoring, and e-commerce intelligence.", "version": "0.1", "x-build-id": "cDdCc684UOakbyaeF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~pinterest-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-pinterest-search-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/scrapio~pinterest-search-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-pinterest-search-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/scrapio~pinterest-search-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-pinterest-search-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": [ "searchTerm" ], "properties": { "searchTerm": { "title": "๐Ÿ”Ž Product Search Term", "type": "string", "description": "What to search for on Pinterest. For link/product intelligence, shopping-style queries work best (e.g. \"nike shoes\", \"leather sofa\", \"skincare\"). Example: nike shoes.", "default": "nike shoes" }, "pinType": { "title": "๐Ÿ“Œ Pin Type", "enum": [ "all", "videos" ], "type": "string", "description": "Extract all pins, or restrict to video pins only. Default: all.", "default": "all" }, "maxPins": { "title": "๐Ÿ“Š Max Pins", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many pins to extract (1โ€“10,000). Example: 100.", "default": 100 }, "includeOnlyLinkedPins": { "title": "โ†ช๏ธ Only Pins With an Outbound Link", "type": "boolean", "description": "When on, only pins that link out to an external website are kept (skips pins with no destination). Default: off.", "default": false }, "domainFilter": { "title": "โœ… Include Only These Domains", "type": "array", "description": "Keep only pins whose destination domain contains one of these values (substring match, case-insensitive). Empty = all domains. Example: [\"amazon.com\", \"etsy.com\"].", "default": [], "items": { "type": "string" } }, "excludedDomains": { "title": "๐Ÿšซ Exclude These Domains", "type": "array", "description": "Drop pins whose destination domain contains one of these values (substring match). Example: [\"pinterest.com\"].", "default": [], "items": { "type": "string" } }, "includeLinkSummary": { "title": "๐Ÿงพ Emit Link Summary Row", "type": "boolean", "description": "Append one summary row (rowType=linkSummary) with unique domains, per-domain counts, top destinations and product coverage. Also saved to the LINK_SUMMARY key-value record. Default: on.", "default": true }, "includeProductData": { "title": "๐Ÿท๏ธ Extract Product Price / Brand", "type": "boolean", "description": "For likely product pins, fetch the closeup page and parse ld+json for price, currency, brand and availability. Best-effort: non-product pins stay null. Costs one extra request per product-pin lookup. Default: on.", "default": true }, "maxProductLookups": { "title": "๐Ÿ”ข Max Product Lookups", "minimum": 0, "type": "integer", "description": "Cap on how many closeup product-detail fetches to perform per run (0 = unlimited). Keeps runtime/cost bounded. Example: 30.", "default": 30 }, "proxyConfiguration": { "title": "๐ŸŒ Proxy Configuration", "type": "object", "description": "Apify Residential proxy is strongly recommended โ€” Pinterest blocks datacenter IPs and the run will return zero pins without a residential session.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }