Skip to main content
GET
/
v1
/
scrape
/
reddit
/
ads
/
search
Search Ads
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/reddit/ads/search \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "ads": {
      "0": {
        "id": "6600932687f554d69cc77831d4894049",
        "budget_category": "MEDIUM",
        "industry": "TECH_B2B",
        "placements": {
          "0": "FEED",
          "1": "COMMENTS_PAGE"
        },
        "objective": "CLICKS",
        "creative": {
          "id": "t3_1aqi3ie",
          "type": "IMAGE",
          "content": {
            "0": {
              "destination_url": "https://www.extractsummit.io/join-the-community/?utm_campaign=Comt&utm_activity=PDS&utm_medium=PAI&utm_source=reddit&utm_primary=ZAPI&utm_goal=SIN",
              "display_url": "extractsummit.io",
              "call_to_action": "Sign Up",
              "media_url": "https://external-preview.redd.it/UGxuDaT_edj7uLfpNfReoS3GlbQLZLLfAJwQfiixdQs.jpg?auto=webp&s=fe6a9a89e9dd83e8f25663a39fc69836c5e8978b"
            }
          },
          "headline": "Don't waste time stuck on web scraping roadblocks - Join the Extract Data Discord community and level up your scraping skills!",
          "body": "",
          "thumbnail_url": "https://b.thumbs.redditmedia.com/D7QwPabAfO0uGPK3NSRPewAB1uCg34A_wejb6xnJTfE.jpg",
          "allow_comments": false,
          "created_at": "2024-02-14T08:25:29+00:00",
          "profile_id": "t2_dosg2rs4",
          "post_url": "https://www.reddit.com/r/u_team_zyte/comments/1aqi3ie/dont_waste_time_stuck_on_web_scraping_roadblocks/"
        },
        "profile_info": {
          "name": "u_team_zyte",
          "snoovatar_icon_url": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_4.png"
        }
      }
    }
  },
  "creditsUsed": 1
}
💳 1 credit per request

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
query
string
required

Search query

Example:

"Trump"

​
industries
enum<string>

Industries to filter by

Available options:
RETAIL_AND_ECOMMERCE,
TECH_B2B,
TECH_B2C,
EDUCATION,
ENTERTAINMENT,
GAMING,
FINANCIAL_SERVICES,
HEALTH_AND_BEAUTY,
CONSUMER_PACKAGED_GOODS,
EMPLOYMENT,
AUTO,
TRAVEL,
REAL_ESTATE,
GAMBLING_AND_FANTASY_SPORTS,
POLITICS_AND_GOVERNMENT,
OTHER
​
budgets
enum<string>

Budgets to filter by

Available options:
LOW,
MEDIUM,
HIGH
​
formats
enum<string>

Formats to filter by

Available options:
IMAGE,
VIDEO,
CAROUSEL,
FREE_FORM
​
placements
enum<string>

Placements to filter by

Available options:
FEED,
COMMENTS_PAGE
​
objectives
enum<string>

Objectives to filter by

Available options:
IMPRESSIONS,
CLICKS,
CONVERSIONS,
VIDEO_VIEWABLE_IMPRESSIONS,
APP_INSTALLS

Response

Successful response

Key Response Fields:

  • data.ads[n].id: Unique ad identifier
  • data.ads[n].budget_category: Estimated budget tier (LOW, MEDIUM, HIGH)
  • data.ads[n].industry: The advertiser's industry category
  • data.ads[n].placements: Array of ad placements (e.g. FEED, COMMENTS_PAGE)
  • data.ads[n].objective: Campaign objective (e.g. CLICKS, IMPRESSIONS)
  • data.ads[n].creative.type: Creative format (IMAGE, VIDEO, CAROUSEL)
  • data.ads[n].creative.headline: Ad headline text
  • data.ads[n].creative.content[n].destination_url: Click-through destination URL
  • data.ads[n].creative.thumbnail_url: Thumbnail image URL for the ad
  • data.ads[n].profile_info.name: Advertiser account name