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
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?name=Paris&country_code=FR"[
{
"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 Technology Categories GET
This endpoint lets you get all the categories of the technologies we monitor, and the number of technologies and companies in each category.