API Documentation

Integrate HubNugget job listings into your platform with our RESTful API. Get access to active job listings with advanced filtering, pagination, and real-time updates.

Getting Started

1. Get Your API Key

Get API Key

2. Base URL

All API requests should be made to:

https://api.hubnugget.com/public/jobs

3. Authentication

Include your API key in the x-api-key header:

x-api-key: API-019a7e8f-115a-735c-9b05-ba929823b5d5-HN-2025-11-14

GET

Get Active Jobs

https://api.hubnugget.com/public/jobs

Description

Retrieve a paginated list of active job listings. Supports advanced filtering, sorting, and search capabilities.

Query Parameters

Parameter	Type	Required	Description
`limit`	integer	Optional	Number of items per page (default: 10)
`page`	integer	Optional	Page number (default: 1)
`sortOrder`	string	Optional	Sort order: ASC or DESC (default: DESC)

Code Examples

curl -X 'GET' \
  'https://api.hubnugget.com/public/jobs?limit=10&page=1&sortOrder=DESC' \
  -H 'accept: */*' \
  -H 'x-api-key: API-019a7e8f-115a-735c-9b05-ba929823b5d5-HN-2025-11-14'

Response

{
  "success": true,
  "statusCode": 200,
  "path": "/public/jobs?limit=10&page=1&sortOrder=DESC",
  "timeStamp": "Thu, 13 Nov 2025 18:56:41 GMT",
  "payload": {
    "data": [
      {
        "id": "201",
        "createOn": "2026-01-15T09:30:00.000Z",
        "updatedOn": "2026-02-01T11:45:20.000Z",
        "status": "ACTIVE",
        "title": "Software Developer",
        "description": "We are looking for a skilled Software Developer to design, develop, and maintain scalable web applications. You will work closely with product managers and designers to deliver high-quality solutions.",
        "jdAi": "### Role Overview\n\nWe are hiring a Software Developer with strong problem-solving skills and experience in modern web technologies. The ideal candidate should be comfortable working in an agile environment and contributing across the full development lifecycle.\n\n### Responsibilities\n- Design and develop scalable web applications\n- Write clean, maintainable, and testable code\n- Collaborate with cross-functional teams\n- Participate in code reviews and system design discussions\n\n### Requirements\n- Strong knowledge of JavaScript / TypeScript\n- Experience with Angular or React\n- Familiarity with REST APIs\n- Experience with SQL or NoSQL databases\n\n### Nice to Have\n- Experience with Node.js or Java\n- Cloud experience (AWS / Azure)\n",
        "expiresOn": "2026-02-28T23:59:59.000Z",
        "primarySkills": [
          "JavaScript",
          "TypeScript",
          "Angular"
        ],
        "secondarySkills": [
          "Node.js",
          "PostgreSQL",
          "Git"
        ],
        "jobType": "full_time",
        "jobMode": "remote",
        "location": "India",
        "perks": [
          "Flexible working hours",
          "Work from home",
          "Health insurance",
          "Paid leave"
        ],
        "preferredLanguages": [
          "English"
        ],
        "minExperience": 2,
        "maxExperience": 5,
        "fromSalary": 600000,
        "toSalary": 1200000,
        "fixedSalary": null,
        "compensationCurrency": "INR",
        "isVisaSponsorshipAvailable": false,
        "isOurPlatform": true,
        "applicationLink": null,
        "interviewRoundTemplate": {
          "id": "12",
          "title": "Software Developer Hiring Process",
          "totalNumberOfRounds": 4
        }
      }
    ],
    "total": 7,
    "page": 1,
    "limit": 10
  }
}

Empty Result (No Jobs Found)

{
  "success": true,
  "statusCode": 200,
  "message": "OK",
  "path": "/public/jobs?limit=10&page=1",
  "timeStamp": "Thu, 14 Nov 2025 00:00:00 GMT",
  "payload": {
    "data": [],
    "total": 0,
    "page": 1,
    "limit": 10
  }
}

Response Schema

success (boolean) - Request success status

statusCode (integer) - HTTP status code

path (string) - API endpoint path with query parameters

timeStamp (string) - Response timestamp

payload (object) - Response payload containing data and pagination

payload.data (array) - Array of job objects

payload.total (integer) - Total number of jobs

payload.page (integer) - Current page number

payload.limit (integer) - Items per page

Error Responses

401 Unauthorized - Missing API Key

When x-api-key header is missing or empty

{
  "success": false,
  "statusCode": 401,
  "timestamp": "Thu, 14 Nov 2025 00:00:00 GMT",
  "path": "/public/jobs?limit=10&page=1",
  "message": "API key is required",
  "payload": []
}

401 Unauthorized - Invalid API Key

When API key does not exist, format is incorrect, or belongs to a non-existent account

{
  "success": false,
  "statusCode": 401,
  "timestamp": "Thu, 14 Nov 2025 00:00:00 GMT",
  "path": "/public/jobs?limit=10&page=1",
  "message": "Invalid API key",
  "payload": []
}

401 Unauthorized - Account Not Verified

When API key exists but the associated account is not verified

{
  "success": false,
  "statusCode": 401,
  "timestamp": "Thu, 14 Nov 2025 00:00:00 GMT",
  "path": "/public/jobs?limit=10&page=1",
  "message": "Invalid API key",
  "payload": []
}

Rate Limits

Free Tier (Beta)

100 requests per minute
10,000 requests per day
Rate limit headers included in responses

Rate Limit Headers:

X-RateLimit-Limit - Request limit per window
X-RateLimit-Remaining - Remaining requests
X-RateLimit-Reset - Time when limit resets

Support & Resources

Need Help?

Contact our developer support team for assistance with API integration.

Contact Support

Status Page

Check API status and uptime information.

View Status