Reddit 搜索广告

在 Reddit 广告库中搜索与查询匹配的广告，最多返回 30 个结果。

1 credits / 次请求

GET /v1/reddit/ads/search 试用

Reddit 搜索广告
GET /v1/reddit/ads/search

在 Reddit 广告库中搜索与查询匹配的广告，最多返回 30 个结果。

鉴权：x-api-key
示例 URL: https://api.datawake.ai/v1/reddit/ads/search?query=Scraping

参数：
- query (query · string · 必填) = Scraping
- industries (query · string · 可选)
- budgets (query · string · 可选)
- formats (query · string · 可选)
- placements (query · string · 可选)
- objectives (query · string · 可选)

概览

WakeScrap exposes this Reddit endpoint as a live-data API. The platform keeps the documented request and response shape stable while unifying auth, request tracking, and credits billing.

在 Reddit 广告库中搜索与查询匹配的广告，最多返回 30 个结果。每个广告都包含 id、budget_category、行业、展示位置、目标以及包含标题、正文、thumbnail_url、类型、created_at 和 post_url 的创意对象。还包括带有广告商名称的 profile_info。支持按行业、预算、格式、展示位置和目标进行过滤。

必填参数：query。

请求头

x-api-key string 必填

你的 Wake API 访问密钥。

示例：

YOUR_API_KEY

查询参数

query string 必填

搜索查询

示例：

Scraping

industries string

筛选行业

枚举： 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 string

筛选依据的预算

枚举： LOW, MEDIUM, HIGH

formats string

过滤依据的格式

枚举： IMAGE, VIDEO, CAROUSEL, FREE_FORM

placements string

筛选依据的展示位置

枚举： FEED, COMMENTS_PAGE

objectives string

筛选目标

枚举： IMPRESSIONS, CLICKS, CONVERSIONS, VIDEO_VIEWABLE_IMPRESSIONS, APP_INSTALLS


              curl 'https://api.datawake.ai/v1/reddit/ads/search?query=Scraping' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Accept: application/json'


              const response = await fetch("https://api.datawake.ai/v1/reddit/ads/search?query=Scraping", {
  method: "GET",
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'Accept': 'application/json',
  },
});

const data = await response.json();
console.log(data);


              import requests

response = requests.request(
    "GET",
    "https://api.datawake.ai/v1/reddit/ads/search?query=Scraping",
    headers={
        "x-api-key": "YOUR_API_KEY",
        "Accept": "application/json",
    },
)

print(response.json())


              $ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api.datawake.ai/v1/reddit/ads/search?query=Scraping",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        'x-api-key: YOUR_API_KEY',
        'Accept: application/json',
    ],
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;


              client := &http.Client{}
req, err := http.NewRequest("GET", "https://api.datawake.ai/v1/reddit/ads/search?query=Scraping", nil)
if err != nil {
    panic(err)
}

req.Header.Set("x-api-key", "YOUR_API_KEY")
req.Header.Set("Accept", "application/json")

resp, err := client.Do(req)
if err != nil {
    panic(err)
}
defer resp.Body.Close()

body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))


              HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.datawake.ai/v1/reddit/ads/search?query=Scraping"))
    .header("x-api-key", "YOUR_API_KEY")
    .header("Accept", "application/json")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());

System.out.println(response.body());


              {
  "success": true,
  "ads": [
    {
      "id": "79e005f1e09ec72245e904d87d2a0869",
      "budget_category": "HIGH",
      "industry": "OTHER",
      "placements": [
        "FEED"
      ],
      "objective": "CONVERSIONS",
      "creative": {
        "id": "t3_1cdt7o6",
        "type": "TEXT",
        "content": [
          "..."
        ],
        "headline": "What is a rich person’s money tip you wish you knew sooner?",
        "body": "Life would be a whole lot easier if someone would just Venmo us $1 million, but unfortunately the chance of that happening is, well, probably zero. (Venmo doesn’t allow transaction...",
        "thumbnail_url": "https://b.thumbs.redditmedia.com/9gzdjvf9fDu1vN2zxxVrvGqOJizhLf80W701zzkml2k.jpg",
        "allow_comments": false,
        "created_at": "2024-04-26T18:47:57+00:00",
        "profile_id": "t2_3usby",
        "post_url": "https://www.reddit.com/r/u_thepennyhoarder/comments/1cdt7o6/what_is_a_rich_persons_money_tip_you_wish_you/"
      },
      "profile_info": {
        "name": "u_thepennyhoarder",
        "snoovatar_icon_url": "https://www.redditstatic.com/avatars/defaults/v2/avatar_default_6.png"
      }
    }
  ]
}


              {
  "error": {
    "code": "invalid_request",
    "message": "One or more required parameters are missing or invalid."
  }
}


              {
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing x-api-key header."
  }
}


              {
  "error": {
    "code": "insufficient_credits",
    "message": "This request requires available credits before execution."
  }
}