Logo SearchApi

Reddit Ad Library API

GET   /api/v1/search?engine=reddit_ad_library

The Reddit Ad Library API provides access to Reddit's advertising transparency database. It returns ad details including creative content, headlines, media URLs, budget categories, industry classifications, and advertiser profile information.

API Parameters

Search Query

  • Name
    q
    Required
    Optional
    Description

    Parameter defines the query you want to search. If not provided, all ads will be retrieved based on the applied filters.

Filter Parameters

  • Name
    industry
    Required
    Optional
    Description

    Filters ads by industry category. Multiple values can be provided separated by commas.

    Allowed values: EDUCATION, TECH_B2C, TECH_B2B, RETAIL_AND_ECOMMERCE, ENTERTAINMENT, GAMING, FINANCIAL_SERVICES, HEALTH_AND_BEAUTY, CONSUMER_PACKAGED_GOODS, EMPLOYMENT, AUTO, TRAVEL, REAL_ESTATE, GAMBLING_AND_FANTASY_SPORTS, POLITICS_AND_GOVERNMENT, OTHER

  • Name
    budget_category
    Required
    Optional
    Description

    Filters ads by budget category. Multiple values can be provided separated by commas.

    Allowed values: LOW, MEDIUM, HIGH

  • Name
    post_type
    Required
    Optional
    Description

    Filters ads by post type. Multiple values can be provided separated by commas.

    Allowed values: VIDEO, IMAGE, CAROUSEL, FREE_FORM

  • Name
    placements
    Required
    Optional
    Description

    Filters ads by placement location. Multiple values can be provided separated by commas.

    Allowed values: COMMENTS_PAGE, FEED

  • Name
    objective_type
    Required
    Optional
    Description

    Filters ads by objective type. Multiple values can be provided separated by commas.

    Allowed values: CLICKS, IMPRESSIONS, CONVERSIONS, VIDEO_VIEWABLE_IMPRESSIONS, APP_INSTALLS

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to reddit_ad_library.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=reddit_ad_library&industry=GAMING&placements=FEED&post_type=VIDEO&q=cs2
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "reddit_ad_library",
  "q": "cs2",
  "industry": "GAMING",
  "post_type": "VIDEO",
  "placements": "FEED"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_AxENYzjKgR4Pckda3D0M4GJb",
    "status": "Success",
    "created_at": "2025-07-16T14:05:36Z",
    "request_time_taken": 2.97,
    "parsing_time_taken": 0.01,
    "total_time_taken": 2.97,
    "request_url": "https://ads.reddit.com/inspiration",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_AxENYzjKgR4Pckda3D0M4GJb.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_AxENYzjKgR4Pckda3D0M4GJb"
  },
  "search_parameters": {
    "engine": "reddit_ad_library",
    "q": "cs2",
    "industry": "GAMING",
    "post_type": "VIDEO",
    "placements": "FEED"
  },
  "ads": [
    {
      "id": "9803251f21bc588e179531d379610ed5",
      "budget_category": "MEDIUM",
      "industry": "GAMING",
      "placements": [
        "FEED"
      ],
      "objective": "IMPRESSIONS",
      "creative": {
        "id": "t3_1dcpn2r",
        "type": "VIDEO",
        "content": [
          {
            "destination_url": "https://www.playsafeid.com/cs2-launch-event",
            "display_url": "playsafeid.com",
            "call_to_action": "Learn More",
            "media_url": "https://v.redd.it/8y8k57ufsr5d1/DASH_1080.mp4?source=fallback"
          }
        ],
        "headline": "Play CS2 without any cheaters. To celebrate the launch of our CS2 community servers this weekend, we're running a tournament with $880 up for grabs.",
        "body": "",
        "thumbnail_url": "https://external-preview.redd.it/QsAhv7kY4dXZkPAPT8DtOo_1WWvJHrMqIiGORR0FmKg.png?width=1080&crop=smart&format=pjpg&auto=webp&s=1f5eaef90cdfcf87c01a90d13b239e7e5f0a849c",
        "allow_comments": true,
        "created_at": "2024-06-10T16:24:35+00:00",
        "profile_id": "t2_pqbqfyuy9",
        "post_url": "https://www.reddit.com/r/u_PlaySafeID/comments/1dcpn2r/play_cs2_without_any_cheaters_to_celebrate_the/"
      },
      "profile_info": {
        "name": "u_PlaySafeID",
        "snoovatar_icon_url": "https://i.redd.it/snoovatar/avatars/5661fac6-0ba7-4cd6-874e-5a0d14dd12e1-headshot.png"
      }
    },
    ...
  ]
}