🟠 Reddit Ads Scraper

Turn the public Reddit Ads library into clean, structured, export-ready data. This Actor collects real ads running on Reddit — headlines, body copy, creative media, advertisers, budgets, objectives, placements and more — and streams every result straight into your output table in real time.

Perfect for competitor research, ad inspiration, creative swipe files, market analysis, and agency reporting. No Reddit account, no API keys, no setup.

---

📑 Table of Contents

• Why choose this Actor?
• Key features
• Input
• Output
• How to use (Apify Console)
• Use via API
• Smart proxy handling
• Best use cases
• Pricing
• Frequently asked questions
• Support & feedback

---

💎 Why choose this Actor?

⚡ Zero setup	Type a keyword, press Start. That's it.
📊 Real-time results	Every ad lands in the output table the instant it's collected — no waiting for the run to finish.
🛡️ Self-healing network	Starts direct, auto-upgrades to datacenter → residential proxies if Reddit throttles. You never touch a setting.
🎯 Powerful filters	Slice by industry, budget tier, ad format, placement and campaign objective.
🧱 Robust by design	Retries with exponential backoff, graceful degradation, partial results always saved.
🗂️ Organised output	Three ready-made table views: Ad Overview, Creative & Content, Advertiser Profile.

---

✨ Key features

• 🔎 Bulk keyword search — queue many keywords in a single run.
• 🏭 Industry filter — 16 industries, from Tech to Real Estate to Gaming.
• 💵 Budget filter — Low / Medium / High spend tiers.
• 🎨 Format filter — Image, Video, Carousel, Free-form / Text.
• 📍 Placement filter — Feed or Conversation.
• 🎯 Objective filter — Awareness, Conversions, App Installs, Traffic, Video Views.
• 🖼️ Full creative capture — media URLs, destination URLs, display URLs, call-to-action buttons.
• 👤 Advertiser details — profile name, profile ID, avatar.
• 📥 Live dataset writes — a crash mid-run never loses collected data.

---

📥 Input

Field	Type	Required	Description
queries	array of strings	No	Keywords to search. Add several for bulk runs. Leave empty to pull the whole public gallery.
industry	string (enum)	No	Keep only ads from one industry.
budgetCategory	string (enum)	No	Keep only LOW / MEDIUM / HIGH budget ads.
postType	string (enum)	No	Keep only IMAGE / VIDEO / CAROUSEL / FREE_FORM ads.
placements	string (enum)	No	Keep only FEED or CONVERSATION ads.
objectiveType	string (enum)	No	Keep only ads with a given campaign objective.
maxItems	integer	No	Max ads per keyword (1–30, default 30).
proxyConfiguration	object	No	Optional proxy. Defaults to no proxy — the Actor self-escalates if needed.

Example input

{
  "queries": ["ai", "crypto"],
  "industry": "TECH_B2C",
  "budgetCategory": "HIGH",
  "postType": "VIDEO",
  "maxItems": 30,
  "proxyConfiguration": { "useApifyProxy": false }
}

---

📤 Output

Each ad is one dataset row. Example:

{
  "id": "5f6eb24cc504b6d04b6e121a701c03b4",
  "budget_category": "MEDIUM",
  "industry": "TECH_B2C",
  "placements": ["FEED", "COMMENTS_PAGE"],
  "objective": "CONVERSIONS",
  "created_at": "2024-02-27T19:25:25+00:00",
  "headline": "As Seen on Shark Tank",
  "body": "",
  "post_url": "https://www.reddit.com/user/RIPDebt/comments/1b1ki15/as_seen_on_shark_tank/",
  "type": "IMAGE",
  "thumbnail_url": "https://a.thumbs.redditmedia.com/MpMEvF...jpg",
  "profile_id": "t2_td6ozens",
  "profile_name": "u_RIPDebt",
  "profile_image_url": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_0.png",
  "content": [
    {
      "media_url": "https://external-preview.redd.it/vaHsih...jpg",
      "destination_url": "https://changed.test-app.link/pkHAhbWqxHb",
      "display_url": "changed.test-app.link",
      "call_to_action": "Learn More"
    }
  ]
}

Field	Description
id	Stable unique ad identifier.
budget_category	Spend tier — LOW / MEDIUM / HIGH.
industry	Advertiser's industry.
placements	Where the ad runs — FEED, COMMENTS_PAGE, …
objective	Campaign objective — CONVERSIONS, CLICKS, IMPRESSIONS, …
created_at	ISO timestamp the ad post was created.
headline	Ad headline / title.
body	Ad body text (may be empty for image/video ads).
post_url	Link to the underlying Reddit post.
type	Creative format — IMAGE / VIDEO / CAROUSEL / TEXT.
thumbnail_url	Thumbnail image of the creative.
profile_id	Advertiser's Reddit profile ID.
profile_name	Advertiser's Reddit username.
profile_image_url	Advertiser's avatar.
content	List of creative slides — media_url, destination_url, display_url, call_to_action.

🗂️ Output table views

The Output tab ships with three pre-built sections so you can scan results by topic:

• 🗂️ Ad Overview — id, headline, format, industry, budget, objective, placements, date, post link.
• 🎨 Creative & Content — headline, body copy, thumbnail and full creative content.
• 👤 Advertiser Profile — advertiser name, profile ID, avatar and post link.

Export any view to JSON, CSV, Excel, HTML or XML with one click.

---

🚀 How to use (Apify Console)

1. Log in at console.apify.com → Actors.
2. Open Reddit Ads Scraper.
3. Add one or more search keywords (or leave empty for the whole gallery).
4. (Optional) Pick filters — industry, budget, format, placement, objective.
5. Click Start ▶️.
6. Watch ads appear in the Output tab in real time.
7. When the run finishes, export to JSON / CSV / Excel.

---

🤖 Use via API

Run the Actor and get results in one call:

curl -X POST "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "queries": ["ai"],
       "maxItems": 30,
       "proxyConfiguration": { "useApifyProxy": false }
     }'

Or start asynchronously and poll for the result:

curl -X POST "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs?token=YOUR_APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"queries":["crypto"],"maxItems":30}'

---

🛡️ Smart proxy handling

You do not need to configure anything — the Actor manages connectivity for you:

1. 🌐 Direct connection first (no proxy, fastest, no proxy cost).
2. 🏢 Datacenter proxy if Reddit throttles the direct connection.
3. 🏠 Residential proxy if the datacenter connection is still throttled — then locked in for the rest of the run, with up to 3 retries.

Every connection upgrade is logged clearly so you always know what's happening. Advanced users can still pre-select a proxy in the proxyConfiguration field.

---

🎯 Best use cases

• 🕵️ Competitor ad intelligence — see what rivals are promoting on Reddit.
• 💡 Creative inspiration — build a swipe file of high-performing headlines and hooks.
• 📈 Market research — spot trends by industry, budget and objective.
• 🧾 Agency reporting — export structured ad data for client decks.
• 🤖 AI / LLM pipelines — feed real ad copy into models for analysis or generation.

---

💲 Pricing

This Actor uses the Pay-Per-Event (PPE) model:

Event	What it covers
🟢 Actor start	A small fixed fee each time a run starts.
📦 Result item	A fee per ad written to your dataset.

You only pay for the ads you actually collect. There are no monthly rental fees. The exact per-event prices are shown on the Actor's Store page before you run it.

---

❓ Frequently asked questions

How many ads can I get? Reddit's public ad gallery exposes roughly 30 ads to anonymous visitors. A keyword returns the subset that matches, and the Actor tops up from the gallery so you always receive as many ads as Reddit currently exposes.

Do I need a Reddit account or API key? No. The Actor only uses data that is already public in Reddit's ad inspiration gallery.

Why did I get fewer ads than maxItems? That is a Reddit limit, not a scraper error — the public gallery simply does not expose more than ~30 ads at a time.

Do I have to set up a proxy? No. The Actor runs without a proxy by default and automatically upgrades the connection only if Reddit throttles it.

Is bulk input supported? Yes — add multiple keywords in the queries field to run several searches in one go. Results are de-duplicated across keywords.

What if a search fails? The Actor retries with backoff and escalating proxies. If one keyword still fails, the run continues with the others and keeps every ad already collected.

---

📨 Support & feedback

Found a bug, need an extra field, or want a custom workflow? We're happy to help.

📧 scrapier.io@gmail.com

⚖️ Legal note: This Actor collects only publicly available data from Reddit's ad inspiration library. You are responsible for using the data in line with Reddit's Terms of Service and applicable laws (GDPR, CCPA, etc.).