GET

jobs

tags

Job Search Tags Helper

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

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

fetch('https://api.leadmagic.io/v3/jobs/search/tags', 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/tags"

	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/tags",
  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 Tags

Tag autocomplete for Job Search filter builders. Tags include tools, platforms, skills, and other normalized hiring-signal dimensions (e.g. kubernetes, terraform, react).

Endpoint Details

Pricing
Rate Limits

Metric	Value
Cost	FREE — 0 credits per request

Tag, title, occupation taxonomy, location, and catalog helpers are all zero-credit. The companies helper and resolve endpoint are the only paid Job Search helpers.

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

Quick Example

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

const url = new URL('https://api.leadmagic.io/v3/jobs/search/tags');
url.searchParams.set('q', 'kuber');
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.tags);

import requests

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

Request Parameters

string

Free-text tag query (e.g. kuber matches kubernetes, kubectl, etc.).

integer

Optional tag-type ID to scope the search. Use Job Search Catalogs to discover tag-type IDs.

integer

default:"10"

Number of tag candidates to return.

Response

object[]

Matching tags with id, name, and any associated occupation taxonomy metadata.

Example Response

{
  "tags": [
    {
      "id": 482,
      "name": "kubernetes",
      "tag_type": 2,
      "occupation_taxonomy": {
        "level1": { "id": 1, "name": "Developer" },
        "level2": { "id": 20, "name": "DevOps" }
      }
    }
  ]
}

Job Search

Run search with the resolved tag IDs.

Job Search Catalogs

Discover tag-type IDs and other filter dimensions.

Occupation Taxonomy

Explore the taxonomy levels associated with tags.

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

tag_type

integer

limit

integer

default:10

Response

200

Tag helper results

Job Search Tags Helper

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

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

fetch('https://api.leadmagic.io/v3/jobs/search/tags', 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/tags"

	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/tags",
  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 Tags

Job Search Tags

Endpoint Details

Quick Example

Request Parameters

Response

Example Response

Job Search

Job Search Catalogs

Occupation Taxonomy

Job Search Helpers

Authorizations

Query Parameters

Response

​Job Search Tags

​Endpoint Details

​Quick Example

​Request Parameters

​Response

​Example Response

​Related endpoints

Job Search

Job Search Catalogs

Occupation Taxonomy

Job Search Helpers

Authorizations

Query Parameters

Response

Job Search Tags

Endpoint Details

Quick Example

Request Parameters

Response

Example Response

Related endpoints