{"uid":"cap_TM5G9twctuXDignWPykHQ","slug":"pinterest-trends-scraper-f6f6cc60","name":"Pinterest Trends Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_E4PPv3Tc--88HBqY_uotr","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 ranked Pinterest trend data (top monthly, yearly, growing, seasonal) across multiple countries and interest categories","exampleAgentPrompt":"Pull the top 50 growing Pinterest trends in the US and UK for the last 30 days, ranked by weekly change, and filter to only include fashion-related terms.","exampleUseCases":[{"title":"Fashion brand trend discovery","prompt":"Get me the top 50 growing Pinterest trends in the US for the past 30 days, ranked by weekly change, but only include keywords related to fashion — I want to see what styles people are searching for right now."},{"title":"Seasonal campaign planning","prompt":"Fetch seasonal Pinterest trends for the US, Germany, and France with up to 100 results per country over the last 90 days — I'm planning a holiday campaign and need to know what topics spike seasonally."},{"title":"Beauty interest monitoring","prompt":"Pull the top monthly and growing Pinterest trends for the beauty interest category in the US, UK, and Australia, looking back 30 days, so I can see which beauty topics are gaining traction across English-speaking markets."}],"resultDescription":"A JSON array of trend rows, each containing the trend term, its rank, country market, trend type (e.g. growing, seasonal), search count, weekly/monthly change percentages, and normalized count — covering all requested markets and trend table types.","failureModes":["Pinterest returns no data for the requested date range or country, resulting in an empty items array (not charged)","Invalid country code or unsupported market causes a validation error","Requesting more than 100 results per country exceeds Pinterest's cap and is clamped","Network or scraping failure results in a failed run (not charged)","Invalid interest ID returns no filtered results"],"whenToPreferThis":"Choose this endpoint when you need structured, ranked Pinterest trend data across multiple markets and trend categories in one call. Prefer it over manual Pinterest Trends UI scraping or generic web scrapers when you need machine-readable output with fields like search count, weekly/monthly change, and rank. Best suited for marketing research, content strategy, SEO, and e-commerce keyword discovery workflows that rely on Pinterest as a discovery platform.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:55.772Z","isFirstParty":false,"canonicalSlug":"pinterest-trends-scraper-f6f6cc60"}