canonical: https://jentic.com/apis/jobicy.com/jobicy # Jobicy Remote Jobs API The Jobicy Remote Jobs API exposes Jobicy's curated feed of fully remote job listings through a single GET /remote-jobs endpoint. Listings include title, company name, location preferences, job type (full-time, contract, part-time), salary range when known, posted date, and a link to apply. The endpoint is open (no authentication) and is intended for embedding remote-job listings in third-party sites, dashboards, and bots - for example a Slack bot that posts new remote roles each morning, or a personal job-search aggregator. ## For AI agents Read curated remote job listings from Jobicy's open feed via a single GET /remote-jobs endpoint - title, company, location, type, salary, and apply link. ## Scope Does not handle applications, candidate tracking, or employer postings - use for reading Jobicy's curated remote jobs feed only. ## Capabilities - Retrieve the latest remote job listings curated by Jobicy via GET /remote-jobs - Filter listings by job type (full-time, part-time, contract) when supported by query parameters - Filter listings by region or country preference where the listing exposes that field - Read each listing's company name and original apply URL for downstream display or scraping - Read salary range when posted by the employer for filtering or analytics - Identify listings posted in a recent window using the posted-date field ## Use cases ### Daily Remote-Jobs Digest in Slack or Email A scheduled bot pulls the latest /remote-jobs each morning, filters by tag (engineering, design, marketing), de-duplicates against yesterday's pull, and posts new listings to a Slack channel or email digest. Because the endpoint is open and a single call returns all current listings, this is a one-cron, no-credentials integration that takes minutes to build. Example prompt: Call GET /remote-jobs, filter results to tag=engineering posted in the last 24 hours, and post each new listing as a Slack message with the title, company, and apply URL. ### Remote-Jobs Aggregator Site or Widget A personal site, newsletter, or Notion dashboard can embed a 'Latest remote jobs' widget by calling /remote-jobs server-side and rendering the response. Refreshing every few hours keeps the widget current without scraping the Jobicy site directly. Example prompt: Call GET /remote-jobs, cache the response for 4 hours, and render the top 20 listings as cards on the page with title, company, location, and apply link. ### Job-Market Analytics on Remote Hiring Trends Researchers and HR teams pull /remote-jobs daily, store the snapshots, and compute trends - which roles are growing, which companies are most active, average posted salary by category - without crawling the Jobicy website. A small ETL job is sufficient to build a multi-month dataset. Example prompt: Call GET /remote-jobs daily, persist each listing with a captured-at timestamp, and aggregate weekly counts by tag and average posted salary by tag for a trend dashboard. ### AI Agent Integration via Jentic A career-assistant agent uses Jentic to discover the Jobicy remote jobs operation. The agent searches for 'find remote jobs' and Jentic returns the GET /remote-jobs operation. Because the endpoint is open, no credentials are required - Jentic still adds value by serving the operation schema and parameters to the agent on demand. Example prompt: Search Jentic for 'find remote jobs', load the GET /remote-jobs schema, and execute it filtered to the user's preferred tag and region. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/remote-jobs` | List curated remote job listings | ## Key resources - **Remote Jobs** — Curated list of remote job listings exposed via a single GET endpoint. ## Why Jentic - **Setup:** Wiring the Jobicy Remote Jobs API by hand means reading its v2 feed docs, building the query parameters for its single /remote-jobs endpoint, and parsing the response yourself, even though it needs no auth. Through Jentic you install once, import the Jobicy Remote Jobs API from the API Directory, and your agent calls it with the right parameters at runtime. - **Permission scoping:** This API exposes a single read-only operation, GET /remote-jobs, so you limit the agent to the operations it needs, in this case just reading the curated remote-jobs feed. There is no write surface here, so the agent can query listings and nothing more. - **Credential handling:** This endpoint is open, so there is no key to store; if that changes, any credential would be stored once, encrypted, by your own Jentic One instance and injected at execution time. It would never enter the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'find remote jobs' or 'list remote developer roles', and Jentic returns the GET /remote-jobs operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **The Muse API** — The Muse offers a broader job feed across in-office and remote roles versus Jobicy's remote-only curation - **Adzuna API** — Adzuna aggregates millions of jobs across many countries with salary benchmarks; Jobicy is a smaller curated remote-only feed - **JobAdder API** — Use Jobicy as a sourcing feed and JobAdder as the ATS that tracks resulting candidates ## FAQ ### What authentication does the Jobicy Remote Jobs API use? None. The /remote-jobs endpoint is open and the spec declares a noAuth security scheme. You can call it directly from a server, Slack bot, or a Jentic agent without provisioning any credentials. ### Can I filter results from the Jobicy API by job tag or region? GET /remote-jobs is the single endpoint and accepts query parameters for filtering - the spec exposes the available filters. In practice, fetch the response and filter client-side as well, since the curated list is small enough to scan in memory. ### What are the rate limits for the Jobicy Remote Jobs API? Jobicy does not publish a fixed rate limit, but the open feed should be polled responsibly - typically once an hour or once every few hours is sufficient for a digest or widget. Use HTTP caching headers if returned, and back off on any 429 response. ### How do I build a remote-jobs digest through Jentic? Run pip install jentic, search for 'find remote jobs', and execute GET /remote-jobs on a schedule. Diff against the previous day's pull and post any new listings to your channel of choice - no credentials needed. ### Is the Jobicy Remote Jobs API free? Yes. The endpoint is open, no auth, no key, and Jobicy publishes it for community use. Respect the published terms on jobicy.com if you redistribute the listings at scale. ### Can I limit what my agent is allowed to do with the Jobicy Remote Jobs API? Yes. Because you run Jentic One yourself, self-hosted, your own rules decide which operations your agent may call, and the Jobicy Remote Jobs API exposes only a single read-only operation, GET /remote-jobs. You can scope the agent to that one read operation, so it can fetch the curated remote-jobs feed and nothing more. There is no write surface here, so the agent can query listings but cannot create, edit, or delete anything.