Reddit Ad Library Scraper — Ad Inspiration (Competitor Ads)

Spy on real Reddit ads. This actor pulls Reddit's own Ad Inspiration Library — the gallery of live, best‑performing promoted posts that Reddit shows advertisers — and returns each ad as clean JSON: headline, body, call‑to‑action, destination URL, media, advertiser, plus the industry, budget tier, campaign objective and placements. Search by keyword and filter by vertical, budget, objective or placement.

Zero setup. No login, no token, no cookies. Just run it. Most Reddit‑ad scrapers make you paste a session or an API key — this one ships with a maintained session and refreshes its own access token, so it works out of the box.

You provide	You get back
A keyword (e.g. insurance, crypto, skincare)	Every matching ad in the Inspiration Library
Nothing (empty query)	Top ads across all verticals
Optional filters (industry / budget / objective / placement)	Only the ads that match

Pure HTTP against Reddit's official ads API. No browser, no third‑party CF‑bypass service.

Why use it

• Competitor ad intelligence — see exactly what brands in your niche are running on Reddit: their hook, creative, CTA and landing page.
• The official library, not feed‑scraping — searchable by advertiser vertical/objective/budget, not just whatever ads happen to be served to a browsing session.
• Richest schema on the Store — 17 fields per ad, including the campaign‑level metadata (industry, budget tier, objective, placements) most scrapers can't see.
• Truly hands‑off — auto‑refreshing auth means no expiring tokens to babysit.

How it works

1. The actor mints a fresh short‑lived access token from a maintained Reddit Ads session (auto‑refresh — nothing for you to configure).
2. It calls Reddit's inspiration_creatives/search endpoint with your keyword.
3. It follows cursor pagination until it has maxItems ads.
4. Each ad is flattened to a tidy row and pushed to your dataset. Industry / budget / objective / placement filters are applied as it goes.

Input

Field	Type	Required	Notes
query	string	no	Keyword to search (verticals, brands, topics). Empty = browse top ads across all verticals.
industries	array	no	Keep only these verticals. See enum below.
budgetCategories	array	no	Keep only these advertiser budget tiers: LOW, MEDIUM, HIGH.
objectives	array	no	Keep only these campaign objectives: CONVERSIONS, CLICKS, IMPRESSIONS, APP_INSTALLS.
placements	array	no	Keep only ads in these placements: FEED, COMMENTS_PAGE.
maxItems	integer	no	Stop after this many ads (default 100).
redditSessionCookies	string	no	Advanced/optional. Bring your own Reddit Ads session (auto‑refreshes). Leave empty to use the built‑in session.
bearerToken	string	no	Advanced/optional. A raw 24h token override.

industries enum: TECH_B2B, TECH_B2C, FINANCIAL_SERVICES, HEALTH_AND_BEAUTY, RETAIL_AND_ECOMMERCE, ENTERTAINMENT, GAMING, EDUCATION, POLITICS_AND_GOVERNMENT, OTHER.

Example input

{
  "query": "insurance",
  "industries": ["FINANCIAL_SERVICES"],
  "maxItems": 200
}

Output

One row per ad. Example (real result):

{
  "id": "0ce788d0838ff83de532ffed5bf45a07",
  "industry": "FINANCIAL_SERVICES",
  "budgetCategory": "LOW",
  "objective": "CONVERSIONS",
  "placements": ["COMMENTS_PAGE", "FEED"],
  "creativeType": "TEXT",
  "headline": "Life can be expensive... Life insurance doesn't need to be.",
  "body": "Compare quotes from top Canadian insurers in minutes.",
  "callToAction": "Learn More",
  "destinationUrl": "https://www.coveredforlife.ca/get-a-quote/",
  "displayUrl": "coveredforlife.ca",
  "mediaUrl": null,
  "thumbnailUrl": "https://b.thumbs.redditmedia.com/…jpg",
  "postUrl": "https://www.reddit.com/user/coveredforlife/comments/1eg2hwu/…",
  "createdAt": "2024-07-28T14:11:03+00:00",
  "advertiserName": "u_coveredforlife",
  "advertiserId": "t2_abc123",
  "creativeId": "t3_1eg2hwu"
}

Key output fields

Field	Description
industry	Advertiser vertical (see enum).
budgetCategory	Relative campaign budget tier: LOW / MEDIUM / HIGH.
objective	Campaign objective (CONVERSIONS, CLICKS, …).
placements	Where the ad ran (FEED, COMMENTS_PAGE).
headline	The ad's headline (always present).
body	Longer post text. Populated on TEXT ads; empty on IMAGE / VIDEO ads, where the headline carries the copy.
callToAction	Button label (Learn More, Sign Up, …).
destinationUrl / displayUrl	The landing page.
mediaUrl / thumbnailUrl	Ad image/video and preview.
postUrl	The promoted post on Reddit.
advertiserName / advertiserId	Who ran it.

Pricing

Pay‑per‑result: $5.00 per 1,000 ads ($0.005 each). No monthly rental, no start fee — you pay only for the ads you keep.

What makes this richer than the competition

Capability	Other Reddit‑ad actors	This actor
Auth required from you	Paste a token / API key	None — built‑in, self‑refreshing
Source	Feed‑scraping (ephemeral) or a resold 3rd‑party API	Reddit's official Inspiration Library, direct
Search by keyword	Sometimes	✅
Industry / budget / objective / placement	Rarely	✅ all four
Campaign metadata + creative + CTA + landing page	Partial	✅ 17 fields

Notes & limitations

• The library surfaces ads Reddit has featured as inspiration (recent, better‑performing promoted posts) — it is not a 100% exhaustive archive of every Reddit ad ever run.
• body is empty for image and video ads; that is how Reddit stores them (the headline holds the copy). callToAction is likewise absent on a minority of ads.
• Industry/budget/objective/placement filters are applied to the returned results; combine with a query to narrow server‑side first.
• Reddit may change its ads API; if a run fails, it's usually a transient upstream change — retry or open an issue.

FAQ

Do I need a Reddit account or Ads account? No. Auth is built in and refreshes itself.

Can I use my own Reddit Ads session? Yes — paste it into redditSessionCookies (it auto‑refreshes the token). Optional.

Is this the Meta‑style public ad library? Reddit has no public Meta‑style library. This is Reddit's Ad Inspiration Library from inside Ads Manager — the closest and richest source of real Reddit ads.

How fresh are the ads? The library is maintained by Reddit and reflects recently active/featured promoted posts.

🤖 For AI Agents & LLM Apps

• Purpose: competitor ad intelligence — search Reddit's Ad Inspiration Library and return structured ads (creative + CTA + landing page + industry/budget/objective/placement).
• Minimal input: { "query": "crypto", "maxItems": 50 } (no auth needed).
• Output fields (flat): id, industry, budgetCategory, objective, placements[], creativeType, headline, body, callToAction, destinationUrl, displayUrl, mediaUrl, thumbnailUrl, postUrl, createdAt, advertiserName, advertiserId, creativeId.
• Billing: pay‑per‑result, $5 / 1,000 ads. maxItems bounds cost.
• Behavior: one dataset item per ad; query searches server‑side; array filters (industries/budgetCategories/objectives/placements) narrow results; cursor‑paginated to maxItems.

⚠️ Disclaimer

This actor collects only data that Reddit makes available to advertisers in its Ad Inspiration Library. Use it in compliance with Reddit's Terms of Service and all applicable laws (including data‑protection and advertising regulations). You are responsible for how you use the scraped data. This tool is provided for market research and competitive analysis; it is not affiliated with or endorsed by Reddit, Inc.

SEO Keywords

Reddit ad library, Reddit ads scraper, Reddit ad inspiration, Reddit ad spy, competitor ads Reddit, Reddit promoted posts, Reddit advertising research, ad intelligence Reddit, scrape Reddit ads, Reddit ads api, Reddit marketing intelligence, Reddit creative library, Reddit ad examples, ad copy research, competitor ad analysis.