GET https://xquik.com/api/v1/x/jobs/locations
Find the places X job search knows by name. Pass a place name or its start, such as new york. Each match returns its name and the location ID that job search takes.
1 credit per place returned · All plans from $0.00012/credit
Search jobs in an exact place
A free-textlocation works for most searches. A location ID pins 1 exact place instead. New York City, NY and West New York, NJ then stay apart.- Look up the place name here.
- Pick the matching place from
locations. - Send its
idto job search aslocationId.
Control the cost
Each returned place costs 1 credit. A broad name such asyork can match many places. Send limit to keep only the best matches. No match returns an empty list and costs nothing.Query parameters
Choose fields
Headers
Response
200 OK
400 Missing query
Send a place name inq.401 Unauthenticated
Anonymous requests getWWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.402 Payment required
Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.502 X API unavailable
The read service returned an error. Retry after a short delay.429 Rate limit exceeded
You exceeded your tier rate limit. Wait for theRetry-After header before retrying.424 Dependency failed
The normalized v1 response contract can return 424 when the read service is unavailable.Next steps. Search job listings with the location ID. Get 1 job listing for its full description.
Response examples
- 400
{ "error": "missing_query", "message": "Search query required. Use q." } - 401
{ "error": "unauthenticated", "message": "Authentication required." } - 402
{ "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." } - 403
{ "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." } - 424
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 429
{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 } - 502
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 503
{ "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }