---
name: remote-jobs-finder
description: Finds live remote and hybrid job openings from JobsRemoteList and shortlists the ones that fit the user. Use when the user asks for job openings, remote work, or roles they can apply to from their country.
---

# Remote jobs finder

Search live openings with the free JobsRemoteList API. No key is needed.

## Search

`GET https://jobsremotelist.online/api/public/jobs?q=<keywords>&country=<ISO2>&remote=true&limit=20`

- `q`: role keywords; every word must match the title, tags or company. Use 1 to 3 words ("product manager", "data engineer").
- `country`: two-letter code of the country the user lives in (for example `BR`, `PT`, `IN`). Returns jobs open to that country or worldwide.
- `remote=true`: fully remote only. Leave it out to include hybrid jobs.
- `limit`: 1 to 50.

The response lists `title`, `company`, `url`, `location`, `work_arrangement`, `eligible_countries`, `salary` and `published_at`.

## Steps

1. Ask for anything you need and do not know: the role, the country the user lives in, and seniority.
2. Search. If there are no results, try a shorter or broader `q`, then try without `country` and say that the roles may not accept the user's country.
3. Shortlist up to 5 jobs. For each, give the title, company, why it fits, anything that could rule the user out (eligible countries, time zone, language, work authorisation), and the `url`.
4. Only present jobs returned by the API. Tell the user to confirm the details and apply on the employer's page linked from each job.
