# SocialCrawl API — google endpoints
# Base URL: https://www.socialcrawl.dev
# Auth: x-api-key header
# Full docs: https://www.socialcrawl.dev/docs/google

## GET /v1/google/search
Google web search
Credit cost: 1 (standard)
Parameters:
- query (required) — Search keyword or phrase
- region (optional, string) — 2 letter country code, ie US, UK, CA, etc This will show results from that country
- date_posted (optional, enum: last-hour | last-day | last-week | last-month | last-year) — Date posted
- page (optional, integer) — Page number to retrieve
curl "https://www.socialcrawl.dev/v1/google/search?query=best restaurants in London" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/google/ad
Get Google ad details
Credit cost: 5 (advanced)
Parameters:
- url (required) — Full URL of the Google ad or Ads Transparency Center page
curl "https://www.socialcrawl.dev/v1/google/ad?url=https://adstransparency.google.com/advertiser/AR12345678901234567" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/google/adlibrary/advertisers/search
Search Google Ad Library advertisers
Credit cost: 5 (advanced)
Parameters:
- query (required) — Search keyword or phrase to find advertisers in the Google Ads Transparency Center
curl "https://www.socialcrawl.dev/v1/google/adlibrary/advertisers/search?query=Nike" \
  -H "x-api-key: sc_your_api_key_here"

## GET /v1/google/company/ads
List Google ads by company
Credit cost: 5 (advanced)
Parameters:
- domain (optional, string) — Company domain name to look up ads for
- advertiser_id (optional, string) — The advertiser id of the company
- topic (optional, enum: all | political) — The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU'
- region (optional, string) — The region to search for. Defaults to anywhere
- start_date (optional, string) — Start date to search for. Format: YYYY-MM-DD
- end_date (optional, string) — End date to search for. Format: YYYY-MM-DD
- get_ad_details (optional, string) — Set to true to get the ad details. Will cost 25 credits.
- cursor (optional, string) — Cursor to paginate through results
- Constraint: one of domain, advertiser_id (at least one required)
curl "https://www.socialcrawl.dev/v1/google/company/ads" \
  -H "x-api-key: sc_your_api_key_here"