Sign in

v3

latestOpenAPI 3.1.02026-07-318648277.6 KB
Jobs Data

Jobs Finder

LeadMagic's Jobs Finder

post/v1/jobs/jobs-finder

Request body

company_namestring

Provide the Company Name. (Optional)

company_websitestring

Provide the Company Website. (Optional)

job_titlestring

Provide the Job Title.

locationstring

Location of the job

experience_levelstring

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_descriptionstring

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

country_idstring

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

region_idinteger

Filter jobs by region ID.

job_type_idinteger

Filter jobs by job type ID.

company_type_idinteger

Filter jobs by company type ID.

company_industry_idinteger

Filter jobs by company industry ID.

min_employeesinteger

Minimum number of employees

max_employeesinteger

Maximum number of employees

has_remoteboolean

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

posted_withininteger

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

posted_afterstring date

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

posted_beforestring date

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

pageinteger

Page number

per_pageinteger

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

Example request

{
  "company_name": "Clay",
  "company_website": "clay.com",
  "job_title": "RevOps Engineer",
  "location": "United States",
  "experience_level": "senior",
  "job_description": "leadmagic",
  "country_id": "US",
  "region_id": 5,
  "job_type_id": 1,
  "company_type_id": 1,
  "company_industry_id": 7,
  "min_employees": 51,
  "max_employees": 10000,
  "has_remote": true,
  "posted_within": 30,
  "posted_after": "2026-05-01",
  "posted_before": "2026-05-15"
}

Response

Successful response with job listings

total_countinteger
pageinteger
per_pageinteger
total_pagesinteger
credits_consumedinteger

Example response

{
  "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"
    }
  ]
}