JobSphere API Documentation

Welcome to the official JobSphere API documentation. Build powerful integrations with the world's leading job board platform using our RESTful API.

Quick Links

Authentication

The JobSphere API uses API keys to authenticate requests. You can view and manage your API keys in the Dashboard. API keys carry many privileges, so be sure to keep them secure.

All API requests must include the Authorization header with your API key:

Authorization: Bearer js_live_sk_your_api_key_here

Example Request

Here's an example of how to retrieve a list of active jobs using cURL:

curl -X GET https://api.jobsphere.io/v2/jobs \\
  -H "Authorization: Bearer js_live_sk_test123" \\
  -H "Content-Type: application/json"

Response Example

{
  "data: [
    {
      "id: "job_9f8e7d6c5b4a,
      "title: "Senior Frontend Developer,
      "company: {
        "id: "comp_1a2b3c4d,
        "name: "TechCorp Inc.,
        "logo_url: "https://cdn.jobsphere.io/logos/techcorp.png
      },
      "location: "Remote,
      "salary_range: {
        "min: 120000,
        "max: 160000,
        "currency: "USD
      },
      "posted_at: "2025-01-15T10:30:00Z
    }
  ],
  "meta: {
    "total: 142,
    "page: 1,
    "per_page: 20
  }
}

Pagination

API responses that return multiple items are paginated by default. The default page size is 20 items. You can customize pagination using the page and per_page query parameters.

Rate Limits

To ensure fair usage, the JobSphere API implements rate limiting. Limits vary based on your subscription plan:

Rate limit information is included in the response headers:

• X-RateLimit-Limit: Maximum requests allowed
• X-RateLimit-Remaining: Requests remaining in the window
• X-RateLimit-Reset: Timestamp when the limit resets