Job Search

LeadMagic’s Jobs Finder

POST /v1/jobs/jobs-finder

Jobs Finder

cURL

curl --request POST \
  --url https://api.leadmagic.io/v1/jobs/jobs-finder \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_website": "clay.com",
  "job_title": "RevOps Engineer",
  "country_id": "US",
  "has_remote": true,
  "posted_within": 30,
  "page": 1,
  "per_page": 20
}
'

200

{
  "total_count": 50,
  "page": 1,
  "per_page": 20,
  "total_pages": 3,
  "credits_consumed": 20,
  "results": [
    {
      "company": {
        "name": "LeadMagic",
        "website_url": "https://leadmagic.io",
        "b2b_profile_url": "leadmagichq",
        "twitter_handle": "leadmagichq",
        "github_url": "https://github.com/leadmagic"
      },
      "title": "Senior Software Engineer",
      "location": "San Jose, San José, Costa Rica",
      "types": [
        {
          "id": 1,
          "name": "Full Time"
        }
      ],
      "cities": [
        {
          "geonameid": 3621849,
          "asciiname": "San Jose",
          "name": "San José",
          "country": {
            "code": "CR",
            "name": "Costa Rica",
            "region": {
              "id": 5,
              "name": "North America"
            }
          },
          "timezone": "America/Costa_Rica",
          "latitude": "9.93333",
          "longitude": "-84.08333"
        }
      ],
      "countries": [
        {
          "code": "CR",
          "name": "Costa Rica",
          "region": {
            "id": 5,
            "name": "North America"
          }
        }
      ],
      "regions": [
        {
          "id": 5,
          "name": "North America"
        }
      ],
      "has_remote": false,
      "published": "2024-07-23T15:25:00Z",
      "description": "",
      "application_url": "https://leadmagic.io/careers",
      "language": "en",
      "clearance_required": false,
      "salary_min": null,
      "salary_max": null,
      "salary_currency": null,
      "experience_level": "Senior Level"
    }
  ]
}

Job Search

This is the legacy v1 jobs endpoint (POST /v1/jobs/jobs-finder). For new integrations, use the Job Search endpoint backed by /v3/jobs/search, which supports occupation taxonomy, helper resolution, vector search, and richer filters. This page remains available for existing integrations.

Search and filter job listings across companies with a straightforward page-based jobs search.

Endpoint Details

Pricing

Metric	Value
Cost	1 credit per job returned
No Results	FREE if no jobs found

Hiring Signals: Companies with open positions are actively investing and growing - perfect timing for sales outreach.

Rate Limits

Per-Endpoint Limit

Metric	Value
Requests/Minute	100
Burst Capacity	~2 requests/second

Rate limits are subject to change. Custom rate limits are available on enterprise plans — contact us.

---

Quick Example

cURL

curl -X POST 'https://api.leadmagic.io/v1/jobs/jobs-finder' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "job_title": "Sales Director",
    "country_id": "US",
    "experience_level": "senior",
    "has_remote": true,
    "posted_within": 14,
    "page": 1,
    "per_page": 20
  }'

---

Request Parameters

All fields are optional - combine them to filter results:

Company Filters

company_name · string

Company name to search

company_website · string

Company domain

company_type_id · integer

Company type ID (see Company Types)

company_industry_id · integer

Industry ID (see Industries)

min_employees · integer

Minimum company size

max_employees · integer

Maximum company size

Job Filters

job_title · string

Title keyword search

job_description · string

Description keyword search

experience_level · string

Level: entry, mid, senior, executive

job_type_id · integer

Job type ID (see Job Types)

has_remote · boolean

Filter for remote work options

Location Filters

location · string

City or region name

city_name · string

Specific city

country_id · string

Country code (US, UK, etc.) - see Countries

region_id · integer

State/region ID (see Regions)

Date Filters

posted_within · integer

Days since posting (e.g., 14 for last 2 weeks)

posted_after · string

Posted on or after (YYYY-MM-DD)

posted_before · string

Posted on or before (YYYY-MM-DD)

Pagination

page · integer · default: "1"

Page number

per_page · integer · default: "20"

Results per page (max: 50)

---

Response

total_count · integer · required

Total jobs matching filters

page · integer · required

Current page

per_page · integer · required

Results per page

total_pages · integer · required

Total pages available

credits_consumed · integer · required

Credits used (1 per job returned)

results · array · required

Array of job listings

Job Object

Field	Type	Description
title	string	Job title
company.name	string	Company name
company.website_url	string	Company website
company.b2b_profile_url	string	Company profile URL
location	string	Job location
types	array	Job types (Full-time, etc.)
experience_level	string	Entry, Mid, Senior, Executive
has_remote	boolean	Remote work available
published	string	Posted date
description	string	Full job description
application_url	string	Apply link

Example Response

{
  "total_count": 142,
  "page": 1,
  "per_page": 20,
  "total_pages": 8,
  "credits_consumed": 20,
  "results": [
    {
      "title": "VP of Sales",
      "company": {
        "name": "LeadMagic",
        "website_url": "https://leadmagic.io",
        "b2b_profile_url": "https://linkedin.com/company/leadmagichq"
      },
      "location": "San Francisco, CA",
      "types": ["Full-time"],
      "experience_level": "Executive",
      "has_remote": true,
      "published": "2026-01-28",
      "description": "Leading enterprise sales team...",
      "application_url": "https://leadmagic.io/careers/vp-sales"
    }
  ]
}

---

Reference Endpoints

Get valid filter IDs from these endpoints (all free, no credits):

Countries

Get country IDs

Regions

Get region/state IDs

Job Types

Get job type IDs

Company Types

Get company type IDs

Industries

Get industry IDs

---

Best Practices

Filter by posted_within

Use posted_within: 14 to focus on companies actively hiring right now.

Target your buyer's role

Companies hiring for your buyer’s role have active budget and immediate need.

Chain with Role Finder

After finding hiring companies, use Role Finder to find decision makers.

Use pagination wisely

Start with per_page: 20 and paginate. Don’t request large pages you won’t use.

---

Use Cases

Sales Intelligence

Companies hiring for your buyer persona have active budget.

ABM Targeting

Find companies hiring roles that need your product.

Market Research

Analyze hiring trends across industries.

Recruiting

Discover open positions matching candidate profiles.

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).

Body

application/json

company_name · string

Provide the Company Name. (Optional)

Example:

"Clay"

company_website · string

Provide the Company Website. (Optional)

Example:

"clay.com"

job_title · string

Provide the Job Title.

Example:

"RevOps Engineer"

location · string

Location of the job

Example:

"United States"

experience_level · string

Indicates the required experience level for the job. Choose "entry" for Entry Level, "mid" for Mid Level, "senior" for Senior Level, or "executive" for Executive Level. If not specified, jobs from all experience levels will be included.

Example:

"senior"

job_description · string

Filters jobs based on specific keywords or phrases found in the job description.

Example:

"leadmagic"

country_id · string

Filter jobs by country code, such as US or GB. Use the country helper for supported values.

Example:

"US"

region_id · integer

Filter jobs by region ID.

Example:

5

job_type_id · integer

Filter jobs by job type ID.

Example:

1

company_type_id · integer

Filter jobs by company type ID.

Example:

1

company_industry_id · integer

Filter jobs by company industry ID.

Example:

7

min_employees · integer

Minimum number of employees

Example:

51

max_employees · integer

Maximum number of employees

Example:

10000

has_remote · boolean

Determines whether the jobs offer remote work options. Set to true to include remote-only listings, or false to include non-remote listings.

Example:

true

posted_within · integer

Specify the number of days within which the job was posted.

Example:

30

posted_after · string<date>

Filters jobs posted on or after a specific date. Use the format YYYY-MM-DD.

Example:

"2026-05-01"

posted_before · string<date>

Filters jobs posted on or before a specific date. Use the format YYYY-MM-DD.

Example:

"2026-05-15"

page · integer · default: 1

Page number

per_page · integer · default: 20

Provide number of results needed per page. (Maximum per_page can be 50)

Response

200

application/json

Successful response with job listings

total_count · integer · default: 0

page · integer · default: 0

per_page · integer · default: 0

total_pages · integer · default: 0

credits_consumed · integer · default: 0

results · object[]

Show child attributes