---
title: "Jobs Finder"
method: POST
path: "/v1/jobs/jobs-finder"
tags: ["Jobs Data"]
---

# Jobs Finder

`POST /v1/jobs/jobs-finder`

LeadMagic's Jobs Finder

## Request body

- object
  - `company_name` string — Provide the Company Name. (Optional)
  - `company_website` string — Provide the Company Website. (Optional)
  - `job_title` string — Provide the Job Title.
  - `location` string — Location of the job
  - `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.
  - `job_description` string — Filters jobs based on specific keywords or phrases found in the job description.
  - `city_name` string — Filter jobs by city name. Pair with `country_id` to disambiguate cities that share a name.
  - `country_id` string — Filter jobs by country code, such as US or GB. Use the country helper for supported values.
  - `region_id` integer — Filter jobs by region ID.
  - `job_type_id` integer — Filter jobs by job type ID.
  - `company_type_id` integer — Filter jobs by company type ID.
  - `company_industry_id` integer — Filter jobs by company industry ID.
  - `min_employees` integer — Minimum number of employees
  - `max_employees` integer — Maximum number of employees
  - `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.
  - `posted_within` integer — 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 — Page number
  - `per_page` integer — Provide number of results needed per page. (Maximum per_page can be 50)

## Response `200`

Successful response with job listings

- object
  - `total_count` integer
  - `page` integer
  - `per_page` integer
  - `total_pages` integer
  - `credits_consumed` integer
  - `results` object[]
    - `company` object
      - `name` string
      - `website_url` string
      - `b2b_profile_url` string, nullable
      - `twitter_handle` string, nullable
      - `github_url` string, nullable
    - `title` string
    - `location` string
    - `types` object[]
      - `id` integer
      - `name` string
    - `cities` object[]
      - `geonameid` integer
      - `asciiname` string
      - `name` string
    - `country` object
    - `timezone` string
    - `latitude` string
    - `longitude` string
    - `countries` object[]
      - `code` string
      - `name` string
    - `region` object
    - `regions` object[]
      - `id` integer
      - `name` string
    - `has_remote` boolean
    - `published` string
    - `description` string
    - `application_url` string
    - `language` string, nullable
    - `clearance_required` boolean
    - `salary_min` string, nullable
    - `salary_max` string, nullable
    - `salary_currency` string, nullable
    - `experience_level` string

## Other responses

- `400` — Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401` — Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key
- `402` — Payment Required - Insufficient credits for this request. **Action required:** Add credits to your account at https://app.leadmagic.io/settings/billing
- `429` — Too Many Requests - Rate limit exceeded. **Action required:** Check the `Retry-After` header for when to retry. **Headers returned:** - `Retry-After`: Seconds until you can retry - `RateLimit-Limit`: Your limit per minute - `RateLimit-Remaining`: Remaining requests this minute - `RateLimit-Reset`: Seconds until limit resets
- `500` — Internal Server Error - Something went wrong on our end. **Action required:** Wait 30 seconds and retry. If the problem persists, contact support@leadmagic.io

---

[API](https://skmtc.net/leadmagic/apis/leadmagic-api.md) · [All operations](https://skmtc.net/leadmagic/apis/leadmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadmagic/leadmagic-api/versions/e95809714e4d/schema)