Skip to main content
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 its id 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 returns 404 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. Only id and url are always present.

400 Invalid job ID

Send a job ID or a job URL, such as x.com/i/jobs/123.

401 Unauthenticated

Anonymous requests get WWW-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 for Retry-After, then retry. The request costs nothing.

429 Rate limit exceeded

You exceeded your tier rate limit. Wait for the Retry-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." }