Endpoints

Understand the API and how to use it.

The job response model

The job response model is the data structure for a job. It includes the following properties:

Properties

  • Name
    id
    Type
    number
    Description

    Unique identifier for the job.

  • Name
    apply_url
    Type
    string
    Description

    The URL to apply for the job.

  • Name
    title
    Type
    string
    Description

    The job title.

  • Name
    description
    Type
    string
    Description

    The job description in markdown format.

  • Name
    company
    Type
    string
    Description

    The name of the company offering the job.

  • Name
    logo_url
    Type
    string
    Description

    The URL of the company's logo.

  • Name
    skill_level
    Type
    Enum
    Description

    The required skill level for the job (e.g., entry-level, experienced).

  • Name
    job_type
    Type
    Enum
    Description

    The type of job (e.g., full-time, part-time, contract).

  • Name
    technologies
    Type
    Enum[]
    Description

    A list of technologies required for the job.

  • Name
    main_technology
    Type
    Enum
    Description

    The primary technology used or required for the job.

  • Name
    is_degree_required
    Type
    boolean
    Description

    Indicates whether a degree is required for the job.

  • Name
    country_iso
    Type
    string
    Description

    The ISO (alpha-2) code of the job's origin country.

  • Name
    original_listing_source
    Type
    string
    Description

    The source where the job listing was originally found.

  • Name
    min_payment_usd
    Type
    number
    Description

    The minimum salary for the job in USD.

  • Name
    max_payment_usd
    Type
    number
    Description

    The maximum salary for the job in USD.

  • Name
    payment_type
    Type
    Enum
    Description

    The type of payment or compensation (e.g., hourly, salary, contract).

  • Name
    created_at
    Type
    timestamp
    Description

    The date and time when the job was created/listed.

  • Name
    deadline
    Type
    timestamp
    Description

    The application deadline for the job.

  • Name
    applications
    Type
    number
    Description

    The number of applications received for the job.

  • Name
    views
    Type
    number
    Description

    The number of times the job listing has been viewed.


GET/v1/get-jobs

List all jobs

This endpoint allows you to retrieve a paginated list of all the jobs.

By default, 10 jobs are shown per page. This can be adjusted to show up to 30 per request.

Ordered by the most recent jobs first.

Optional attributes

  • Name
    limit
    Type
    number
    Description

    Limit the number of jobs returned. Default is 10. Maximum is 30.

  • Name
    page
    Type
    number
    Description

    The page number, for pagination. Default is 1.

  • Name
    featured
    Type
    boolean
    Description

    Show only featured jobs.

  • Name
    degree_required
    Type
    boolean
    Description

    If true, show only jobs that require a degree. If false, show only jobs that do not require a degree.

  • Name
    skill_levels
    Type
    Enum
    Description

    A list of skill levels to filter by, as a comma-separated string (e.g., "junior,mid").

  • Name
    job_types
    Type
    Enum
    Description

    A list of job types to filter by, as a comma-separated string (e.g., "full_time,part_time").

  • Name
    technologies
    Type
    Enum
    Description

    A list of technologies to filter by, as a comma-separated string (e.g., "react,python").

  • Name
    main_technology
    Type
    Enum
    Description

    The main technology the job is looking for (e.g., "python").

  • Name
    country_iso
    Type
    string
    Description

    The ISO (alpha-2) code of the country to filter by.

  • Name
    payment_type
    Type
    Enum
    Description

    The type of payment or compensation to filter by (e.g., "hourly,salary").

  • Name
    min_payment_usd
    Type
    number
    Description

    The minimum payment to filter by in USD.

  • Name
    max_payment_usd
    Type
    number
    Description

    The maximum payment to filter by in USD.

  • Name
    posted_after
    Type
    time
    Description

    Show only jobs posted after this date and time. Format: "YYYY-MM-DDTHH:MM:SS".

Request

GET
/v1/get-jobs
curl -G https://api.crackeddevs.com/v1/get-jobs \
  -H "api-key: your_api_key" \
  -d limit=10

Response

[
    {
      "id": 1318,
      "apply_url": "https://crackeddevs.com/job/software-engineer-1318?ref=api",
      "title": "Software Engineer — Engineering Acceleration",
      "description": "# About Us. \n\nThe Applied AI team safely brings OpenAI's technology to the world.",
      "company": "OpenAI",
      "logo_url": "https://remoteok.com/assets/img/jobs/e21ef56203688ec59838a147ae82ccde1703800815.png",
      "skill_level": "mid",
      "job_type": "full_time",
      "technologies": [
          "html",
          "css",
          "react",
      ],
      "main_technology": "react",
      "is_degree_required": false,
      "country_iso": null,
      "original_listing_source": "REMOTE_OK",
      "min_payment_usd": null,
      "max_payment_usd": 450000,
      "payment_type": "salary",
      "created_at": "2024-03-05T13:30:39.852375+00:00",
      "deadline": null,
      "applications": 2000,
      "views": 6000
    },
    {
      "id": 69773,
      // ...
    }
]

Was this page helpful?