{ "openapi": "3.0.1", "info": { "title": "Pinterest Trends Scraper & API: Trending Keywords & Volume", "description": "Scrape Pinterest Trends without login: growing, top and seasonal searches in 29 markets, by interest or keyword, and keyword research (related and autocomplete searches). Search index, weekly / monthly / yearly change, a year of history, age and gender, new trends alerts.", "version": "0.1", "x-build-id": "fG5gHXgdiaTSl5GpO" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s_actors~pinterest-trends-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s_actors-pinterest-trends-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/s_actors~pinterest-trends-scraper/runs": { "post": { "operationId": "runs-sync-s_actors-pinterest-trends-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/s_actors~pinterest-trends-scraper/run-sync": { "post": { "operationId": "run-sync-s_actors-pinterest-trends-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": { "mode": { "title": "What to scrape", "enum": [ "trending", "keywords" ], "type": "string", "description": "Trending searches: the lists of Pinterest Trends for each market (growing, top monthly, top yearly, seasonal). Keyword research: for each of your keywords, the keyword itself, the related searches and the autocomplete searches Pinterest shows, with their volume.", "default": "trending" }, "countries": { "title": "Countries / markets", "type": "array", "description": "Pinterest Trends markets. Smaller countries are part of a regional market (Austria and Switzerland: Germany, Austria & Switzerland; the Netherlands: Benelux...), the row shows the market code.", "items": { "type": "string", "enum": [ "US", "CA", "GB+IE", "DE", "FR", "IT", "ES", "BR", "MX", "AR", "CO", "IN", "ID", "KR", "MY", "PH", "TH", "SA", "EG", "TR", "AU+NZ", "DE+AT+CH", "SE+DK+FI+NO", "NL+BE+LU", "PL+RO+HU+SK+CZ", "IT+ES+PT+GR+MT", "MX+AR+CO+CL", "CR+DO+EC+GT+PE", "CY+CZ+GR+HU+MT+PL+RO+SK", "AT", "AU", "BE", "CH", "CL", "CR", "CY", "CZ", "DK", "DO", "EC", "FI", "GB", "GR", "GT", "HU", "IE", "LU", "MT", "NL", "NO", "NZ", "PE", "PL", "PT", "RO", "SE", "SK", "UK" ], "enumTitles": [ "United States", "Canada", "United Kingdom & Ireland (GB+IE)", "Germany", "France", "Italy", "Spain", "Brazil", "Mexico", "Argentina", "Colombia", "India", "Indonesia", "South Korea", "Malaysia", "Philippines", "Thailand", "Saudi Arabia", "Egypt", "Turkey", "Australia & New Zealand (AU+NZ)", "Germany, Austria & Switzerland (DE+AT+CH)", "Nordics (SE+DK+FI+NO)", "Benelux (NL+BE+LU)", "Eastern Europe (PL+RO+HU+SK+CZ)", "Southern Europe (IT+ES+PT+GR+MT)", "Hispanic Latin America (MX+AR+CO+CL)", "Latin America & Caribbean (CR+DO+EC+GT+PE)", "Eastern Europe & Mediterranean (CY+CZ+GR+HU+MT+PL+RO+SK)", "AT (in Germany, Austria & Switzerland)", "AU (in Australia & New Zealand)", "BE (in Benelux)", "CH (in Germany, Austria & Switzerland)", "CL (in Hispanic Latin America)", "CR (in Latin America & Caribbean)", "CY (in Eastern Europe & Mediterranean)", "CZ (in Eastern Europe)", "DK (in Nordics)", "DO (in Latin America & Caribbean)", "EC (in Latin America & Caribbean)", "FI (in Nordics)", "GB (in United Kingdom & Ireland)", "GR (in Southern Europe)", "GT (in Latin America & Caribbean)", "HU (in Eastern Europe)", "IE (in United Kingdom & Ireland)", "LU (in Benelux)", "MT (in Southern Europe)", "NL (in Benelux)", "NO (in Nordics)", "NZ (in Australia & New Zealand)", "PE (in Latin America & Caribbean)", "PL (in Eastern Europe)", "PT (in Southern Europe)", "RO (in Eastern Europe)", "SE (in Nordics)", "SK (in Eastern Europe)", "UK (in United Kingdom & Ireland)" ] }, "default": [ "US" ] }, "trendTypes": { "title": "Trend lists", "type": "array", "description": "Growing: fastest growing searches this month. Top monthly / yearly: the most searched. Seasonal: searches that come back at this time every year.", "items": { "type": "string", "enum": [ "growing", "top_monthly", "top_yearly", "seasonal" ], "enumTitles": [ "Growing trends", "Top monthly trends", "Top yearly trends", "Seasonal trends" ] }, "default": [ "growing" ] }, "interests": { "title": "Interests", "type": "array", "description": "Only trends of these Pinterest categories (one list per interest). Empty = all interests.", "items": { "type": "string", "enum": [ "animals", "architecture", "art", "beauty", "childrens_fashion", "diy_and_crafts", "design", "education", "electronics", "entertainment", "event_planning", "finance", "food_and_drinks", "gardening", "health", "home_decor", "mens_fashion", "parenting", "quotes", "sport", "travel", "vehicles", "wedding", "womens_fashion" ], "enumTitles": [ "Animals", "Architecture", "Art", "Beauty", "Children's fashion", "DIY and crafts", "Design", "Education", "Electronics", "Entertainment", "Event planning", "Finance", "Food and drinks", "Gardening", "Health", "Home decor", "Men's fashion", "Parenting", "Quotes", "Sport", "Travel", "Vehicles", "Wedding", "Women's fashion" ] } }, "keywordsToInclude": { "title": "Must contain", "type": "array", "description": "Only trends that contain one of these words, e.g. \"nails\", \"wedding\", \"recipe\".", "items": { "type": "string" } }, "keywordsToExclude": { "title": "Must not contain", "type": "array", "description": "Leave out trends (and keyword research results) with these words.", "items": { "type": "string" } }, "maxTrends": { "title": "Trends per list", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many trends of each list (market x trend list x interest). Pinterest gives up to 100.", "default": 50 }, "onlyNew": { "title": "Only new trends", "type": "boolean", "description": "Output only trends that were not in this list in the previous runs (with the same monitor name). Schedule the Actor daily or weekly to get alerts of new trends. Every row also has isNew and previousRank.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Keeps the memory of new trends apart for different schedules." }, "keywords": { "title": "Keywords", "type": "array", "description": "Seed keywords for keyword research (What to scrape = Keyword research): you get the seed, its related searches and its autocomplete searches with volume and history.", "items": { "type": "string" } }, "includeRelated": { "title": "Related searches", "type": "boolean", "description": "Add the searches Pinterest shows as related to each keyword.", "default": true }, "includeAutocomplete": { "title": "Autocomplete searches", "type": "boolean", "description": "Add the Pinterest searches that start with each keyword (long tail).", "default": true }, "includeHistory": { "title": "Weekly history", "type": "boolean", "description": "A year of weekly search index per keyword, plus peak, peak week and average.", "default": true }, "includeAudience": { "title": "Audience (age and gender)", "type": "boolean", "description": "Share of women and men and the age groups of the people searching each keyword.", "default": true }, "includeImages": { "title": "Pin image", "type": "boolean", "description": "A top pin image for each keyword.", "default": true }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Log every request retry.", "default": 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 } } } } } } } } } }