GET

jobs

companies

Job Search Companies Helper

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

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

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

	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/companies",
  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 Companies

Company autocomplete and card data for Job Search filter builders. Use this helper to resolve a free-text company name or domain into a canonical company ID before running search.

Endpoint Details

Pricing
Rate Limits

Metric	Value
Cost	FREE — 0 credits per request
No Results	FREE

The main Job Search route can auto-resolve companies when autoResolve is true. Use this helper directly when you’re building autocomplete or filter-builder UIs.

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

Quick Example

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

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

import requests

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

Request Parameters

string

Free-text company name or domain to search for.

string

Exact company domain to look up (e.g. leadmagic.io).

integer

default:"10"

Number of company candidates to return.

Response

object[]

Matching company candidates with id, name, domain, and any available card data.

Example Response

{
  "companies": [
    {
      "id": 102413,
      "name": "LeadMagic",
      "domain": "leadmagic.io",
      "logo_domain": "leadmagic.io"
    }
  ]
}

Job Search

Run search using the resolved company IDs from this helper.

Job Search Helpers

Index of all Job Search filter helpers.

Job Search Resolve

Resolve a full draft search request in one call.

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

domain

string

limit

integer

default:10

Response

200

Company helper results

Job Search Companies Helper

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

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

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

	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/companies",
  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 Companies

Job Search Companies

Endpoint Details

Quick Example

Request Parameters

Response

Example Response

Job Search

Job Search Helpers

Job Search Resolve

Authorizations

Query Parameters

Response

​Job Search Companies

​Endpoint Details

​Quick Example

​Request Parameters

​Response

​Example Response

​Related endpoints

Job Search

Job Search Helpers

Job Search Resolve

Authorizations

Query Parameters

Response

Job Search Companies

Endpoint Details

Quick Example

Request Parameters

Response

Example Response

Related endpoints