How to scrape Google Company Ads with TypeScript

Company Ads This tutorial gets it with a short TypeScript program and the Google Company Ads API. Each successful call costs up to 25 credits; errors and not-found answers are free.

1. Get an API key

Sign in to get a key and 100 free credits, no card. Then put the key in an environment variable so it stays out of your code:

export SCRAPEIO_API_KEY="your_key_here"

2. Set up TypeScript

npm install -D tsx typescript

3. Write the code

Save this as scrape.ts.

const url = new URL("https://scrapeio.com/v1/google/company/ads");
const headers = { "x-api-key": process.env.SCRAPEIO_API_KEY! };

const items: unknown[] = [];
while (true) {
  const res = await fetch(url, { headers });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const { data } = (await res.json()) as { data: { items?: unknown[]; cursor?: string; has_more?: boolean } };
  items.push(...(data.items ?? []));
  if (!data.has_more || !data.cursor || items.length >= 100) break;
  url.searchParams.set("cursor", data.cursor);
}
console.log(items.length, "items");
console.log(items.slice(0, 3));

The loop follows data.cursor until data.has_more is false, and stops at 100 items. Each page is one call, so it costs up to 25 credits.

4. Run it

npx tsx scrape.ts

The response has the same envelope on every endpoint: success, cached, credits_used, credits_remaining and data. Shared fields such as handle, followers, plays, likes and created_at have the same names on every platform.

Parameters

Errors and what you pay

Same endpoint in other languages

Python · Node.js · JavaScript · Go · Rust · Java · C# · PHP · Ruby · Kotlin · Swift · R

Prefer no code?

Connect the MCP server to Claude Code, Cursor or Codex and ask in plain English. The agent uses call_endpoint with path /v1/google/company/ads for you.

More Google Ad Library tutorials in TypeScript

• How to scrape Google Ad with TypeScript
• How to scrape Google Ad Library Advertisers Search with TypeScript