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.
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, thecountryfacet 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
regionandcitynames 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.