GET https://xquik.com/api/v1/x/jobs/{id}
Read 1 public job listing on X with its full description. Pass a job ID or a job URL.
1 credit per call · All plans from $0.00012/credit
Find a job ID
Use job search to find listings by keyword. Each result carries itsid and its url on X.
The path also takes a job URL such as x.com/i/jobs/1899202395210649861. URL-encode it first. Anything else returns 400 invalid_job_id.Read the description
The listing returns its description in 2 forms.description is plain text with 1 line per paragraph. descriptionMarkdown keeps headings, lists, links, bold, and italics. It holds no HTML. It escapes characters that would read as Markdown, such as [ and *. It also escapes a - that starts a line.
Use the Markdown form to show the listing. Use the plain text for search indexes and classifiers.Handle a closed job
X removes a listing when the employer closes it. The lookup then returns404 job_not_found and costs nothing. Drop the job from your store, or mark it closed.Path parameters
Query parameters
Headers
Response
200 OK
X leaves out a field that a job lacks. Onlyid and url are always present.400 Invalid job ID
Send a job ID or a job URL, such asx.com/i/jobs/123.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.404 Job not found
The job closed or the ID is wrong. This answer is free.502 X API unavailable
The read service returned an error. Retry after a short delay.503 Service busy
X failed the job lookup, or Xquik is busy. Wait forRetry-After, then retry. The request costs nothing.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 to find more jobs. When the job has an
account, get the hiring account’s profile with the account.username.Response examples
- 400
{ "error": "invalid_job_id", "message": "Send a job ID or job URL, such as x.com/i/jobs/123." } - 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." } - 404
{ "error": "job_not_found", "message": "Job not found. Check the job ID or x.com/i/jobs URL." } - 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." }