Gradient

List Industries

Retrieve a list of all available industries for job classification and filtering.

Endpoint

GET/api/v1/industries

Responses

200Successful response with industry list
{
  "success": true,
  "count": 40,
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Technology",
      "slug": "technology"
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "name": "Healthcare",
      "slug": "healthcare"
    },
    {
      "id": "507f1f77bcf86cd799439013",
      "name": "Finance",
      "slug": "finance"
    }
  ]
}
401Unauthorized - invalid or missing API key

Code Examples

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

API Configuration

Your API key is stored locally and used for testing.

Try it out

Get Industry Details

Retrieve details for a specific industry including job count.

Endpoint

GET/api/v1/industries/:id

Parameters

idRequiredstring

Industry ID

Responses

200Successful response with industry details
{
  "success": true,
  "data": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Technology",
    "slug": "technology",
    "job_count": 5420
  }
}
401Unauthorized - invalid or missing API key
404Industry not found

Code Examples

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

API Configuration

Your API key is stored locally and used for testing.

Try it out

Parameters

Get Jobs by Industry

Retrieve jobs within a specific industry with cursor-based pagination.

Endpoint

GET/api/v1/industries/:id/jobs

Parameters

idRequiredstring

Industry ID

cursorstring

Pagination cursor from previous response

limitinteger

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

Responses

200Successful response with jobs in the industry
{
  "success": true,
  "industry": {
    "id": "507f1f77bcf86cd799439011",
    "name": "Technology",
    "slug": "technology"
  },
  "data": [
    {
      "id": "507f191e810c19729de860ea",
      "title": "Senior Software Engineer",
      "company": {
        "name": "TechCorp",
        "brand": {
          "id": "507f1f77bcf86cd799439014",
          "name": "TechCorp",
          "logo": "https://example.com/logo.png"
        }
      },
      "location": "San Francisco, CA",
      "job_type": "Full-time",
      "experience_level": "Senior",
      "description": "We are looking for a senior software engineer...",
      "job_description": "Full job description with responsibilities and requirements...",
      "application_url": "https://example.com/apply",
      "highlights": [
        "Competitive salary",
        "Remote work options",
        "Health benefits"
      ],
      "salary": {
        "min": 120000,
        "max": 180000,
        "currency": "USD"
      },
      "posted_at": "2024-01-15T10:00:00Z",
      "is_featured": false,
      "skills": [
        {
          "id": "507f1f77bcf86cd799439015",
          "name": "JavaScript"
        }
      ],
      "industries": [
        {
          "id": "507f1f77bcf86cd799439011",
          "name": "Technology"
        }
      ],
      "created_at": "2024-01-15T10:00:00Z",
      "updated_at": "2024-01-15T10:00:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNC0wMS0xNVQxMDowMDowMFoiLCJpZCI6IjUwN2YxOTFlODEwYzE5NzI5ZGU4NjBlYSJ9",
    "has_more": true
  }
}
401Unauthorized - invalid or missing API key
404Industry not found

Code Examples

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

API Configuration

Your API key is stored locally and used for testing.

Try it out

Parameters

Industry Statistics

Get statistics for all industries including job counts.

Endpoint

GET/api/v1/industries/stats/summary

Responses

200Successful response with industry statistics
{
  "success": true,
  "total_industries": 40,
  "total_jobs_with_industry": 18523,
  "data": [
    {
      "id": "507f1f77bcf86cd799439011",
      "name": "Technology",
      "slug": "technology",
      "job_count": 5420
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "name": "Healthcare",
      "slug": "healthcare",
      "job_count": 3215
    },
    {
      "id": "507f1f77bcf86cd799439013",
      "name": "Finance",
      "slug": "finance",
      "job_count": 2890
    }
  ]
}
401Unauthorized - invalid or missing API key

Code Examples

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

API Configuration

Your API key is stored locally and used for testing.

Try it out