Feed URL parameters
The query parameters used by the Remotera job feed, including list delimiters, defaults, and session-dependent behavior.
The feed stores its filters in the query string. You can bookmark, edit, or share these URLs directly.
Parameters
| Parameter | Value | Example |
|---|---|---|
q | Search text | ?q=platform+engineer |
company | One public company id | ?company=<id> |
arrangement | remote, hybrid, onsite | ?arrangement=remote |
country | ISO two-letter working country | ?country=TH |
worldwide | Boolean | ?worldwide=true |
hide_viewed | Boolean; signed-in only | ?hide_viewed=true |
min | Minimum profile match, 0–100; signed-in only | ?min=70 |
sort | date, relevance, salary | ?sort=salary |
roles | Comma-separated role or group tokens | ?roles=backend,ml_ai |
seniority | Comma-separated levels | ?seniority=senior,staff |
employment | Comma-separated types | ?employment=contract |
entry | Boolean: no experience required | ?entry=true |
c2c | Boolean: C2C stated | ?c2c=true |
industry | One industry value | ?industry=fintech |
company_size | startup, mid, enterprise list | ?company_size=startup |
skills | Pipe-separated skill labels | ?skills=React%7CTypeScript |
skills_match | any or all | ?skills_match=all |
languages | Comma-separated ISO language codes | ?languages=en,de |
salary_min | Annual USD minimum | ?salary_min=120000 |
salary_max | Annual USD maximum | ?salary_max=200000 |
has_salary | Boolean | ?has_salary=true |
xq | Pipe-separated excluded text | ?xq=crypto%7Cgambling |
xroles | Comma-separated excluded roles | ?xroles=sales |
xseniority | Comma-separated excluded levels | ?xseniority=junior |
xindustry | Pipe-separated excluded industries | ?xindustry=gambling |
xskills | Pipe-separated excluded skills | ?xskills=PHP |
xcompany | Comma-separated excluded company ids | ?xcompany=<id> |
xcompanyname | Pipe-separated excluded company names | ?xcompanyname=Acme |
xarrangement | Comma-separated excluded arrangements | ?xarrangement=onsite |
order | Display order for filter chips; does not filter | Written by the UI |
Omitted parameters use the broad default: no filter, sort=date,
skills_match=any, and booleans false.
Delimiters and encoding
Skills and free-text exclusion lists use a pipe because values can contain commas. Most normalized lists use commas.
In a URL, a pipe is encoded as %7C and the colon in a role-group token as
%3A.
Role tokens
Individual roles:
frontend, backend, fullstack, mobile, qa, devops, sre, data_engineering,
data_science, ml_ai, blockchain, security, design, product,
project_management, engineering_management, marketing, sales,
business_development, community, content, support, hr, finance, operations,
research, otherGroup tokens:
| Token | Includes |
|---|---|
grp:engineering | Frontend, backend, full-stack, mobile, QA, DevOps, SRE, data engineering, ML/AI, blockchain, security |
grp:data_ai | Data engineering, data science, ML/AI |
grp:product | Product and project management |
grp:management | Engineering and project management |
grp:marketing | Marketing, content, community |
grp:sales | Sales and business development |
grp:operations | Operations, support, HR, finance |
grp:design | Design |
grp:research | Research |
The URL retains the group token so the interface can render one group chip.
Combining parameters
Different parameters intersect. Values within a list are alternatives except
when skills_match=all.
country and worldwide are mutually exclusive in the interface. If both are
written manually, worldwide mode wins because it asks for unrestricted remote
jobs rather than eligibility from one country.
An include and exclude for the same value are also prevented by the interface. Hand-written contradictory URLs can produce surprising results; avoid them.
Example:
https://www.remotera.ai/?country=US&roles=backend,ml_ai&seniority=senior&skills=React%7CTypeScript&skills_match=all&salary_min=120000&has_salary=true&xq=crypto&sort=salaryWhat sharing does not carry
A URL does not carry a session. As a result:
sort=relevancefalls back when the viewer has no scored profile;hide_vieweduses the viewer's own history;mindepends on the viewer's own match scores;- saved status, notes, and tags remain private.
The HTTP API uses different parameter names. See API and MCP before using a feed URL as an API request.
Sends the country and a representative UTC offset together, so roles restricted by timezone window match too.
Keeps remote roles with no country allowlist, no country exclusions and no timezone window. It overrides a country pick.
Pipe-separated, because a skill label can contain a comma. A skill matches a job's required skills, nice-to-haves or tech stack.
The live feed has no switch for this. It reaches the API whenever at least one skill is set, and only changes the result from two skills up.
Comma-separated. The search bar offers these levels once you start typing.
Comma-separated, matched as any-of: a job qualifies when it is any one of the types you pick.
Always USD per year in the URL. A job qualifies when the top of its range meets your floor.
The live feed has no switch for this. It keeps rows that disclose a minimum or a maximum.
Relevance is scored per viewer. Opened signed out, sort=relevance falls back to newest first.
Shareable URL
https://www.remotera.ai/What the feed then asks the API for
GET /api/jobs?sort=date/work-from-… page; the live eligibility picker lists every country.