Locations & languages

SERP requests need a location and a language. Resolve the exact codes with these reference endpoints.

location_code is Google’s geo target criteria ID (e.g. 2840 = United States) and the language codes are Google’s language identifiers, so any mapping you already keep against Google’s codes works as-is.

Locations

GET /v1/locations lists supported Google locations.

Query param	Notes
country	Filter by ISO-3166 alpha-2 (e.g. US, GB).
limit	Max rows (1–5000, default 5000).
offset	Pagination offset.

curl "https://api.serplify.io/v1/locations?country=GB&limit=5" \
  -H "Authorization: Bearer live_your_key_here"

{
  "request_id": "req_…",
  "status": "ok",
  "meta": { "api_version": "0.1.0", "time": 0.05, "cost": 0, "currency": "USD" },
  "data": {
    "total": 950,
    "locations": [
      { "code": 2826, "name": "United Kingdom", "country": "GB", "type": "Country", "parent_code": null },
      { "code": 1006886, "name": "London,England,United Kingdom", "country": "GB", "type": "City", "parent_code": 20339 }
    ]
  }
}

GET /v1/locations/{country} returns all locations for one ISO country:

curl https://api.serplify.io/v1/locations/us \
  -H "Authorization: Bearer live_your_key_here"

Languages

GET /v1/languages lists supported languages.

curl https://api.serplify.io/v1/languages \
  -H "Authorization: Bearer live_your_key_here"

{
  "request_id": "req_…",
  "status": "ok",
  "meta": { "api_version": "0.1.0", "time": 0.02, "cost": 0, "currency": "USD" },
  "data": {
    "languages": [
      { "code": "en", "name": "English" },
      { "code": "es", "name": "Spanish" }
    ]
  }
}

Using the values

Pass the code (or name) into a SERP request:

{
  "keyword": "coffee",
  "location": { "code": 1006886 },
  "language": { "code": "en" }
}

Reference lookups are free.