Location Search

Search the full Crunchbase location taxonomy (300K+ entries). Filter by facet to narrow results to cities, regions, or countries. Each result includes parent locations and geographic groups (e.g., EMEA, Middle East) for hierarchical filtering in company and person searches.

HTTP Request

1
GET /location/search

Parameters

Parameter	Type	Required	Default	Description
`q`	string	No	—	Find locations whose name contains this text (case-insensitive)
`facet`	string	No	`any`	Restrict to one tier: `any`, `city`, `region`, `country`, `continent`, `group`
`parent`	string	No	—	Reverse lookup: every location contained by this parent. Slug, UUID, or name
`per_page`	integer	No	`5`	Results per page (max 15)
`sort`	string	No	`asc`	`asc` for A→Z

Response

Example Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
{
  "status": true,
  "request_id": "b1036dad-9f5d-c795-fbce-6feb063e",
  "data": {
    "total": 304848,
    "page": 1,
    "has_next_page": false,
    "results": [
      {
        "name": "'ayanot",
        "slug": "ayanot-hamerkaz",
        "uuid": "0cf11f8a-e223-c8b8-fd25-c76bb68fe76e",
        "image": null,
        "type": "location",
        "short_description": "'ayanot, HaMerkaz, Israel, Asia",
        "location_type": [],
        "groups": [
          {
            "uuid": "4e8be435-c63a-4aff-8a2f-44a880d9c341",
            "slug": "europe-middle-east-africa-emea",
            "name": "Europe, Middle East, and Africa (EMEA)",
            "type": "location",
            "image": null
          }
          // ... more items
        ],
        "parents": [
          {
            "uuid": "0cf11f8a-e223-c8b8-fd25-c76bb68fe76e",
            "slug": "ayanot-hamerkaz",
            "name": "'ayanot",
            "type": "location",
            "image": null
          }
          // ... more items
        ]
      }
      // ... more items
    ],
    "resolved_filters": {}
  },
  "request_params": {
    "facet": "city",
    "sort": "asc",
    "per_page": "2"
  }
}

Response Fields

Field	Type	Description
`status`	boolean	Whether the request was successful
`request_id`	string	Unique identifier for the request
`data.total`	integer	Total number of matching locations
`data.page`	integer	Current page number
`data.has_next_page`	boolean	Whether more pages of results are available
`data.results`	array	List of location objects
`data.results[].name`	string	Display name of the location
`data.results[].slug`	string	URL-safe identifier for the location
`data.results[].uuid`	string	Unique UUID for the location
`data.results[].image`	string\|null	Image URL for the location (typically null)
`data.results[].type`	string	Entity type (always `"location"`)
`data.results[].short_description`	string	Human-readable location path (e.g., “City, Region, Country, Continent”)
`data.results[].location_type`	array	Location type tags (e.g., city, region, country)
`data.results[].groups`	array	Geographic groups this location belongs to
`data.results[].groups[].uuid`	string	UUID of the geographic group
`data.results[].groups[].slug`	string	Slug of the geographic group
`data.results[].groups[].name`	string	Name of the geographic group (e.g., “Middle East”)
`data.results[].groups[].type`	string	Entity type (always `"location"`)
`data.results[].groups[].image`	string\|null	Image URL for the group
`data.results[].parents`	array	Parent locations in the hierarchy (city > region > country)
`data.results[].parents[].uuid`	string	UUID of the parent location
`data.results[].parents[].slug`	string	Slug of the parent location
`data.results[].parents[].name`	string	Name of the parent location
`data.results[].parents[].type`	string	Entity type (always `"location"`)
`data.results[].parents[].image`	string\|null	Image URL for the parent location
`data.resolved_filters`	object	Resolved filter values (empty for this endpoint)
`request_params`	object	Echo of the request parameters sent
`request_params.facet`	string	The facet filter applied
`request_params.sort`	string	The sort direction applied
`request_params.per_page`	string	The per_page value applied

Code Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import requests

url = "https://crunchbase-extractor-full-api3.p.rapidapi.com/location/search"

querystring = {
    "facet": "city",
    "per_page": "50",
    "sort": "asc"
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "crunchbase-extractor-full-api3.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=querystring)
data = response.json()["data"]

print(f"Total locations: {data['total']}")
for location in data["results"]:
    print(f"{location['name']} ({location['slug']})")
    print(f"  Path: {location['short_description']}")
    groups = [g['name'] for g in location['groups']]
    print(f"  Groups: {', '.join(groups)}\n")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
const url = "https://crunchbase-extractor-full-api3.p.rapidapi.com/location/search";

const params = new URLSearchParams({
  facet: "city",
  per_page: "50",
  sort: "asc",
});

const response = await fetch(`${url}?${params}`, {
  method: "GET",
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "crunchbase-extractor-full-api3.p.rapidapi.com",
  },
});

const { data } = await response.json();

console.log(`Total locations: ${data.total}`);
data.results.forEach((location) => {
  console.log(`${location.name} (${location.slug})`);
  console.log(`  Path: ${location.short_description}`);
  const groups = location.groups.map((g) => g.name).join(", ");
  console.log(`  Groups: ${groups}\n`);
});

1
2
3
4
5
6
curl -G "https://crunchbase-extractor-full-api3.p.rapidapi.com/location/search" \
  --data-urlencode "facet=city" \
  --data-urlencode "per_page=50" \
  --data-urlencode "sort=asc" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: crunchbase-extractor-full-api3.p.rapidapi.com"

Autocomplete Locations — Location autocomplete for search filter type-ahead
Company Search — Search companies filtered by location
Person Search — Search people filtered by location