Jobicy developer resource

Remote Jobs API & RSS Feed

Add current remote jobs to apps, websites, AI tools, and automated workflows with a public REST endpoint, MCP server, RSS feed, or widget.

One endpoint for current remote jobs.

The public Jobs API returns the latest remote listings available on Jobicy. Use it for job discovery products, research tools, community websites, internal dashboards, and prototypes.

FORMAT

Clean JSON

Structured fields for the employer, role, location, job type, description, and salary.

ACCESS

No API key

Start with a simple GET request. No account or authentication header is required; url returns the Jobicy listing.

RESULTS

Up to 200 jobs

Retrieve the latest records and combine location, category, and keyword filters.

Base request
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. Check whether a listing is still active Send a lightweight HEAD request to the Jobicy vacancy URL. An HTTP 404 or 410 response means the vacancy is no longer active.
JavaScript
const response = await fetch(
  "https://jobicy.com/api/v2/remote-jobs?count=10&geo=usa&industry=engineering"
);

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

const data = await response.json();
console.log(data.jobs);
Optional Commercial Jobs API: direct application links

The API key is optional. Without it, url always contains the Jobicy listing URL and the public API remains free. To receive the original ATS application URL in url, create an API key in your Jobicy API Dashboard and send it with every request as Authorization: Bearer API_KEY. A wallet is required: each job with an available direct application URL costs $0.01 once per API key. Repeated requests for the same job and key are free.

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

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.

count

Number of listings to return. Accepted range: 1–200.

Default 200
geo

Location slug such as usa, europe, or apac.

Optional
industry

Category slug such as engineering, marketing, or data-science.

Optional
tag

Keyword search applied to the available job content.

Optional
Use current slugs

Load the location list and category list before storing values in a production integration.

Request examples

Keyword search

Twenty recent jobs mentioning Python.

GET /api/v2/remote-jobs?count=20&tag=python

Country filter

Fifteen recent jobs available in Canada.

GET /api/v2/remote-jobs?count=15&geo=canada

Category and location

Marketing jobs available to applicants in the USA.

GET /api/v2/remote-jobs?geo=usa&industry=marketing

Customer success

Five recent customer support opportunities.

GET /api/v2/remote-jobs?count=5&industry=supporting

Data ready for display or analysis.

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

FieldTypeDescription
idintegerUnique Jobicy listing ID.
urlstringJobicy listing URL for public requests. With a valid Commercial Jobs API Bearer key, it contains the original ATS application URL when one is available; otherwise it remains the Jobicy listing URL.
jobTitlestringRole title.
companyNamestringEmployer name.
companyLogostringEmployer logo URL when available.
jobIndustryarrayJob category labels.
jobTypearrayEmployment type values.
jobGeostringRemote location eligibility.
jobLevelstringExperience or seniority level.
jobExcerptstringShort listing summary, up to 55 characters.
jobDescriptionHTML stringFull job description.
pubDatedate-timeOriginal publication date.
salaryMin / salaryMaxnumberSalary bounds when provided.
salaryCurrencystringISO currency code.
salaryPeriodstringSalary interval, such as yearly or hourly.
Job object
{
  "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-07-30T12:00:00+00:00",
  "salaryMin": 90000,
  "salaryMax": 125000,
  "salaryCurrency": "USD",
  "salaryPeriod": "yearly"
}
Checking listing availability

To verify whether a previously retrieved vacancy is still active, send a lightweight HEAD request to the Jobicy listing URL returned by the public API. An HTTP 404 or 410 response indicates that the vacancy is no longer active. For cached or stored listings, checking availability once or twice per hour is generally sufficient.

Build and run a request here.

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

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

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

Remote job search for AI tools.

The public MCP server lets compatible assistants, agents, and IDEs discover valid filters and retrieve structured listings through the public Jobicy MCP endpoint.

TOOL 01

get_jobs

Retrieves jobs using optional count, geo, industry, and tag filters.

TOOL 02

get_taxonomies

Returns current location or category slugs before a tool applies strict filters.

MCP configuration
{
  "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.

Generated feed URL
https://jobicy.com/jobs/feed
Canonical and legacy URLs

Use /jobs/feed for new integrations. The older /feed/job_feed address remains available for compatibility. Polling a few times per day is normally sufficient and must not exceed once per hour.

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.

  1. You may use Jobicy listings in your own products and user experiences without requesting individual permission.
  2. Keep Jobicy as the original source and preserve the canonical Jobicy job URL when displaying listings.
  3. You may create your own interfaces, summaries, categories, search experiences, and additional context around listings.
  4. Do not present Jobicy listings as your own original job postings or remove source attribution.
  5. Avoid excessive API requests and cache responses where appropriate to provide a reliable experience for everyone.
  6. Do not use the API to create spam networks, misleading job databases, or services that negatively affect employers or candidates.
No approval required for normal integrations

Most integrations, including job boards, newsletters, career tools, AI assistants, and internal applications, can use the public API without a separate agreement. Contact us only for high-volume commercial partnerships or custom data arrangements.

Earn commissions from your Jobicy referrals

If you use Jobicy listings on your website, app, newsletter, or other product, you can turn the original Jobicy job URLs into referral links and earn a commission when users you refer make eligible purchases on Jobicy.

Simply append your Jobicy user ID to the job URL: https://jobicy.com/jobs/example-job?u=YOUR_USER_ID

The job URL remains the same — the ?u= parameter simply attributes the referred user to your account.

You earn a commission when your referred users complete eligible purchases on Jobicy.

View your referral ID, referred users, earnings, and other affiliate details in your Affiliate account.
Manage your affiliate account →
Learn more about the Jobicy Affiliate Program →

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.

01

IFTTT applets ›

Send new remote jobs to LinkedIn, X, Facebook, Telegram, Slack, Discord, or WordPress.

02

Embeddable widget

Add a responsive job search interface with light and dark themes.

Widget example

HTML
<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.

Does the Jobs API require an API key?

No. The public remote jobs endpoint and taxonomy requests do not require authentication. A Bearer API key is only needed for Commercial Jobs API access, which returns direct ATS application URLs in url when available.

How do I receive the original application link?

Send Authorization: Bearer API_KEY with the Jobs API request. With an active key and sufficient API wallet balance, url returns the original ATS application URL. If a vacancy has no original application URL, url remains the Jobicy listing and no charge is made.

How many jobs can one request return?

The count parameter accepts values from 1 to 200. The endpoint returns the latest available matching jobs.

How should a client discover valid filters?

Use ?get=locations and ?get=industries instead of relying on a hard-coded list indefinitely.

Can the job description contain HTML?

Yes. Treat jobDescription as HTML and sanitize it according to the security rules of your application.

How often should an integration poll?

A few checks per day are usually enough. Automated checks must not run more frequently than once per hour.

Integration examples on GitHub

Build with the Jobicy Jobs API, RSS feeds and MCP using complete examples for Node.js, Python, Next.js, Telegram, Discord, Slack, WordPress, n8n, Zapier, Make and AI agents. View Jobicy API Examples on GitHub 

Ready to test an integration?

Start with the public endpoint, inspect current filter values, and move to MCP, RSS, or the widget when the use case is clear.

Jobs Talent AI Tools Salaries
Menu