Skip to content
looot docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

Scrape Creators API / Company Ads

ScrapeCreators tool scrapecreators-google-company-ads on looot: input fields, $0.00188 per call, output shape, and code to run it with curl, JavaScript or Python.

Fetches public ads for a company from the Google Ad Transparency Library by domain or advertiser_id. Each ad includes advertiserId, creativeId, format, adUrl, advertiserName, domain, firstShown, and lastShown. Costs 25 credits per request when get_ad_details=true; without it, only advertiserId and creativeId are returned at 1 credit. Send one of: domain, advertiser_id, topic.

  • Tool id: scrapecreators-google-company-ads
  • Provider: ScrapeCreators
  • Job: Ads google company (google.company.ads)
  • Price: $0.00188 per call. A call that fails at the provider costs $0.

Inputs

Name Type Required Description
advertiser_id string no The advertiser id of the company.
cursor string no Cursor to paginate through results.
domain string no The domain of the company. Example: “lululemon.com”
end_date string no End date to search for. Format: YYYY-MM-DD. Example: “2025-08-11”
format string no Ad format to search for. Example: “video”
get_ad_details string no Set to true to get the ad details. Will cost 25 credits. Example: “false”
platform string no Platform to search for. Example: “youtube”
region string no The region to search for. Defaults to anywhere. Example: “US”
start_date string no Start date to search for. Format: YYYY-MM-DD. Example: “2025-08-01”
topic string no The topic to search for. If you search for ‘political’, you will also need to pass a ‘region’, like ‘US’ or ‘AU’. Example: “all”

Output

Shape of the run’s result, checked against 1 real answer:

{ ads: { adUrl, domain, format, imageUrl, lastShown, creativeId, firstShown, advertiserId, advertiserName }[], cursor, success, credits_charged, credits_remaining, number_of_ads_estimate }

Run it

Every call needs your API token in LOOOT_TOKEN; Sign in shows how to get one. Each run also needs a new idempotency key, so a retry never pays twice. With wait: 30 the answer comes back inline when the run ends within 30 seconds. Otherwise you get the running run back: poll GET /v1/runs/<runId>.

Example input with placeholder values:

curl -X POST "https://api.looot.ai/v1/runs" \
  -H "Authorization: Bearer $LOOOT_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"endpointId":"scrapecreators-google-company-ads","input":{"topic":"all","cursor":"<cursor>","domain":"lululemon.com","format":"video","region":"US","end_date":"2025-08-11","platform":"youtube","start_date":"2025-08-01","advertiser_id":"<advertiser_id>","get_ad_details":"false"},"wait":30}'
const response = await fetch("https://api.looot.ai/v1/runs", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.LOOOT_TOKEN}`,
    "Content-Type": "application/json",
    "Idempotency-Key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    endpointId: "scrapecreators-google-company-ads",
    input: {
      topic: "all",
      cursor: "<cursor>",
      domain: "lululemon.com",
      format: "video",
      region: "US",
      end_date: "2025-08-11",
      platform: "youtube",
      start_date: "2025-08-01",
      advertiser_id: "<advertiser_id>",
      get_ad_details: "false",
    },
    wait: 30,
  }),
});
const run = await response.json();
console.log(run.status, run.result);
import os
import uuid

import requests

response = requests.post(
    "https://api.looot.ai/v1/runs",
    headers={
        "Authorization": f"Bearer {os.environ['LOOOT_TOKEN']}",
        "Idempotency-Key": str(uuid.uuid4()),
    },
    json={
        "endpointId": "scrapecreators-google-company-ads",
        "input": {
            "topic": "all",
            "cursor": "<cursor>",
            "domain": "lululemon.com",
            "format": "video",
            "region": "US",
            "end_date": "2025-08-11",
            "platform": "youtube",
            "start_date": "2025-08-01",
            "advertiser_id": "<advertiser_id>",
            "get_ad_details": "false",
        },
        "wait": 30,
    },
    timeout=90,
)
run = response.json()
print(run["status"], run.get("result"))

To let looot pick among every provider of this job instead, send job:google.company.ads as endpointId; see the job page.

Was this page helpful?