Gradient

List Jobs

Retrieve a paginated list of job postings with advanced filtering options. Uses cursor-based pagination to ensure data consistency as new jobs are added.

Endpoint

GET/api/v1/jobs

Parameters

cursorstring

Cursor for pagination. Use next_cursor from previous response

limitinteger

Items per page (default: 20, max: 100)

locationstring

Filter by location (partial match)

experience_levelstring

Filter by experience level (entry, mid, senior, lead, executive)

industrystring

Filter by industry ID

skillsstring

Filter by skill IDs (comma-separated)

companystring

Filter by company name (partial match)

searchstring

Search in title, description, company

featuredboolean

Filter featured jobs only

job_typestring

Filter by job type (full-time, part-time, contract, freelance)

Responses

200Successful response with job listings
{
  "data": [
    {
      "id": "64a1b2c3d4e5f6789012345",
      "title": "Senior Frontend Developer",
      "company": {
        "name": "Tech Innovators Inc",
        "brand": {
          "id": "64a1b2c3d4e5f678901234a",
          "name": "Tech Innovators",
          "logo": "https://example.com/logo.png"
        }
      },
      "location": "New York, NY",
      "job_type": "Full-time",
      "experience_level": "Senior",
      "job_description": "We're looking for a Senior Frontend Developer with expertise in React and TypeScript to join our team...",
      "structured_description": [
        {
          "header": "Job Description",
          "content": "We're looking for a Senior Frontend Developer with expertise in React and TypeScript to join our team..."
        },
        {
          "header": "Responsibilities",
          "content": "• Build and maintain responsive web applications\n• Collaborate with design and backend teams\n• Write clean, testable code"
        },
        {
          "header": "Requirements",
          "content": "• 5+ years of frontend development experience\n• Strong React and TypeScript skills\n• Experience with modern build tools"
        }
      ],
      "application_url": "https://example.com/apply/senior-frontend-developer",
      "highlights": [
        "React",
        "TypeScript",
        "Remote-friendly"
      ],
      "salary": {
        "min": 120000,
        "max": 180000,
        "currency": "USD"
      },
      "posted_at": "2025-07-25",
      "is_featured": true,
      "skills": [
        "React",
        "TypeScript"
      ],
      "industries": [
        {
          "id": "industry1",
          "name": "Technology"
        }
      ],
      "created_at": "2025-07-25T10:00:00Z",
      "updated_at": "2025-07-25T10:00:00Z"
    }
  ],
  "pagination": {
    "cursor": null,
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNS0wNy0yNVQxMDowMDowMFoiLCJpZCI6IjY0YTFiMmMzZDRlNWY2Nzg5MDEyMzQ1In0=",
    "has_more": true,
    "limit": 20
  },
  "meta": {
    "api_version": "v1",
    "timestamp": "2025-08-01T12:00:00Z"
  }
}
400Bad request - invalid parameters
401Unauthorized - invalid or missing API key

Code Examples

curl -X GET https://essence-api.gradientgroup.com/api/v1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY"

API Configuration

Your API key is stored locally and used for testing.

Try it out

Parameters