Skip to content

Jobicy/remote-jobs-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

API MCP RSS

Jobicy API, MCP & RSS Feeds

Quick Start

Get the latest 10 remote jobs:

curl "https://jobicy.com/api/v2/remote-jobs?count=10"

Get Sales jobs from the USA:

curl "https://jobicy.com/api/v2/remote-jobs?count=10&geo=usa&industry=seller"

Contents

Looking to enhance your job board, application, AI agent, or website with high-quality remote job opportunities?

Jobicy provides remote job data through:

  • REST API
  • MCP Server (for AI agents and IDEs)
  • RSS Feed
  • Embeddable Widget
  • WordPress Plugin

Endpoint

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

The API provides access to the latest remote job listings from distributed companies across multiple industries and regions.

Query Parameters

Parameter Description
count Number of listings to return (default: 100, range: 1-100)
geo Filter by job region (default: all regions)
industry Filter by job category (default: all categories)
tag Search by job title and description (default: all jobs)

Example:

https://jobicy.com/api/v2/remote-jobs?count=20&geo=usa&industry=marketing&tag=seo

Taxonomies

Retrieve available filter values:

https://jobicy.com/api/v2/remote-jobs?get=locations
https://jobicy.com/api/v2/remote-jobs?get=industries

Response Fields

{
 "id": Unique Job ID,
 "url": Job link,
 "jobTitle": Job title,
 "companyName": Company name,
 "companyLogo": Company logo link,
 "jobIndustry": Job function (industry),
 "jobType": Job type (full-time, contract, part-time or internship)
 "jobGeo": Geographic restriction for employment (or Anywhere if not applicable), 
 "jobLevel": Seniority level (or Any if not applicable), 
 "jobExcerpt": Excerpt job description (max 55 characters), 
 "jobDescription": Full job description (HTML), 
 "pubDate": Publication date and time (UTC+00:00),
 "salaryMin": Min salary (if applicable),
 "salaryMax": Max salary (if applicable),
 "salaryCurrency": ISO 4217 salary currency code (if applicable)
 "salaryPeriod": The period for which the salary is paid (e.g., hourly, daily, ...)
}

API Examples

Latest 20 Python jobs:

https://jobicy.com/api/v2/remote-jobs?count=20&tag=python

Latest 15 jobs from Canada:

https://jobicy.com/api/v2/remote-jobs?count=15&geo=canada

Latest 30 Copywriting jobs from the USA:

https://jobicy.com/api/v2/remote-jobs?count=30&geo=usa&industry=copywriting

Latest 10 Customer Success jobs:

https://jobicy.com/api/v2/remote-jobs?count=10&industry=supporting

MCP Server

The Jobicy MCP server allows AI assistants, IDEs, and autonomous agents to access Jobicy job listings in real time.

MCP Endpoint

MCP Endpoint:
https://jobicy.com/mcp

Discovery:
https://jobicy.com/.well-known/mcp.json

Legacy SSE:
https://jobicy.com/mcp/sse

Available Tools

get_jobs

Returns remote job listings.

Parameters:

count (number, optional) - Number of listings to return (range: 1-100, default: 100)
geo (string, optional) - Filter by geographic region slug (e.g., "europe", "usa", "apac")
industry (string, optional) - Filter by job category slug (e.g., "dev", "marketing", "seo")
tag (string, optional) - Search keyword for job titles and descriptions

get_taxonomies

Returns available filtering values.

Parameters:

type (string, required) - Must be either "locations" or "industries"

Note for developers: AI models are instructed to query get_taxonomies first to discover valid geoSlug and industrySlug values before filtering jobs.

MCP Configuration Example

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

RSS Feed

Jobicy provides a public RSS feed containing remote job listings.

Feed URL

https://jobicy.com/feed/job_feed

RSS Parameters

Parameter Description
job_categories Category slug
job_types full-time, contract, internship, part-time
search_keywords Keyword search
search_region Region slug

RSS Query Parameters:

/feed/job_feed (required)
&job_categories=... (admin-support, copywriting, translation-localization, supporting, technical-support, cybersecurity, data-science, design-multimedia, video-audio-production, web-app-design, admin, e-commerce, education, accounting-finance, healthcare, hr, legal, marketing, business, seller, seo, smm, management, project-management, engineering, dev, qa-testing)
&job_types=... (full-time, freelance, contract, part-time)
&search_keywords=... (eg. designer)
&search_region=... (apac, emea, latam, argentina, australia, austria, belgium, brazil, bulgaria, canada, china, hong-kong, costa-rica, croatia, cyprus, czechia, denmark, estonia, europe, finland, france, germany, greece, hungary, ireland, israel, italy, japan, latvia, lithuania, mexico, netherlands, new-zealand, norway, philippines, poland, portugal, romania, serbia, singapore, slovakia, slovenia, south-korea, spain, sweden, switzerland, thailand, turkiye, united-arab-emirates, uk, ukraine, usa, vietnam)

Example query string:

https://jobicy.com/feed/job_feed?job_categories=supporting&job_types=full-time&search_region=usa

Response: Full-time Customer Service jobs in the U.S. region.


Embeddable Widget

Add a live remote jobs widget to any website.

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

Widget Options

Option Description
query Default search term
theme light or dark
autoSearch Automatically search on load
limit Number of jobs to display (1-100)

WordPress Plugin

Use the official WordPress plugin to display Jobicy remote jobs on your website.

Shortcode:

[jobicy_jobs]

Plugin URL:

https://wordpress.org/plugins/jobicy/

IFTTT Applets

Automatically publish new remote jobs to:

  • LinkedIn
  • Twitter/X
  • Facebook
  • Telegram
  • Slack
  • Discord
  • WordPress

Browse available applets: https://ifttt.com/job


Fair Use and Restrictions

  1. API, RSS and MCP access are provided to help distribute Jobicy job listings.
  2. Do not redistribute listings to competing job aggregation platforms such as Google Jobs, LinkedIn, Jooble, and similar services.
  3. Job listings are intentionally published with a 6-hour delay.
  4. Polling feeds more than once per hour is discouraged.
  5. Excessive requests may result in restricted access.

Access may be restricted if:

  • You intentionally overload the service.
  • You modify or misrepresent the original content.
  • Your activity negatively impacts platform stability.

Why Jobicy?

  • Curated remote jobs
  • Worldwide coverage
  • REST API
  • MCP support
  • RSS feeds
  • Free public access

About

Public API, MCP server, RSS feeds, widgets and WordPress tools for accessing Jobicy remote jobs.

Topics

Resources

License

Contributing

Stars

6 stars

Watchers

0 watching

Forks

Contributors