The Search API allows you to programmatically search for jobs, employers, and candidates on the AutoTechJobs platform. It provides powerful filtering and sorting capabilities to help you find exactly what you're looking for.
Search for job listings with advanced filtering options.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search query (searches across title, description, and skills) |
| location | string | Filter by location (city, region, country, or "Remote") |
| category | string | Filter by job category (e.g., "software-engineering", "data-science") |
| type | string | Filter by job type (e.g., "full-time", "part-time", "contract") |
| experience | string | Filter by experience level (e.g., "entry", "mid", "senior") |
| salary_min | integer | Minimum salary (in GBP) |
| salary_max | integer | Maximum salary (in GBP) |
| skills | string | Comma-separated list of skills (e.g., "react,typescript,node") |
| company | string | Filter by company name |
| posted_after | string | Filter jobs posted after this date (ISO 8601 format) |
| remote | boolean | Filter for remote jobs only (true/false) |
| page | integer | Page number for pagination (default: 1) |
| limit | integer | Number of results per page (default: 20, max: 100) |
| sort | string | Sort by: relevance, date, salary (default: relevance) |
| order | string | Sort order: asc or desc (default: desc) |
curl -X GET "https://api.autotechjobs.co.uk/v1/search/jobs?q=react%20developer&location=london&type=full-time&skills=react,typescript&remote=true" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json"
{
"data": [
{
"id": "job_123456",
"title": "Senior React Developer",
"company": {
"id": "emp_123456",
"name": "Tech Innovations Ltd",
"logo_url": "https://example.com/logos/tech-innovations.png"
},
"location": "London, UK (Remote)",
"type": "full-time",
"category": "software-engineering",
"experience_level": "senior",
"salary": {
"min": 60000,
"max": 80000,
"currency": "GBP",
"period": "year"
},
"description": "We are looking for a Senior React Developer to join our team...",
"skills": ["React", "TypeScript", "JavaScript", "Redux", "Node.js"],
"is_remote": true,
"posted_at": "2025-04-01T10:00:00Z",
"expires_at": "2025-05-01T10:00:00Z",
"url": "https://api.autotechjobs.co.uk/v1/jobs/job_123456"
},
// More job listings...
],
"meta": {
"pagination": {
"total": 42,
"pages": 3,
"page": 1,
"limit": 20
},
"filters": {
"q": "react developer",
"location": "london",
"type": "full-time",
"skills": ["react", "typescript"],
"remote": true
}
}
}Search for companies with advanced filtering options.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search query (searches across company name and description) |
| location | string | Filter by company location |
| industry | string | Filter by industry |
| size | string | Filter by company size (e.g., "1-10", "11-50", "51-200", "201-500", "501+") |
| has_jobs | boolean | Filter for companies with active job listings (true/false) |
| page | integer | Page number for pagination (default: 1) |
| limit | integer | Number of results per page (default: 20, max: 100) |
curl -X GET "https://api.autotechjobs.co.uk/v1/search/companies?q=tech&industry=Information%20Technology&has_jobs=true" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json"
{
"data": [
{
"id": "emp_123456",
"name": "Tech Innovations Ltd",
"logo_url": "https://example.com/logos/tech-innovations.png",
"description": "A leading technology company specializing in...",
"website": "https://techinnovations.example.com",
"industry": "Information Technology",
"size": "51-200",
"location": "London, UK",
"founded_year": 2015,
"active_jobs_count": 5,
"url": "https://api.autotechjobs.co.uk/v1/companies/emp_123456"
},
// More companies...
],
"meta": {
"pagination": {
"total": 28,
"pages": 2,
"page": 1,
"limit": 20
},
"filters": {
"q": "tech",
"industry": "Information Technology",
"has_jobs": true
}
}
}Get autocomplete suggestions for search queries, locations, skills, and companies.
| Parameter | Type | Description |
|---|---|---|
| q | string | Partial search query to get suggestions for |
| type | string | Type of suggestions: query, location, skill, company (default: query) |
| limit | integer | Number of suggestions to return (default: 5, max: 10) |
curl -X GET "https://api.autotechjobs.co.uk/v1/search/autocomplete?q=react&type=skill" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json"
{
"data": [
"React",
"React Native",
"React Router",
"React Redux",
"React Testing Library"
]
}q parameter for general searches across multiple fields.location parameter and the remote parameter to include remote opportunities.