GET

jobs

locations

Job Search Locations Helper

curl --request GET \
  --url https://api.leadmagic.io/v3/jobs/search/locations \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.leadmagic.io/v3/jobs/search/locations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.leadmagic.io/v3/jobs/search/locations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.leadmagic.io/v3/jobs/search/locations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Job Search Locations

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

Endpoint Details

Pricing
Rate Limits

Metric	Value
Cost	FREE — 0 credits per request

Location autocomplete is free across all four location types (country, region, state, city).

Metric	Value
Requests/Minute	300
Burst Capacity	~5 requests/second

Quick Example

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

const url = new URL('https://api.leadmagic.io/v3/jobs/search/locations');
url.searchParams.set('type', 'country');
url.searchParams.set('q', 'United');
url.searchParams.set('limit', '10');

const response = await fetch(url, {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data.locations);

import requests

response = requests.get(
    'https://api.leadmagic.io/v3/jobs/search/locations',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    params={'type': 'country', 'q': 'United', 'limit': 10}
)
data = response.json()
print(data['locations'])

Request Parameters

string

Free-text location query (e.g. United, Berlin, California).

string

Location type to search. One of country, region, state, or city.

integer

default:"10"

Number of location candidates to return.

Response

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

string

type

enum<string>

Available options:

country,

region,

state,

city

limit

integer

default:10

Response

200

Location helper results

Job Search Locations Helper

curl --request GET \
  --url https://api.leadmagic.io/v3/jobs/search/locations \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.leadmagic.io/v3/jobs/search/locations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.leadmagic.io/v3/jobs/search/locations"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.leadmagic.io/v3/jobs/search/locations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Get Started

API Endpoints

MCP Server

CLI

Job Search Locations

Job Search Locations

Endpoint Details

Quick Example

Request Parameters

Response

Example Response

Job Search

Job Country (Legacy)

Job Regions (Legacy)

Job Search Helpers

Authorizations

Query Parameters

Response

​Job Search Locations

​Endpoint Details

​Quick Example

​Request Parameters

​Response

​Example Response

​Related endpoints

Job Search

Job Country (Legacy)

Job Regions (Legacy)

Job Search Helpers

Authorizations

Query Parameters

Response

Job Search Locations

Endpoint Details

Quick Example

Request Parameters

Response

Example Response

Related endpoints