Get Geographic Locations
Search for geographic locations by name or ID to retrieve standardized location data.
The returned location data can be used with the Job Search and Company Search endpoints.
This endpoint does not consume API credits.
Location data is sourced from GeoNames.
Examples
Search for locations by name:
curl "https://api.theirstack.com/v0/catalog/locations?name=Paris" --header "Authorization: Bearer YOUR_API_KEY"Retrieve location details by ID:
curl "https://api.theirstack.com/v0/catalog/locations?id=2968815" --header "Authorization: Bearer YOUR_API_KEY"Authorization
Bearer In: header
Query Parameters
The ids of the locations
Search value for the location, this will be used to filter the locations by name
The country code of the location, all the returned locations will be filtered by this country code
GeoNames feature code(s) to filter by location type (e.g. PPL=populated place, ADM1=first-order admin division). See https://www.geonames.org/export/codes.html
The offset of the results
The limit of the results
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.theirstack.com/v0/catalog/locations"[
{
"id": 5128581,
"name": "New York",
"admin1_name": "New York",
"country_code": "US",
"feature_code": "PPL",
"feature_name": "city",
"display_name": "string",
"country_name": "string"
}
]{
"request_id": null,
"error": {
"code": "E-001",
"title": "Not allowed exception",
"description": "string"
}
}{
"request_id": null,
"error": {
"code": "E-001",
"title": "Not allowed exception",
"description": "string"
}
}{
"request_id": null,
"error": {
"code": "E-001",
"title": "Not allowed exception",
"description": "string"
}
}{
"request_id": null,
"error": {
"code": "E-001",
"title": "Not allowed exception",
"description": "string"
}
}How is this guide?
Last updated on
Get Jobs And Companies Per Job Country Code GET
This endpoint will return all the country codes and the number of jobs whose location's country code is the given one, and the number of companies with jobs in that country.
List Technologies GET
This endpoint lets you list all the technologies we track, search for any given technology and list the technologies within one or several categories.