Remote Jobs API & RSS Feed

Discover jobs and keep stored listings current.

The public and Commercial Jobs APIs return matching listings published in the last 7 days. Use it for job discovery products, research tools, community websites, internal dashboards, and prototypes.

GET https://jobicy.com/api/v2/remote-jobs

From zero to the first response.

Start with the public endpoint, add only the filters you need, and keep the Jobicy listing URL when displaying a listing.

1. Send a GET request No token or account is required for the public Jobs API.
2. Add optional filters Use count, geo, industry, and tag.
3. Read the jobs array Store only what your interface needs and retain the Jobicy listing URL.
4. Continue with nextCursor Pass the response's nextCursor as cursor in the next request, keeping your filters unchanged. Stop when it is null.
5. Check whether a listing is still active Send stored job IDs to /api/v2/remote-jobs/status?ids=123456,123457. Read each result's active, closed, or unknown status.

const response = await fetch(
  "https://jobicy.com/api/v2/remote-jobs?count=100&geo=usa&industry=engineering"
);

if (!response.ok) {
  throw new Error(`HTTP ${response.status}`);
}

const data = await response.json();
console.log(data.jobs);
console.log(data.nextCursor);

curl "https://jobicy.com/api/v2/remote-jobs?count=10&geo=usa&industry=engineering" \
  -H "Authorization: Bearer API_KEY" \
  -H "Accept: application/json"

OpenAPI specification

Import the OpenAPI 3.1 specification into Postman, Swagger UI, or other OpenAPI-compatible tools. It describes the public and Commercial Jobs APIs, cursor pagination, batch status checks, location and category taxonomies, response schemas, and errors.

Request only the listings you need.

All filters are optional. Combine them to narrow the results by count, geographic eligibility, job category, or text keyword.

Request examples

Continue through the 7-day feed.

Cursor pagination is the preferred way to retrieve more than one page. It works with both public and Commercial Jobs API requests, with no separate total-record cap within the available 7-day window.

1. Start without a cursorSend your filters and page size, for example count=100&geo=usa.
2. Read nextCursorIf it contains a string, pass that exact value as cursor in the next request. Keep geo, industry, and tag unchanged.
3. Stop at the endThe final response contains nextCursor: null and hasMore: false. Deduplicate stored listings by id.

const params = new URLSearchParams({ count: "100", geo: "usa" });
let nextCursor = null;

do {
  if (nextCursor) {
    params.set("cursor", nextCursor);
  }

  const response = await fetch(
    `https://jobicy.com/api/v2/remote-jobs?${params}`,
    { headers: { Accept: "application/json" } }
  );
  const data = await response.json();

  if (!response.ok || data.success === false) {
    throw new Error(data.error || `HTTP ${response.status}`);
  }

  for (const job of data.jobs) {
    console.log(job);
  }

  nextCursor = data.nextCursor;
} while (nextCursor);

Data ready for display or analysis.

Each job includes its source URL, employer, eligibility, employment type, description, publication date, and salary information when supplied.

Job fields

{
  "apiVersion": "2.2.19",
  "documentationUrl": "https://jobi.cy/apidocs",
  "friendlyNotice": "Thanks for using Jobicy API! Please credit Jobicy and link to the source.",
  "jobCount": 1,
  "lastUpdate": "2026-10-09T06:10:27+00:00",
  "nextCursor": null,
  "hasMore": false,
  "appliedFilters": {"count": 100},
  "jobs": [
    {
      "id": 123456,
      "url": "https://jobicy.com/jobs/example-role",
      "jobTitle": "Senior Product Designer",
      "companyName": "Example Company",
      "companyLogo": "https://example.com/logo.png",
      "jobIndustry": ["Creative & Design"],
      "jobType": ["Full-Time"],
      "jobGeo": "Anywhere",
      "jobLevel": "Senior",
      "jobExcerpt": "Short summary of the role",
      "jobDescription": "<p>Complete HTML job description</p>",
      "pubDate": "2026-10-09T06:10:27+00:00",
      "salaryMin": 90000,
      "salaryMax": 125000,
      "salaryCurrency": "USD",
      "salaryPeriod": "yearly"
    }
  ],
  "statusCode": 200,
  "success": true
}

Check stored jobs in one request.

Verify up to 100 Jobicy job IDs at once, including listings published more than seven days ago.

GET https://jobicy.com/api/v2/remote-jobs/status?ids=123456,123457,123458

ids is required: 1–100 comma-separated positive integer IDs. Duplicate IDs return one result in first-occurrence order. The limit applies before duplicate removal. Invalid or empty IDs, unsupported query parameters, and more than 100 values return HTTP 400. Only GET is supported; other methods return 405.

This endpoint does not use cursor, feed filters, or the seven-day publication window. It returns status records only, without descriptions or ATS URLs. Authentication is optional. A supplied Bearer key is validated normally, but status checks cost $0 and require no wallet balance. Rate limits still apply.

{
  "apiVersion": "2.2.19",
  "checkedAt": "2026-10-01T11:00:00+00:00",
  "count": 3,
  "jobs": [
    {"id": 123456, "status": "active"},
    {"id": 123457, "status": "closed"},
    {"id": 123458, "status": "unknown"}
  ],
  "statusCode": 200,
  "success": true
}

checkedAt is the UTC time of this batch check; count counts unique requested IDs, including unknown IDs. Public responses can be cached for 60 seconds. Authorized responses are private and not stored; they also include total_request_cost: 0. Batch stored IDs into groups of 100 and run routine status synchronization hourly or less often. Handle HTTP 429 with deferred retry.

Build and run a request here.

Choose filters, send the request, inspect the JSON response, and copy it into your development workflow.

GET https://jobicy.com/api/v2/remote-jobs?count=5

{
  "status": "Ready to send a request"
}

Explore Jobicy with AI tools.

Connect a compatible assistant, agent, or IDE to search public remote jobs, read individual vacancies, explore companies and career roles, and resolve Jobicy filter slugs. The hosted MCP server is read-only and needs no API key.

Existing integrations can keep using the legacy get_jobs and get_taxonomies tools.

{
  "mcpServers": {
    "jobicy-jobs": {
      "url": "https://jobicy.com/mcp"
    }
  }
}

Build a filtered feed.

RSS works well for readers, publishing workflows, and automation services that do not need a JSON integration.

https://jobicy.com/jobs/feed

Build useful experiences with Jobicy data.

The Jobicy API is designed for websites, applications, newsletters, research tools, AI products, and other services that help users discover remote work opportunities.

Embed or automate without rebuilding everything.

Use a small widget, the official WordPress plugin, or an automation recipe when a custom API client would add unnecessary work.

Widget example

<div id="jobicy-widget"></div>
<script>
window.jobicyWidgetConfig = {
  query: "Developer",
  theme: "light",
  autoSearch: true,
  limit: 10
};
</script>
<script src="https://jobicy.com/api/prod/wg.js"></script>

Before moving to production.

The main operational details for a stable public API or feed integration.