REMOTERADOCS
Reference

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

ParameterValueExample
qSearch text?q=platform+engineer
companyOne public company id?company=<id>
arrangementremote, hybrid, onsite?arrangement=remote
countryISO two-letter working country?country=TH
worldwideBoolean?worldwide=true
hide_viewedBoolean; signed-in only?hide_viewed=true
minMinimum profile match, 0–100; signed-in only?min=70
sortdate, relevance, salary?sort=salary
rolesComma-separated role or group tokens?roles=backend,ml_ai
seniorityComma-separated levels?seniority=senior,staff
employmentComma-separated types?employment=contract
entryBoolean: no experience required?entry=true
c2cBoolean: C2C stated?c2c=true
industryOne industry value?industry=fintech
company_sizestartup, mid, enterprise list?company_size=startup
skillsPipe-separated skill labels?skills=React%7CTypeScript
skills_matchany or all?skills_match=all
languagesComma-separated ISO language codes?languages=en,de
salary_minAnnual USD minimum?salary_min=120000
salary_maxAnnual USD maximum?salary_max=200000
has_salaryBoolean?has_salary=true
xqPipe-separated excluded text?xq=crypto%7Cgambling
xrolesComma-separated excluded roles?xroles=sales
xseniorityComma-separated excluded levels?xseniority=junior
xindustryPipe-separated excluded industries?xindustry=gambling
xskillsPipe-separated excluded skills?xskills=PHP
xcompanyComma-separated excluded company ids?xcompany=<id>
xcompanynamePipe-separated excluded company names?xcompanyname=Acme
xarrangementComma-separated excluded arrangements?xarrangement=onsite
orderDisplay order for filter chips; does not filterWritten 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, other

Group tokens:

TokenIncludes
grp:engineeringFrontend, backend, full-stack, mobile, QA, DevOps, SRE, data engineering, ML/AI, blockchain, security
grp:data_aiData engineering, data science, ML/AI
grp:productProduct and project management
grp:managementEngineering and project management
grp:marketingMarketing, content, community
grp:salesSales and business development
grp:operationsOperations, support, HR, finance
grp:designDesign
grp:researchResearch

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

What sharing does not carry

A URL does not carry a session. As a result:

  • sort=relevance falls back when the viewer has no scored profile;
  • hide_viewed uses the viewer's own history;
  • min depends 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.

Try itPick a few filters and watch the shareable link build.

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.

URL only

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.

URL only

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
Open in Remotera
A parameter shows up only once it is off its default, so the bare address is the default feed. Country choices here are the ones with a /work-from-… page; the live eligibility picker lists every country.

On this page