Reddit Promoted Posts Scraper

Apify actor to scrape promoted ad posts (sponsored content) from the Reddit feed. Uses Reddit's <shreddit-ad-post> custom HTML elements to extract rich ad data including advertiser info, campaign IDs, country codes, and media URLs.

Note: Reddit does not expose a public ad library like Google or Meta. This actor scrapes promoted posts directly from the live Reddit feed (homepage and subreddits). Results depend on which ads Reddit shows to the browser session at scrape time.

Features

• Extracts promoted posts from the Reddit feed using <shreddit-ad-post> elements
• Captures advertiser name, ad title, body text, subreddit, and CTA
• Collects media URLs (images/videos), outbound link URLs, and destination domain
• Returns campaign IDs, post IDs, and country codes from ad attributes
• Optional keyword filter to match ads by advertiser or ad text
• Automatic scrolling to load more promoted posts
• Proxy support for reliable scraping

Input

Field	Type	Default	Description
query	string	""	Optional keyword to filter ads (matches advertiser name or ad text). Leave empty for all promoted posts.
maxItems	integer	50	Maximum number of promoted posts to scrape (1–500)
proxyConfiguration	object	Apify Proxy	Proxy settings for the crawler

Example Input

{
    "query": "technology",
    "maxItems": 10
}

Output

Each scraped promoted post contains:

Field	Type	Description
position	integer	Result position index
advertiserName	string	Reddit username of the advertiser
advertiserProfileUrl	string	URL to the advertiser's Reddit profile
adTitle	string	Headline / title of the promoted post
adText	string	Body copy of the ad
destinationDomain	string	Domain of the ad landing page
outboundLinkUrl	string	Full click-through URL (may be a tracking URL)
ctaText	string	Call-to-action button text (e.g. "Learn More")
adType	string	Ad type attribute (e.g. "display")
mediaUrl	string	URL of the ad image or video creative
subreddit	string	Subreddit where the ad was shown
createdAt	string	Timestamp from the ad element
permalink	string	Reddit permalink to the promoted post
postId	string	Reddit post ID (e.g. "t3_abc123")
campaignId	string	Advertiser campaign ID
countryCode	string	Country code from the ad attributes
scrapedAt	string	ISO timestamp of when the data was scraped

Example Output

{
    "position": 1,
    "advertiserName": "example-brand",
    "advertiserProfileUrl": "https://www.reddit.com/user/example-brand/",
    "adTitle": "Your creation. Your timestamp. Your proof.",
    "adText": "Secure your creative work with blockchain timestamps.",
    "destinationDomain": "example.com",
    "outboundLinkUrl": "https://alb.reddit.com/cr?creative_id=...",
    "ctaText": "Learn More",
    "adType": "display",
    "mediaUrl": "https://preview.redd.it/example-ad-image.png",
    "subreddit": "technology",
    "createdAt": "2025-01-15T10:00:00.000Z",
    "permalink": "https://www.reddit.com/r/technology/comments/abc123/",
    "postId": "t3_abc123",
    "campaignId": "2491339872271957999",
    "countryCode": "US",
    "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Usage

Apify Console

1. Go to the actor's page on Apify Console
2. Set the input parameters
3. Click "Start"

API

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('your-username/reddit-ad-library-scraper').call({
    query: 'technology',
    maxItems: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Local Development

npm install
npm start

Project Structure

src/
├── main.js              # Actor entry point — reads input, configures crawler
├── constants.js         # Shared constants (URLs, selectors, limits)
├── routes.js            # Crawler route handlers (SEARCH)
└── utils/
    ├── extraction.js    # Ad data extraction from page DOM
    └── scrolling.js     # Infinite scroll / load-more helpers