Skip to main content
POST
/
jobs-finder
Jobs Finder
curl --request POST \
  --url https://api.leadmagic.io/jobs-finder \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_name": "Microsoft",
  "company_website": "https://www.microsoft.com",
  "job_title": "Developer",
  "location": "new york",
  "city_name": "<string>",
  "experience_level": "senior",
  "job_description": "python \"software engineer\"",
  "country_id": "US",
  "region_id": 123,
  "job_type_id": 1,
  "company_type_id": 4,
  "company_industry_id": 123,
  "min_employees": 123,
  "max_employees": 123,
  "has_remote": false,
  "posted_within": 30,
  "posted_after": "2023-12-25",
  "posted_before": "2023-12-25",
  "page": 1,
  "per_page": 20
}
'
{
  "total_count": 50,
  "page": 1,
  "per_page": 20,
  "total_pages": 3,
  "credits_consumed": 20,
  "results": [
    {
      "company": {
        "name": "Microsoft",
        "website_url": "https://www.microsoft.com/",
        "linkedin_url": "https://www.linkedin.com/company/microsoft/",
        "twitter_handle": "Microsoft",
        "github_url": "https://github.com/microsoft"
      },
      "title": "Senior Support Engineer - Developer Messaging",
      "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"
        }
      ],
      "remote": false,
      "published_at": "2024-07-23T15:25:00Z",
      "description": "Microsoft is a company where passionate innovators come to collaborate...",
      "application_url": "https://jobs.careers.microsoft.com/global/en/job/1743018/",
      "language": "en",
      "salary_min": null,
      "salary_max": null,
      "salary_currency": null,
      "experience_level": "Senior Level"
    }
  ]
}
Charges 1 credit for 1 job.
Rate Limit: 200 requests per minute.
Contact our support team if you need to increase your requests per minute.

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
default:Microsoft

Filter jobs by company name (e.g., Microsoft, Google, Apple)

company_website
string
default:https://www.microsoft.com

Filter jobs by company website URL

job_title
string
default:Developer

Filter jobs by job title or role (e.g., Developer, Engineer, Manager)

location
string
default:new york

Filter jobs by location (city, state, or country)

city_name
string

Filter jobs by specific city name (e.g., San Francisco, New York, London)

experience_level
string
default:senior

Filter by experience level. Accepts: entry, junior, mid, intermediate, senior, expert, executive, or director (case-insensitive). You can also use full names like 'Entry Level', 'Mid Level', 'Senior Level', or 'Executive Level'. If not specified, jobs from all experience levels will be included.

job_description
string
default:python "software engineer"

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

country_id
string
default:US

Filter Jobs By Country. Check this https://docs.leadmagic.io/reference/job-country api to get country id.

region_id
integer

Filter Jobs By Region. Check this https://docs.leadmagic.io/reference/job-region api to get region id.

job_type_id
integer
default:1

Filter Jobs By Types. Check this https://docs.leadmagic.io/reference/job-type api to get job type id.

company_type_id
integer
default:4

Filter Jobs By Company Types. Check this https://docs.leadmagic.io/reference/job-company-type api to get company type id.

company_industry_id
integer

Filter Jobs By Company Industry. Check this https://docs.leadmagic.io/reference/job-industry api to get company industry id.

min_employees
integer

Minimum number of employees

max_employees
integer

Maximum number of employees

has_remote
boolean
default:false

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

posted_within
integer
default:30

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

posted_after
string<date>

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

posted_before
string<date>

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

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[]