Search jobs (POST, recommended)
Search jobs using natural language via JSON request body (recommended). Results are sorted by publish_time descending, then by relevance score.
Authorization
apiKeyAuth x-api-key<token>
API key authentication. Pass the key via the x-api-key header.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://ufdqwbefaj.execute-api.us-east-1.amazonaws.com/v1/search" \ -H "Content-Type: application/json" \ -d '{ "q": "Python backend developer in New York", "city": "New York", "country": "US", "since": "2025-01-01", "top_k": 10, "detail": "summary" }'{
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"total": 3,
"search_time_ms": 234,
"results": [
{
"score": 0.92,
"job_title": "Senior Python Backend Developer",
"city": "New York",
"company_name": "Acme Corp",
"publish_time": "2025-03-15 10:30:00",
"base_salary": "125000.0-160000.0 USD/YEAR",
"job_url": "https://example.com/jobs/12345",
"job_tags": [
"python",
"backend",
"senior"
],
"data_source": "linkedin",
"seniority_level": "Mid-Senior level",
"employment_type": "Full-time"
},
{
"score": 0.85,
"job_title": "Python Software Engineer",
"city": "New York",
"company_name": "Tech Inc",
"publish_time": "2025-03-10 08:00:00",
"base_salary": "90000.0-120000.0 USD/YEAR",
"job_url": "https://example.com/jobs/12346",
"job_tags": [
"python",
"software-engineer"
],
"data_source": "indeed"
}
]
}{
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"error": "q is required",
"error_code": "MISSING_QUERY"
}{
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"error": "Invalid API key",
"error_code": "AUTH_INVALID_KEY"
}{
"error": "Rate limit exceeded",
"retry_after": 12
}{
"request_id": "550e8400-e29b-41d4-a716-446655440000",
"error": "Internal server error",
"error_code": "INTERNAL_ERROR"
}