# Pinterest Trends Scraper Export Pinterest Trends rankings by country, trend type, interest, and event, with each term's popularity index, weekly, monthly, and yearly growth, and seasonality score. - Template page: [https://www.octoparse.com/template/pinterest-trends-scraper](https://www.octoparse.com/template/pinterest-trends-scraper) - Categories: Social Media - Status: `PUBLISHED` - Run mode: `CLOUD` ## Pricing Free. ## What is an Octoparse template? An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters. ## Overview This ready-to-use template collects structured data from web pages. ## Output The current workflow extracts 17 fields, including `country`, `countryInput`, `endDate`, `error`, `events`, `interests`, `monthlyChange`, `normalizedCount`, `pinterestTrendsUrl`, `rank`, `scrapedAt`, `searchCount`, `seasonalityScore`, `term`, `trendType`, `weeklyChange`, `yearlyChange`. ## Use Cases - Use structured results for research, comparison, and monitoring. - Collect rows without building the extraction workflow from scratch. - Combine results with other templates for downstream enrichment. - Review a representative result before starting a large batch. ## Why Octoparse - **No coding required:** complete Countries / regions, Trend types, Interests and start the template in cloud mode. - **Flexible export:** review and export results as CSV, Excel, or JSON. ## Input ### Countries / regions Required. Supported Pinterest Trends markets. Countries such as Switzerland are resolved to Pinterest's official regional market. Callable values are the `const` keys in JSON `oneOf`, not the option titles. ### Trend types Required. Types of Pinterest Trends tables to extract. Callable values are the `const` keys in JSON `oneOf`, not the option titles. ### Interests Optional. Restrict trends to Pinterest's top-level interest categories. Leave empty for all interests. Selecting several runs one query per interest so every result row shows which interest it came from. Callable values are the `const` keys in JSON `oneOf`, not the option titles. ### Events Optional. Restrict trends to a seasonal event or shopping moment (Halloween, Black Friday, Ramadan …). Leave empty for no event filter. Events that the chosen country does not celebrate are skipped with a warning, and an event well outside its season usually returns nothing. Callable values are the `const` keys in JSON `oneOf`, not the option titles. ## How to Use # Pinterest Trends Scraper Octoparse template that exports current Pinterest Trends rankings by market, trend type, interest, and event. One trending term is one row. ## Cost Free to use; no per-row fee. Each country/filter combination returns up to 50 rows. Runs on Octoparse Cloud, included in the Standard plan and above. See [Octoparse pricing](https://www.octoparse.com/pricing). ## Inputs - **Countries / regions** (required): one or more of: United States, Great Britain and Ireland, Canada, Southern Europe (GR, IT, MT, PT, ES), Italy, Spain, German-speaking countries (DE, AT, CH), Germany, France, Nordic countries (NO, FI, DK, SE), Benelux (NL, BE, LU), Eastern Europe (HU, PL, RO, SK, CZ), Hispanic Latin America (CL, CO, AR, MX), Colombia, Argentina, Mexico, Brazil, Australasia (AU, NZ), Malaysia, Philippines, Thailand, Egypt, Turkey, South Korea, Latin America and Caribbean (CR, DO, EC, GT, PE), Eastern Europe and Mediterranean (CY, CZ, GR, HU, MT, PL, RO, SK). - **Trend types** (required): Top monthly trends, Top yearly trends, Growing trends, Seasonal trends. - **Interests** (optional): Animals, Architecture, Art, Beauty, Design, DIY & Crafts, Education, Electronics, Entertainment, Event Planning, Kids' Fashion, Men's Fashion, Women's Fashion, Finance, Food & Drinks, Gardening, Health, Home Decor, Parenting, Quotes, Sport, Travel, Vehicles, Wedding. Each interest is collected as its own list. Leave blank for all interests. - **Events** (optional): Autumn, Back to School, Bank Holiday, Black Friday, Canada Day, Carnaval, Children's Day, Christmas, Cinco de Mayo, Colombia Moda, Coming of Age Ceremony, Diwali, Earth Day, Easter, Father's Day, Festa Junina, Friend's Day, Golden Week, Halloween, Hanukkah, Hinamatsuri, Hot Sale, Independence Day, Karneval, Lunar New Year, March Madness, Mardi Gras, Memorial Day, Mother's Day, NAIDOC Week, New Year's Eve, Oktoberfest, Passover, Pride, Prom, Rain Season, Ramadan, Respect of the Aged Day, Setsubun, Shichigosan, Sports Day, Spring, Spring Break, Spring Racing Carnival, St Patrick's Day, Summer, Superbowl, Tanabata, Thanksgiving, Tsukimi, Valentine's Day, Victoria Day, White Day, Winter. Each market supports only some events and only around their season. Leave blank for no event filter. Each country is combined with each chosen interest and event. Example: 2 countries, 3 interests, no event = 6 lists of up to 50 rows each. Limit: up to 100 interest and event combinations per task; split across tasks if needed. ## Output Rows include term and rank; normalizedCount and searchCount (relative index within one list; top term = 100); weeklyChange, monthlyChange, yearlyChange (as shown on Pinterest Trends, e.g. -30%, 2,500%, 10,000%+); seasonalityScore (0–1; higher = more seasonal); source fields country, countryInput, trendType, interests, events, endDate; pinterestTrendsUrl; scrapedAt; error (empty unless that list could not be collected). normalizedCount is not the number of searches. Compare terms within the same list, not across countries or filters. ## How to use 1. [Create a free Octoparse account](https://www.octoparse.com/console/trial). 2. [Open Pinterest Trends Scraper](https://www.octoparse.com/console/template/pinterest-trends-scraper) and click "Try it!". 3. Choose Countries / regions and Trend types. 4. Optionally choose Interests or Events. 5. Start the task. It runs on Octoparse Cloud. 6. Review rows and export to CSV, Excel, or JSON. ## Limitations - **Events depend on market and season:** Pinterest Trends offers each event only in some markets and around its season. In an October 2026 test for the United States, Christmas and Halloween returned trends, while Black Friday did not. If an event is unavailable, the template adds one row with trend fields empty and the reason in error, and still collects your other choices. - **App only for now:** All four inputs are dropdowns. Pinterest Trends Scraper does not accept them through the Octoparse API or Octoparse MCP yet. Start runs in the Octoparse app. You can still schedule runs on Octoparse Cloud. - **Rankings, not history:** Exports current ranking lists. The week-by-week popularity chart for each term needs a Pinterest login, so it is not included; open pinterestTrendsUrl to view it on Pinterest. - **Up to 100 filter combinations:** A task can include up to 100 interest and event combinations. Split across several tasks if you need more. ## Tips - Start with one market and no interest or event, then add filters. - Choose an event a few weeks before it happens; far outside its season, it usually returns an error row instead of trends. - Schedule the same task weekly and compare rank and weeklyChange across exports to spot terms that keep climbing. - Filter by country, interests, and events before ranking terms across lists, because normalizedCount is relative to each list. ## Limitations Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above. ## Tips Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed. ## FAQ ### What do I need to enter? Use the exact inputs and limits listed above. ### What data does this template return? See Output Schema below; availability can vary by source record. ### How is usage billed? See the Pricing section above for current pricing and billing details. ## Related Templates - [Pinterest Search Scraper](https://www.octoparse.com/template/pinterest-search-scraper) - [Bic Camera Search Results Scraper](https://www.octoparse.com/template/bic-camera-search-results-scraper) - [Google Search Scraper](https://www.octoparse.com/template/google-search-scraper) - [Google Maps Listings Scraper (by Keywords)](https://www.octoparse.com/template/google-maps-scraper-listing-page-by-keyword) - [Google Maps Email Scraper & Extractor](https://www.octoparse.com/template/google-maps-contact-scraper) ## Input Schema ```json { "title": "Pinterest Trends Scraper input", "description": "Input parameters configured for the current published template version.", "type": "object", "schemaVersion": 1, "additionalProperties": false, "properties": { "countries_/_regions": { "title": "Countries / regions", "description": "Supported Pinterest Trends markets. Countries such as Switzerland are resolved to Pinterest's official regional market.", "type": "array", "items": { "type": "string", "oneOf": [ { "title": "US", "const": "United States" }, { "title": "GB+IE", "const": "Great Britain and Ireland" }, { "title": "CA", "const": "Canada" }, { "title": "IT+ES+PT+GR+MT", "const": "Southern Europe (GR, IT, MT, PT, ES)" }, { "title": "IT", "const": "Italy" }, { "title": "ES", "const": "Spain" }, { "title": "DE+AT+CH", "const": "German-speaking countries (DE, AT, CH)" }, { "title": "DE", "const": "Germany" }, { "title": "FR", "const": "France" }, { "title": "NO+FI+DK+SE", "const": "Nordic countries (NO, FI, DK, SE)" }, { "title": "NL+BE+LU", "const": "Benelux (NL, BE, LU)" }, { "title": "HU+PL+RO+SK+CZ", "const": "Eastern Europe (HU, PL, RO, SK, CZ)" }, { "title": "CL+CO+AR+MX", "const": "Hispanic Latin America (CL, CO, AR, MX)" }, { "title": "CO", "const": "Colombia" }, { "title": "AR", "const": "Argentina" }, { "title": "MX", "const": "Mexico" }, { "title": "BR", "const": "Brazil" }, { "title": "AU+NZ", "const": "Australasia (AU, NZ)" }, { "title": "MY", "const": "Malaysia" }, { "title": "PH", "const": "Philippines" }, { "title": "TH", "const": "Thailand" }, { "title": "EG", "const": "Egypt" }, { "title": "TR", "const": "Turkey" }, { "title": "KR", "const": "South Korea" }, { "title": "CR+DO+EC+GT+PE", "const": "Latin America and Caribbean (CR, DO, EC, GT, PE)" }, { "title": "CY+CZ+GR+HU+MT+PL+RO+SK", "const": "Eastern Europe and Mediterranean (CY, CZ, GR, HU, MT, PL, RO, SK)" } ] }, "x-octoparse": { "apiEnabled": false } }, "trend_types": { "title": "Trend types", "description": "Types of Pinterest Trends tables to extract.\n\n", "type": "string", "oneOf": [ { "title": "TOP_MONTHLY", "const": "Top monthly trends" }, { "title": "TOP_YEARLY", "const": "Top yearly trends" }, { "title": "GROWING", "const": "Growing trends" }, { "title": "SEASONAL", "const": "Seasonal trends" } ], "x-octoparse": { "apiEnabled": false } }, "interests": { "title": "Interests", "description": "Restrict trends to Pinterest's top-level interest categories. Leave empty for all interests. Selecting several runs one query per interest so every result row shows which interest it came from.\n", "type": "array", "items": { "type": "string", "oneOf": [ { "title": "ANIMALS", "const": "Animals" }, { "title": "ARCHITECTURE", "const": "Architecture" }, { "title": "ART", "const": "Art" }, { "title": "BEAUTY", "const": "Beauty" }, { "title": "DESIGN", "const": "Design" }, { "title": "DIY_AND_CRAFTS", "const": "DIY & Crafts" }, { "title": "EDUCATION", "const": "Education" }, { "title": "ELECTRONICS", "const": "Electronics" }, { "title": "ENTERTAINMENT", "const": "Entertainment" }, { "title": "EVENT_PLANNING", "const": "Event Planning" }, { "title": "FASHION_KIDS", "const": "Kids' Fashion" }, { "title": "FASHION_MENS", "const": "Men's Fashion" }, { "title": "FASHION_WOMENS", "const": "Women's Fashion" }, { "title": "FINANCE", "const": "Finance" }, { "title": "FOOD_AND_DRINKS", "const": "Food & Drinks" }, { "title": "GARDENING", "const": "Gardening" }, { "title": "HEALTH", "const": "Health" }, { "title": "HOME_DECOR", "const": "Home Decor" }, { "title": "PARENTING", "const": "Parenting" }, { "title": "QUOTES", "const": "Quotes" }, { "title": "SPORT", "const": "Sport" }, { "title": "TRAVEL", "const": "Travel" }, { "title": "VEHICLES", "const": "Vehicles" }, { "title": "WEDDING", "const": "Wedding" } ] }, "x-octoparse": { "apiEnabled": false } }, "events": { "title": "Events", "description": "Restrict trends to a seasonal event or shopping moment (Halloween, Black Friday, Ramadan …). Leave empty for no event filter. Events that the chosen country does not celebrate are skipped with a warning, and an event well outside its season usually returns nothing.\n", "type": "array", "items": { "type": "string", "oneOf": [ { "title": "autumn", "const": "Autumn" }, { "title": "back to school", "const": "Back to School" }, { "title": "bank holiday", "const": "Bank Holiday" }, { "title": "black friday", "const": "Black Friday" }, { "title": "canada day", "const": "Canada Day" }, { "title": "carnaval", "const": "Carnaval" }, { "title": "childrens day", "const": "Children's Day" }, { "title": "christmas", "const": "Christmas" }, { "title": "cinco de mayo", "const": "Cinco de Mayo" }, { "title": "colombia moda", "const": "Colombia Moda" }, { "title": "coming of age ceremony", "const": "Coming of Age Ceremony" }, { "title": "diwali", "const": "Diwali" }, { "title": "earth day", "const": "Earth Day" }, { "title": "easter", "const": "Easter" }, { "title": "fathers day", "const": "Father's Day" }, { "title": "festa junina", "const": "Festa Junina" }, { "title": "friends day", "const": "Friend's Day" }, { "title": "golden week", "const": "Golden Week" }, { "title": "halloween", "const": "Halloween" }, { "title": "hanukkah", "const": "Hanukkah" }, { "title": "hinamatsuri", "const": "Hinamatsuri" }, { "title": "hot sale", "const": "Hot Sale" }, { "title": "independence day", "const": "Independence Day" }, { "title": "karneval", "const": "Karneval" }, { "title": "lunar new year", "const": "Lunar New Year" }, { "title": "march madness", "const": "March Madness" }, { "title": "mardi gras", "const": "Mardi Gras" }, { "title": "memorial day", "const": "Memorial Day" }, { "title": "mothers day", "const": "Mother's Day" }, { "title": "naidoc week", "const": "NAIDOC Week" }, { "title": "new years eve", "const": "New Year's Eve" }, { "title": "oktoberfest", "const": "Oktoberfest" }, { "title": "passover", "const": "Passover" }, { "title": "pride", "const": "Pride" }, { "title": "prom", "const": "Prom" }, { "title": "rain season", "const": "Rain Season" }, { "title": "ramadan", "const": "Ramadan" }, { "title": "respect of the aged day", "const": "Respect of the Aged Day" }, { "title": "setsubun", "const": "Setsubun" }, { "title": "shichigosan", "const": "Shichigosan" }, { "title": "sports day", "const": "Sports Day" }, { "title": "spring", "const": "Spring" }, { "title": "spring break", "const": "Spring Break" }, { "title": "spring racing carnival", "const": "Spring Racing Carnival" }, { "title": "st patricks day", "const": "St Patrick's Day" }, { "title": "summer", "const": "Summer" }, { "title": "superbowl", "const": "Superbowl" }, { "title": "tanabata", "const": "Tanabata" }, { "title": "thanksgiving", "const": "Thanksgiving" }, { "title": "tsukimi", "const": "Tsukimi" }, { "title": "valentines day", "const": "Valentine's Day" }, { "title": "victoria day", "const": "Victoria Day" }, { "title": "white day", "const": "White Day" }, { "title": "winter", "const": "Winter" } ] }, "x-octoparse": { "apiEnabled": false } } }, "required": [ "countries_/_regions", "trend_types" ] } ``` ## Input JSON Example No verified real input/output examples are currently available. ## Output Schema ```json { "schemaVersion": 1, "type": "object", "properties": { "country": { "type": "string", "description": "" }, "countryInput": { "type": "string", "description": "" }, "endDate": { "type": "string", "description": "" }, "error": { "type": "string", "description": "" }, "events": { "type": "string", "description": "" }, "interests": { "type": "string", "description": "" }, "monthlyChange": { "type": "string", "description": "" }, "normalizedCount": { "type": "string", "description": "" }, "pinterestTrendsUrl": { "type": "string", "description": "" }, "rank": { "type": "string", "description": "" }, "scrapedAt": { "type": "string", "description": "" }, "searchCount": { "type": "string", "description": "" }, "seasonalityScore": { "type": "string", "description": "" }, "term": { "type": "string", "description": "" }, "trendType": { "type": "string", "description": "" }, "weeklyChange": { "type": "string", "description": "" }, "yearlyChange": { "type": "string", "description": "" } }, "title": "Pinterest Trends Scraper output", "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.", "additionalProperties": false } ``` ## Output Example No verified real input/output examples are currently available. ## API `POST https://openapi.octoparse.com/api/agentTools/executeTask` This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token. Request body: `templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional. Obtain a token: ```http POST https://openapi.octoparse.com/token Content-Type: application/json { "username": "YOUR_USERNAME", "password": "YOUR_PASSWORD", "grant_type": "password" } ``` Use `data.access_token` as `Authorization: Bearer `. After starting, poll `getTaskStatus` and export with `exportData`. No verified real input/output examples are currently available. ## MCP Setup Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `pinterest-trends-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results. ## Machine-readable Resources - [Template contract](https://www.octoparse.com/templates/pinterest-trends-scraper.json) - [Manifest](https://www.octoparse.com/templates/pinterest-trends-scraper-manifest.json)