Find the location ids around anchor places

Changed on Oct 20, 2026

Free. Anchor places and radius_km become at most 12 location ids. Under 20 km only the anchor city is used. At 20 km or more, major cities within radius_km of an anchor are included when coordinates are known. geo_ids is that set. The search index has no radius: pass geo_ids as the location filter of a people search.

Scope: sourcing:read.

get/v1/lookups/areas

Request

Base URL: https://api.recruitmcp.com
URL: https://api.recruitmcp.com/v1/lookups/areas
Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: sourcing:read)

Query parameters

anchorsstring[] required

Place names. Repeat the parameter or separate with |.

radius_kminteger

Default 30.

limitinteger

How many items to return. Default 25, at most 100.

cursorstring

next_cursor from the previous response. An invalid cursor is 400 invalid_request, message Invalid cursor.

Headers

RecruitMCP-Version'2026-10-13'

API version. Defaults to the version the key was created with. Supported: 2026-10-13.

RecruitMCP-Customerstring

Act inside this customer (cus_…). Ignored for keys bound to a customer, which always act inside theirs.

Response

geo_ids to put in a filter.

geo_idsstring[] required

next_cursorstring nullable required

has_moreboolean required

notestring

Which anchors and cities became geo_ids. The search index has no radius, so geo_ids is the whole location filter. Under 20 km only the anchor city is used. At 20 km or more, major cities near the anchors are added, at most 12 geo ids. Says so when no place matched.

hintstring

Set when an anchor has no city id. The country is not copied into geo_ids.

fallback'country'

country when the only match was a country.

Example response

{
  "geo_ids": [
    "90009496"
  ],
  "entries": [
    {
      "geo_id": "90009496",
      "title": "London Area, United Kingdom",
      "is_area": true
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "note": "The search index has no radius. Pass these geo ids as the location filter. Major cities within 30 km are included, at most 12 geo ids.",
  "cost": {
    "credits": 0
  }
}

Changes

Oct 20, 2026ad27b35513a6 Revision changes
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status

Operation history