{"uid":"cap_ICYjdVuyRU29qSRxU5YAj","slug":"pinterest-ads-repository-search-2da60ecb","name":"Pinterest Ads Repository Search","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/pinterest-ads?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"age":{"enum":["ALL","AGE_18_24","AGE_25_34","AGE_35_44","AGE_45_49","AGE_50_54","AGE_55_64","AGE_65_PLUS"],"type":"string","default":"ALL","description":"Target age filter; ALL includes every group."},"gender":{"enum":["ALL","MALE","FEMALE","UNSPECIFIED"],"type":"string","default":"ALL","description":"Target gender filter; ALL includes every group."},"country":{"enum":["AT","BE","BG","HR","CY","CZ","DK","EE","FI","FR","DE","GR","HU","IE","IT","LV","LT","LU","MT","NL","PL","PT","RO","SK","SI","ES","SE","BR","TR"],"type":"string","default":"DE","description":"Country whose public ad repository results to search."},"endDate":{"type":"string","description":"Last date to search, as YYYY-MM-DD or a relative value such as 1 day. Empty means today."},"category":{"enum":["ALL","ANIMALS","ARCHITECTURE","ART","BEAUTY","CHILDRENS_FASHION","DESIGN","DIY_AND_CRAFTS","EDUCATION","ELECTRONICS","ENTERTAINMENT","EVENT_PLANNING","FINANCE","FOOD_AND_DRINKS","HEALTH","HOME_DECOR","GARDENING","MENS_FASHION","PARENTING","QUOTES","SPORT","TRAVEL","VEHICLES","WEDDING","WOMENS_FASHION","OTHER"],"type":"string","default":"ALL","description":"Ad category; ALL includes every category."},"startDate":{"type":"string","default":"30 days","description":"First date to search, as YYYY-MM-DD or a relative value such as 7 days. Searches can go back 365 days."},"maxResults":{"type":"integer","default":100,"minimum":0,"description":"Stop after this many unique ads. Zero removes the output cap."},"advertiserName":{"type":"string","description":"Filter repository results by advertiser name."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"id":null,"url":null,"title":null,"domain":null,"imageUrl":null,"videoUrl":null,"description":null,"advertiserName":null}],"product":"pinterest-ads"}},"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_rPWlhl6wSXscVB_0Q7bYv","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":"Searches Pinterest's public ad repository and returns structured ad data filtered by country, category, age, gender, date range, and advertiser name.","exampleAgentPrompt":"Can you pull the last 60 days of Pinterest ads in the TRAVEL category from France, targeting women aged 25-34, and give me up to 50 results? I want to see what advertisers are running there.","exampleUseCases":[{"title":"Competitor ad creative research","prompt":"Show me what ads TUI is running on Pinterest in Germany over the past 30 days — I want to see their creatives, titles, and landing page domains."},{"title":"Niche market ad landscape survey","prompt":"Pull up to 100 Pinterest ads in the FOOD_AND_DRINKS category from Brazil from the last 90 days so I can see what brands and creatives are popular there right now."},{"title":"Demographic-targeted ad intelligence","prompt":"Find Pinterest ads in the BEAUTY category targeting women aged 18-24 in France from the past two weeks — give me the image URLs and advertiser names."}],"resultDescription":"Returns a JSON object with a count of matched ads and an array of ad items, each containing the ad's ID, URL, title, domain, image URL, video URL, description, and advertiser name. Failed or empty runs are not billed.","failureModes":["No ads found matching the filters — returns empty items array (not charged)","Invalid date format for startDate/endDate — request rejected","Unsupported country code provided — enum validation error","Rate limiting or upstream Pinterest repository unavailability — service error","Invalid category or gender enum value — schema validation failure"],"whenToPreferThis":"Choose this endpoint when you need structured, filterable access to Pinterest's public ad repository — especially for competitive intelligence, market research, or ad creative benchmarking across specific countries, demographics, and categories. It is particularly useful when you need historical ad data going back up to 365 days or want to filter by advertiser name.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:17.132Z","isFirstParty":false,"canonicalSlug":"pinterest-ads-repository-search-2da60ecb"}