Skip to main content
GET
/
v3
/
jobs
/
search
/
locations
Job Search Locations Helper
curl --request GET \
  --url https://api.leadmagic.io/v3/jobs/search/locations \
  --header 'X-API-Key: <api-key>'

​
Job Search Locations

Location autocomplete for Job Search. Resolve country, region, state, and city candidates into canonical IDs for exact geo filtering.

​
Endpoint Details

MetricValue
CostFREE — 0 credits per request
Location autocomplete is free across all four location types (country, region, state, city).

​
Quick Example

curl 'https://api.leadmagic.io/v3/jobs/search/locations?type=country&q=United&limit=10' \
  -H 'X-API-Key: YOUR_API_KEY'

​
Request Parameters

​
q
string
Free-text location query (e.g. United, Berlin, California).
​
type
string
Location type to search. One of country, region, state, or city.
​
limit
integer
default:"10"
Number of location candidates to return.

​
Response

​
locations
object[]
Matching locations with id, name, and type.

​
Example Response

{
  "locations": [
    { "id": 840, "name": "United States", "type": "country" },
    { "id": 826, "name": "United Kingdom", "type": "country" }
  ]
}

Job Search

Pass resolved location.countries / regions / states / cities into search.

Job Country (Legacy)

Legacy v1 country list — prefer this v3 helper for new integrations.

Job Regions (Legacy)

Legacy v1 region list.

Job Search Helpers

Index of all filter helpers.

Authorizations

​
X-API-Key
string
header
required

Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).

Query Parameters

​
q
string
​
type
enum<string>
Available options:
country,
region,
state,
city
​
limit
integer
default:10

Response

200

Location helper results