API

Documentation

Version 1.0

Filtering

The AutoTechJobs API supports powerful filtering capabilities to help you narrow down results and find exactly what you're looking for. Filtering is available on most collection endpoints and allows you to specify criteria that returned resources must match.

Filter Parameters

Filters are applied using query parameters. Multiple filters can be combined to create complex queries.

GET /v1/jobs?location=london&salary_min=50000&posted_after=2025-01-01

Common Filter Parameters

Parameter	Description	Example
`location`	Filter by location (city or region)	`location=manchester`
`distance`	When used with location, specifies radius in miles	`distance=25`
`job_type`	Filter by job type	`job_type=full-time`
`salary_min`	Minimum salary	`salary_min=40000`
`salary_max`	Maximum salary	`salary_max=80000`
`posted_after`	Jobs posted after date (ISO 8601)	`posted_after=2025-01-01`
`posted_before`	Jobs posted before date (ISO 8601)	`posted_before=2025-03-31`
`skills`	Required skills (comma-separated)	`skills=diagnostics,electric`
`experience_level`	Required experience level	`experience_level=mid`

Operator Modifiers

You can use operator modifiers to create more complex filters. Append these to parameter names with an underscore.

Operator	Description	Example
`_gt`	Greater than	`experience_years_gt=5`
`_lt`	Less than	`experience_years_lt=10`
`_gte`	Greater than or equal to	`salary_gte=45000`
`_lte`	Less than or equal to	`salary_lte=75000`
`_not`	Not equal to	`job_type_not=part-time`
`_in`	In a list of values (comma-separated)	`location_in=london,manchester,birmingham`

Example Requests

Find full-time jobs in London with a salary range

GET /v1/jobs?location=london&job_type=full-time&salary_min=45000&salary_max=65000

Find jobs requiring specific skills posted in the last month

GET /v1/jobs?skills=electric,hybrid&posted_after=2025-03-01

Find employers with at least 5 open positions

GET /v1/employers?open_positions_gte=5

Filter Limitations

A maximum of 10 filters can be applied in a single request
Some filters may not be available on all endpoints
Text-based filters are case-insensitive
For location-based searches, the maximum distance is 100 miles

Response Format

When filters are applied, the response format remains the same as the standard endpoint response, but only matching resources are returned. The meta section of the response includes information about the applied filters.

{
  "data": [ ... ],  // Filtered results
  "meta": {
    "filters_applied": {
      "location": "london",
      "job_type": "full-time",
      "salary_min": 45000,
      "salary_max": 65000
    },
    "pagination": { ... }
  }
}

For more information on combining filtering with pagination, see the Pagination documentation.

To learn about sorting filtered results, see the Sorting documentation.