Skip to main content
GET /v1/facets takes the same filters as GET /v1/jobs. For each filter marked “Facet” in the filter table, it returns the most common values among the matching open jobs, with a count.
The example is shortened; a real answer has every facet.

How counts work

  • Each facet lists up to 50 values, most jobs first.
  • A facet ignores its own filter and applies all the others. With country=US, the country facet still lists other countries, so you can show “what if” counts in a filter menu.
  • A job in several places counts under each of its countries, regions and cities. So a facet’s counts can add up to more than the number of jobs.
  • Jobs with no value for a facet (no pay, unknown city) are not counted in it.
  • Values come from the jobs. A new value appears as soon as a job has it.

Uses

  • Fill filter menus with the values that have jobs.
  • See how many jobs a search would return before you page through it.
  • Find the exact region and city names to filter on.

Count

GET /v1/count takes the same filters and returns how many open jobs match, for free. Use it to size a plan before you pull jobs.