Get Geographic Locations
Search for geographic locations by name or ID to retrieve standardized location data including city, region, and country. Use location IDs with job_location_or and job_location_not filters for precise geographic targeting in job searches.
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 Technologies And Buying Intents GET
List all keywords tracked by TheirStack, including both technologies and buying intent topics. Search for any keyword and filter by one or more categories.
Get Keyword Categories GET
Returns a list of main keyword categories (technologies and buying intents) with the number of keywords and companies in each. Optionally filters to return a specific category if category_slug is provided.