# Google on Onekey

> 15 endpoints for Google (3 stable, 12 beta), 1 to 35 credits each. Category: AI & search. One key, one JSON shape.

Base URL: https://api.onekey.dev
Auth: header `x-api-key: <key>`. Call shape: `GET /v1/{platform}/{endpoint}?{params}`.
Every response is `{success, data, metadata, error}`; check `success` first. Cost is in `metadata.credits_charged`. Free when served from cache (0.2 credit for a cached response over 100 KB). Failed and not-found calls are refunded.
Status: stable = verified against the live source; beta = not yet verified, fields may be missing.
Access: 9 of 15 endpoints are marked "needs a pack" or "may need a pack": free-grant credits reach only the open fetch path; a verified email and a purchased pack unlock the rest.

Page: https://onekey.dev/platforms/google
Reference (Markdown): https://onekey.dev/docs/api/google.md
All docs: https://onekey.dev/llms.txt

## Canonical fields returned

Unified-schema fields (same names on every platform), with how many of the 15 mapped Google endpoints return each:

- `content.text` (string): 7
- `content.createdAt` (ISO 8601 date): 6
- `content.url` (URL): 6
- `author.displayName` (string): 5
- `content.id` (string): 5
- `content.title` (string): 5
- `entity.id` (string): 5
- `entity.name` (string): 5
- `entity.stats.rating` (number): 4
- `author.url` (URL): 3
- `entity.stats.ratingCount` (integer): 3
- `entity.url` (URL): 3
- `media.url` (URL): 3
- `author.id` (string): 2
- `content.type` (string): 2
- `content.updatedAt` (ISO 8601 date): 2
- `place.address` (string): 2
- `place.lat` (number): 2
- `place.lon` (number): 2
- `author.website` (URL): 1
- `engagement.comments` (integer): 1
- `engagement.views` (integer): 1
- `entity.category` (string): 1
- `entity.country` (string): 1
- `entity.description` (string): 1
- `listing.price` (number): 1
- `listing.seller` (string): 1
- `media.thumbnailUrl` (URL): 1
- plus 26 platform-specific fields under `ext.`

## Endpoints

### google.ad

One Google Ads Transparency creative: advertiser, format, impression and spend ranges, targeting, copy.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/google/ad?url=https%3A%2F%2Fadstransparency.google.com%2Fadvertiser%2FAR01614014350098432001%2Fcreative%2FCR07443539616616939521` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `url` (string, required): Ads Transparency Center creative URL (…/advertiser/AR…/creative/CR…)
- Fields returned: `content.id`, `author.id`, `content.type`, `content.updatedAt`, `content.title`, `content.text`, `media.url`, `ext.impressionsMin`, `ext.impressionsMax`, `ext.spendCurrency`, `ext.spendLower`, `ext.spendUpper`
- Reference: https://onekey.dev/docs/api/google/ad.md

### google.adlibrary_advertisers_search

Search advertisers in the Google Ads Transparency Center by name.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/adlibrary_advertisers_search?query=lululemon` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `query` (string, required): Advertiser name or keyword
- Fields returned: `entity.id`, `entity.name`, `entity.country`, `ext.adsEstimate`
- Reference: https://onekey.dev/docs/api/google/adlibrary_advertisers_search.md

### google.business_extended_reviews

Reviews of a Google Business Profile place (up to 5 most relevant per call).
- Price: 1 credit per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/business_extended_reviews?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `place_id` (string, optional): Google place id, e.g. ChIJN1t_tDeuEmsRUsoyG83frY4
  - `keyword` (string, optional): Business name and city to look up (first match), e.g. Blue Bottle Coffee Oakland
- Fields returned: `content.id`, `content.text`, `content.createdAt`, `author.displayName`, `author.url`, `ext.rating`
- Reference: https://onekey.dev/docs/api/google/business_extended_reviews.md

### google.business_info

Google Business Profile of a place: name, address, rating, review count, website.
- Price: 1 credit per fresh call. Status: beta. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/google/business_info?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `place_id` (string, optional): Google place id, e.g. ChIJN1t_tDeuEmsRUsoyG83frY4
  - `keyword` (string, optional): Business name and city to look up (first match), e.g. Blue Bottle Coffee Oakland
- Fields returned: `entity.id`, `entity.name`, `place.address`, `entity.stats.rating`, `entity.stats.ratingCount`, `entity.url`, `author.website`, `entity.category`, `ext.phone`
- Reference: https://onekey.dev/docs/api/google/business_info.md

### google.business_questions

Questions and answers on a Google Business Profile: question text, author, date, answers.
- Price: 23 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/business_questions?keyword=Blue%20Bottle%20Coffee%20Oakland` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `keyword` (string, required): Business name and city, or cid:<digits> / place_id:<id> to pin one place
  - `location_name` (string, optional, default United States): Location to search from, as an English place name (country, region or city)
  - `language_code` (string, optional, default en): Result language, ISO code (en, de, fr-CA ...)
- Fields returned: `content.id`, `content.text`, `content.createdAt`, `content.url`, `author.displayName`, `author.url`, `engagement.comments`, `ext.answers`
- Reference: https://onekey.dev/docs/api/google/business_questions.md

### google.business_updates

Recent posts (updates) published by a Google Business Profile: text, link, images, date.
- Price: 13 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/business_updates?keyword=Blue%20Bottle%20Coffee%20Oakland` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `keyword` (string, required): Business name and city, or cid:<digits> to pin one place
  - `location_name` (string, optional, default United States): Location to search from, as an English place name (country, region or city)
  - `language_code` (string, optional, default en): Result language, ISO code (en, de, fr-CA ...)
- Fields returned: `content.url`, `content.text`, `content.createdAt`, `author.displayName`, `ext.images`
- Reference: https://onekey.dev/docs/api/google/business_updates.md

### google.company_ads

Ads a company runs on Google, from the Ads Transparency Center (by domain).
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/company_ads?domain=lululemon.com` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `domain` (string, optional): Advertiser website domain, e.g. lululemon.com
  - `advertiser_id` (string, optional): Google Ads Transparency advertiser id, e.g. AR01614014350098432001 (alternative to domain)
  - `cursor` (string, optional): Opaque cursor from a previous response's `pagination.next_cursor`. Omit for the first page.
- Fields returned: `content.id`, `author.id`, `author.displayName`, `content.type`, `content.url`, `media.url`, `content.createdAt`, `content.updatedAt`
- Reference: https://onekey.dev/docs/api/google/company_ads.md

### google.hotels_info

Google Hotels detail for one hotel: name, stars, address, phone, rating, location.
- Price: 12 credits per fresh call. Status: beta. Access: needs a pack. Returns: one record.
- Request: `GET https://api.onekey.dev/v1/google/hotels_info?hotel_identifier=ChkIt-example-1` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `hotel_identifier` (string, required): Hotel id returned by google.hotels_search
  - `location_name` (string, optional, default United States): Location to search from, as an English place name (country, region or city)
  - `language_code` (string, optional, default en): Result language, ISO code (en, de, fr-CA ...)
- Fields returned: `entity.id`, `entity.name`, `entity.url`, `entity.description`, `place.address`, `entity.stats.rating`, `entity.stats.ratingCount`, `place.lat`, `place.lon`, `ext.phone`, `ext.stars`
- Reference: https://onekey.dev/docs/api/google/hotels_info.md

### google.hotels_search

Search Google Hotels: matching hotels with id, name, stars, rating and location.
- Price: 12 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/hotels_search?keyword=hotels%20in%20New%20York` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `keyword` (string, required): Hotel search query, e.g. hotels in New York
  - `location_name` (string, optional, default United States): Location to search from, as an English place name (country, region or city)
  - `language_code` (string, optional, default en): Result language, ISO code (en, de, fr-CA ...)
- Fields returned: `entity.id`, `entity.name`, `entity.stats.rating`, `entity.stats.ratingCount`, `place.lat`, `place.lon`, `ext.stars`, `ext.sponsored`
- Reference: https://onekey.dev/docs/api/google/hotels_search.md

### google.keyword_volume

Google search volume for a keyword in a country and language: average monthly searches, last 12 months, CPC, competition and keyword difficulty.
- Price: 35 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/keyword_volume?keyword=running%20shoes` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `keyword` (string, required): A single keyword or phrase (1-80 characters, at most 10 words)
  - `location_name` (string, optional, default United States): Country (or region / city) as an English place name, e.g. United States, Germany
  - `language_code` (string, optional, default en): Search language, ISO code (en, de, fr ...)
- Fields returned: `content.title`, `ext.searchVolume`, `ext.monthlySearches`, `ext.cpcUsd`, `ext.competition`, `ext.competitionLevel`, `ext.keywordDifficulty`, `ext.locationCode`, `ext.languageCode`
- Reference: https://onekey.dev/docs/api/google/keyword_volume.md

### google.news

Google News search results (keyless RSS): title, link, source, publication time.
- Price: 1 credit per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/news?q=openai` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Search query
  - `lang` (string, optional, default en): Language code, e.g. en
  - `country` (string, optional, default us): Country code, e.g. us
- Fields returned: `content.title`, `content.url`, `content.id`, `content.createdAt`, `content.text`, `author.displayName`, `author.url`
- Reference: https://onekey.dev/docs/api/google/news.md

### google.search

Google web search results: organic title, URL and snippet for a query.
- Price: 2 credits per fresh call. Status: beta. Access: needs a pack. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/search?q=python` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Search query
  - `hl` (string, optional, default en): Interface language
  - `gl` (string, optional, default us): Country
- Fields returned: `content.title`, `content.url`, `content.text`, `ext.position`, `ext.displayHost`
- Reference: https://onekey.dev/docs/api/google/search.md

### google.shopping

Google Shopping product results via Serper.dev.
- Price: 5 credits per fresh call. Status: beta. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/shopping?q=running%20shoes` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Search query
  - `gl` (string, optional, default us): Country
- Fields returned: `entity.name`, `entity.url`, `listing.price`, `listing.seller`, `media.thumbnailUrl`, `entity.stats.rating`, `entity.id`, `ext.ratingCount`, `ext.delivery`
- Reference: https://onekey.dev/docs/api/google/shopping.md

### google.suggest

Google search autocomplete suggestions for a query prefix (keyless).
- Price: 1 credit per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/suggest?q=python` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `q` (string, required): Search query
  - `lang` (string, optional, default en): Language code, e.g. en
- Fields returned: `content.text`
- Reference: https://onekey.dev/docs/api/google/suggest.md

### google.trends

Google Trends daily trending searches for a country (keyless RSS): query, approximate traffic, top news.
- Price: 5 credits per fresh call. Status: stable. Returns: a list.
- Request: `GET https://api.onekey.dev/v1/google/trends?geo=US` with header `x-api-key: YOUR_API_KEY`
- Parameters:
  - `geo` (string, optional, default US): Country code, uppercase (e.g. US, GB, IN)
- Fields returned: `content.title`, `engagement.views`, `content.createdAt`, `media.url`, `content.url`, `ext.topNewsUrl`, `ext.news`
- Reference: https://onekey.dev/docs/api/google/trends.md

## Sample request

```bash
curl "https://api.onekey.dev/v1/google/news?q=openai" \
  -H "x-api-key: YOUR_API_KEY"
```