{"uid":"cap_3xHrcalOq1JDDfA_YRqnC","slug":"pinterest-trends-scraper-x402-a8465525","name":"Pinterest Trends Scraper (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/pinterest-trends?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"endDate":{"type":"string","description":"Requested end date in YYYY-MM-DD format. Empty uses today; Pinterest may return its latest available data date."},"maxItems":{"type":"integer","default":0,"minimum":0,"description":"Stop after this many rows across all tables. Zero means no total cap."},"countries":{"type":"array","items":{"enum":["US","CA","GB+IE","DE","FR","IT","ES","MX","BR","AU+NZ","AR","CO","IN","ID","MY","PH","TH","SA","EG","TR","KR","AT","CH","PT","GR","MT","SE","DK","FI","NO","NL","BE","LU","PL","RO","HU","SK","CZ","CL","AE","KW","QA","OM","BH","IQ","DZ","IL","NG","PK","ZA","MA","CR","DO","EC","GT","PE","CY"],"type":"string"},"default":["US"],"description":"Markets to query. Some countries resolve to a grouped Pinterest Trends region."},"trendTypes":{"type":"array","items":{"enum":["top_monthly","top_yearly","growing","seasonal"],"type":"string","enumTitles":["Top monthly","Top yearly","Growing","Seasonal"]},"default":["growing"],"description":"One or more ranked tables to collect per market."},"interestIds":{"type":"array","default":[],"description":"Optional Pinterest top-level interest IDs, such as 935541271955 for beauty."},"rankingMethod":{"enum":["TREND_RANK","TOTAL_SEARCH","WEEKLY_CHANGE","MONTHLY_CHANGE","YEARLY_CHANGE"],"type":"string","description":"Optional metric used to rank filtered trend rows."},"lookbackWindow":{"enum":["7D","30D","90D","180D","365D"],"type":"string","default":"30D","description":"Time range used for trend calculations."},"keywordsToExclude":{"type":"array","default":[],"description":"Remove trends matching these terms."},"keywordsToInclude":{"type":"array","default":[],"description":"Only return trends matching these terms. Leave empty for all topics."},"maxResultsPerCountry":{"type":"integer","default":50,"maximum":100,"minimum":1,"description":"Maximum rows per market and trend type. Pinterest currently caps each table at 100."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"rank":null,"term":null,"country":null,"trendType":null,"searchCount":null,"weeklyChange":null,"monthlyChange":null,"normalizedCount":null}],"product":"pinterest-trends"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YiK6YohAJdTrmLFMlxc6D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured Pinterest trend data — top monthly, yearly, growing, or seasonal keywords — across multiple countries and interest categories.","exampleAgentPrompt":"Pull the top 50 growing Pinterest trends in the US and Canada for the last 30 days, filtered to beauty-related interests, and rank them by monthly change.","exampleUseCases":[{"title":"Content calendar trend research","prompt":"What are the top 50 growing and seasonal Pinterest trends in the US and UK right now, over the past 90 days? I want to plan content for next month."},{"title":"Competitor keyword gap analysis","prompt":"Get me the top 100 monthly Pinterest search terms in the US, Germany, and France — I only want results that include the word 'sustainable' and rank them by total search count."},{"title":"Regional trend monitoring for retail","prompt":"Pull the top growing Pinterest trends in Brazil, Mexico, and Argentina for the last 30 days, limit 50 results per country, and exclude anything related to 'food'."}],"resultDescription":"Returns a JSON array of trend rows, each containing the keyword term, its rank, country, trend type (growing/seasonal/top_monthly/top_yearly), raw search count, weekly/monthly change percentages, and a normalized popularity count. Results are grouped by market and trend type.","failureModes":["Empty result set if keywords to include don't match any Pinterest trends (not charged)","Invalid country code returns validation error","End date beyond Pinterest's available data range may return latest available data instead","Interest ID not recognized by Pinterest returns empty rows","Rate limiting or payment failure results in 402 response without data charge"],"whenToPreferThis":"Use this endpoint when you need structured, filterable Pinterest trend data across multiple countries and interest categories with flexible ranking options. Prefer this over manual Pinterest Trends browsing when you need programmatic access, multi-country batch queries, or keyword filtering. The pay-per-call model with no charge for empty results makes it low-risk for exploratory queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:04.257Z","isFirstParty":false,"canonicalSlug":"pinterest-trends-scraper-x402-a8465525"}