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

​
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

MetricValue
CostFREE — 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.

​
Quick Example

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

​
Request Parameters

​
q
string
Free-text tag query (e.g. kuber matches kubernetes, kubectl, etc.).
​
tag_type
integer
Optional tag-type ID to scope the search. Use Job Search Catalogs to discover tag-type IDs.
​
limit
integer
default:"10"
Number of tag candidates to return.

​
Response

​
tags
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

​
q
string
​
tag_type
integer
​
limit
integer
default:10

Response

200

Tag helper results