FeedMCP

Data APIs / Google Ads Transparency

Google advertiser search API

Find advertisers in the Google Ads Transparency Center by name: advertiser ID, name, country and roughly how many ads, up to 10.

Item Value
Endpoint GET https://api.feedmcp.com/v1/google/advertisers/search
ID google.advertisers.search
Price $0.002 / call
Returns A page of Account objects
Auth Authorization: Bearer $FEEDMCP_API_KEY

Parameters

Name Type Required Description
keyword string yes Advertiser name
country string no Country to search in, two-letter code, default US; default US

Every endpoint also takes view=full to include the platform's raw data as raw, at the same price.

Returned fields

data.items is a list of Account objects, with the same fields on every platform:

Field Type Description
id string Account ID, the same id the platform's account endpoints take: the username on TikTok, Instagram, X and Threads, the channel name on Telegram, the subreddit name on Reddit, the part after /in/ or /company/ on LinkedIn, the page name or number on Facebook, the UC… channel ID on YouTube, sec_user_id on Douyin, the numeric user ID on Kuaishou, v2_…@finder on WeChat Channels, the profile token on Zhihu, the user ID on Xiaohongshu, the UID on Bilibili and Weibo, the gh_… ID on WeChat
platform string Platform
name string | null Display name
handle string | null Handle: username, Douyin ID, RED ID or WeChat ID
uid string | null Numeric Douyin uid (Douyin only; the Ocean Engine creator endpoints take it)
bio string | null Bio
avatar string | null Avatar URL
url string | null Profile link
verified boolean | null Verified
verified_reason string | null Verification label or owner
metrics.followers number | null Followers
metrics.following number | null Following
metrics.posts number | null Posts
metrics.likes number | null Likes received
metrics.views number | null Total views (YouTube channels only)
metrics.employees number | null Employees (LinkedIn companies only)
metrics.weekly_active_users number | null Weekly active users (subreddits only)
metrics.articles number | null Articles (Zhihu account search only)
private boolean | null Private account (Instagram account search only)
owner object | null The registered owner: name, country, registered_at, verified_at and third_party_services (account owner endpoint only)
metrics.ads number | null Roughly how many ads (Google advertisers only)
metrics.instagram_followers number | null Followers of the linked Instagram (Meta advertisers only)
location string | null Location (LinkedIn and Facebook)
category string | null Category: Facebook page category, LinkedIn industry, or WeChat account type (Official Account, service account, Channels or mini program)
website string | null Website (LinkedIn companies and Facebook pages)
experience object[] LinkedIn: organizations shown publicly, with organization, location, start and end
education object[] LinkedIn: schools and organizations shown publicly, with school, start and end

When you are charged

$0.002 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Each answer carries meta.billing: what this call cost and the balance left.

Request

cURL

curl "https://api.feedmcp.com/v1/google/advertisers/search?keyword=REI" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/google/advertisers/search",
    params={"keyword": "REI"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/google/advertisers/search?keyword=REI", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "google.advertisers.search",
  "params": {
    "keyword": "REI"
  },
  "max_price": "0.002"
}

Response

The data below is made up; the shape is the real one.

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "id": "AR08171864262113755137",
        "platform": "google",
        "name": "Trail Outfitters Inc",
        "handle": null,
        "bio": null,
        "avatar": null,
        "url": "https://adstransparency.google.com/advertiser/AR08171864262113755137",
        "verified": null,
        "location": "US",
        "metrics": {
          "ads": 3000
        }
      }
    ]
  },
  "page": {
    "next_cursor": null,
    "has_more": false
  },
  "warnings": [],
  "meta": {
    "endpoint": "google.advertisers.search",
    "platform": "google",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

Errors are described in Errors: each says whether you were charged (charged) and whether to retry (retry).

Other Google Ads Transparency endpoints

Questions

How much does the Google advertiser search endpoint cost?

$0.002 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Do I need a platform account?

No. Only public data is read.

An advertiser is the AR… ID (find it with the advertiser search) or its domain; an ad is its link or "AR…/CR…".

How do I get more items?

When the answer has page.next_cursor, pass it back as cursor for the next page. Each page is billed on its own.

How do I use it from an AI?

Install the MCP server and ask; your AI calls google.advertisers.search.