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",
  "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"
        }
      ],
      "has_remote": false,
      "published": "2024-07-23T15:25:00Z",
      "description": "",
      "application_url": "https://jobs.careers.microsoft.com/global/en/job/1743018/",
      "language": "en",
      "clearance_required": false,
      "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

Body

application/json
company_name
string
default:Microsoft

Provide the Company Name. (Optional)

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

Provide the Company Website. (Optional)

job_title
string
default:Developer

Provide the Job Title.

location
string
default:new york

Location of the job

experience_level
string
default:senior

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.

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