{"uid":"cap_shGupFNzFNbjdkldvT2o5","slug":"socialfetch-google-ad-transparency-list-company-ads-8648dbf7","name":"SocialFetch Google Ad Transparency - List Company Ads","description":"List ads a company or advertiser is running in Google Ad Transparency.","url":"https://api.socialfetch.dev/v1/google/ad-library/companies/ads","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"topic":{"enum":["all","political"],"type":"string","description":"Optional topic filter. When `political`, `region` is required."},"cursor":{"type":"string","minLength":1,"description":"Opaque pagination cursor from a previous response."},"domain":{"type":"string","maxLength":4096,"minLength":1,"description":"Company domain when you do not have an advertiser id."},"format":{"enum":["text","image","video"],"type":"string","description":"Optional creative format filter."},"region":{"type":"string","description":"Optional region filter as a two-letter country code."},"endDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional end date filter in YYYY-MM-DD format."},"platform":{"enum":["google_maps","google_play","google_search","google_shopping","youtube"],"type":"string","description":"Optional Google surface filter."},"startDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Optional start date filter in YYYY-MM-DD format."},"advertiserId":{"type":"string","maxLength":4096,"minLength":1,"description":"Google Ad Transparency advertiser id when you have it instead of a domain."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.35","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.35/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.35","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_crohVkNVvIJvqu2JT9iTp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.35","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"List all ads a specific company or advertiser is currently running in Google Ad Transparency, with optional filters for topic, format, platform, region, and date range.","exampleAgentPrompt":"Can you pull up all the Google ads that nike.com is running right now, filtering to just YouTube video ads?","exampleUseCases":null,"resultDescription":"A paginated list of ad creatives from Google Ad Transparency associated with the specified company or advertiser, including creative metadata. Response includes a nextCursor for pagination through additional results.","failureModes":["Missing both domain and advertiserId — one is required to identify the advertiser","Invalid advertiserId format returns no results or error","Region not provided when topic=political — region is required for political ads","No ads found for the given domain or advertiser ID (advertiser not found in Ad Transparency)","Invalid date format (must be YYYY-MM-DD) causes validation error","Invalid enum value for platform, format, or topic causes bad request","Cursor from a previous query is expired or invalid, requiring a fresh request"],"whenToPreferThis":"Use this endpoint when you need to enumerate multiple ads for a specific company or advertiser from Google Ad Transparency, especially when you want to paginate through a full ad inventory, apply filters (platform, format, region, date, topic), or conduct competitive research. Prefer this over the single-ad detail endpoint when you need a list view rather than details on one known ad. Use domain as input when you don't have the Google advertiser ID.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:01:34.715Z","isFirstParty":false}