GET https://xquik.com/api/v1/x/jobs/search
Search the public job listings on X by keyword. Narrow them by location, work type, seniority, employment type, or company.
Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page, Xquik returns fewer results. If zero paid results are affordable, it returns
402 insufficient_credits.1 credit per job returned · All plans from $0.00012/credit
Narrow a job search
Start with a keyword inq, such as a job title or a skill. Add 1 filter at a time and check the results after each change.locationtakes a city, region, or country as text.locationIdtakes an exact place from job locations.locationTypekeeps onsite, remote, or hybrid jobs.senioritykeeps levels from intern to executive.employmentTypekeeps full-time, part-time, or contract jobs.companykeeps the jobs of 1 employer.
Full Time, full-time, and full_time all work.
An unknown value returns 400 invalid_job_filter. Its message names the values the filter takes.Page through job listings
Each page returnshas_next_page and next_cursor. Send next_cursor back as cursor with the same query and filters. Stop when has_next_page is false.
A cursor X refuses or that expired returns 400 invalid_cursor, which is free. Start again without cursor, then use next_cursor.
A job that closed is left out of the page and costs nothing. A page can therefore hold fewer jobs than pageSize.
Use the job id as the key in your store. Overlapping searches then add no duplicates.Get the full description
Search returns the listing summary. Send a job’sid to get 1 job listing. That listing adds the full description, work type, seniority, and team.Query parameters
Choose fields
Headers
Response
200 OK
X leaves out a field that a job lacks. Onlyid and url are always present.400 Missing query, unknown filter, or invalid cursor
A request withoutq returns missing_query. A cursor X cannot read returns invalid_cursor.
{ "error": "invalid_cursor", "message": "Cursor invalid or expired. Start again without cursor, then use next_cursor." }
Start again without cursor. All 3 answers are free.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. Get 1 job listing for the full description. Search users to find the hiring accounts.
Response examples
- 400
{ "error": "invalid_job_filter", "message": "Unknown locationType \"moon\". Use onsite, remote or hybrid." } - 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." }