X job listing API for descriptions & salary data

{
  "job": {
    "id": "1899202395210649861",
    "title": "Engineer",
    "url": "https://x.com/i/jobs/1899202395210649861",
    "applyUrl": "https://xquik.com/example",
    "location": "United States"
  }
}

{
  "error": "invalid_job_id",
  "message": "Send a job ID or job URL, such as x.com/i/jobs/123."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "job_not_found",
  "message": "Job not found. Check the job ID or x.com/i/jobs URL."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

jobs

{id}

X job listing API for descriptions & salary data

curl --request GET \
  --url https://xquik.com/api/v1/x/jobs/{id}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/jobs/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "job": {
    "id": "<string>",
    "title": "<string>",
    "url": "<string>",
    "applyUrl": "<string>",
    "location": "<string>",
    "locationType": "<string>",
    "employmentType": "<string>",
    "seniorityLevel": "<string>",
    "jobFunction": "<string>",
    "team": "<string>",
    "postedAt": "<string>",
    "formattedSalary": "<string>",
    "salaryMin": 123,
    "salaryMax": 123,
    "salaryCurrencyCode": "<string>",
    "salaryInterval": "<string>",
    "featured": true,
    "shortDescription": "<string>",
    "description": "<string>",
    "descriptionMarkdown": "<string>",
    "company": {},
    "account": {}
  }
}

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

curl https://xquik.com/api/v1/x/jobs/1899202395210649861 \
  -H "x-api-key: xq_your_api_key_here" | jq

const jobId = "1899202395210649861";
const response = await fetch(`https://xquik.com/api/v1/x/jobs/${jobId}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const { job } = await response.json();
const jobRecord = {
  job_id: job.id,
  title: job.title ?? null,
  job_url: job.url,
  apply_url: job.applyUrl ?? null,
  location: job.location ?? null,
  location_type: job.locationType ?? null,
  employment_type: job.employmentType ?? null,
  seniority_level: job.seniorityLevel ?? null,
  salary: job.formattedSalary ?? null,
  employer: job.company?.name ?? job.account?.name ?? null,
  description: job.description ?? null,
};

process.stdout.write(JSON.stringify(jobRecord, null, 2));

import json
import requests

job_id = "1899202395210649861"
response = requests.get(
    f"https://xquik.com/api/v1/x/jobs/{job_id}",
    headers={"x-api-key": "xq_your_api_key_here"},
)
job = response.json()["job"]
job_record = {
    "job_id": job["id"],
    "title": job.get("title"),
    "job_url": job["url"],
    "apply_url": job.get("applyUrl"),
    "location": job.get("location"),
    "location_type": job.get("locationType"),
    "employment_type": job.get("employmentType"),
    "seniority_level": job.get("seniorityLevel"),
    "salary": job.get("formattedSalary"),
    "employer": (job.get("company") or job.get("account") or {}).get("name"),
    "description": job.get("description"),
}

print(json.dumps(job_record, indent=2))

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, and it escapes characters that would read as Markdown, such as [, * and 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

string

required

Job ID, or URL-encoded job URL such as x.com/i/jobs/1899202395210649861.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

X leaves out a field that a job lacks. Only id and url are always present.

object

The job listing. Job object fields.

string

Job ID.

string

Job title.

string

The job page on X.

string

Where applicants apply, off X.

string

Location as the employer wrote it.

string

Where the work happens: onsite, remote, or hybrid.

string

Contract type: full_time, full_time_contract, part_time, or contract_to_hire.

string

Seniority, from intern to executive.

string

Job function, such as software_engineering.

string

Team inside the company.

string

When the employer posted the job, in ISO 8601.

string

Salary as X shows it, such as Starting at $225K.

number

Lowest salary, in salaryCurrencyCode per salaryInterval.

number

Highest salary, in salaryCurrencyCode per salaryInterval.

string

ISO 4217 currency code of the salary.

string

Pay period of the salary: annually or hourly.

boolean

Whether X features the job.

string

Short summary of the job, as plain text.

string

Full description as plain text, 1 line per paragraph.

string

Full description as Markdown, with headings, lists, links, bold, and italics.

object

Company profile with id, name, and logoUrl. Present on jobs X imported from a job board.

object

The X account that posted the job, with id, username, name, verified, verifiedType, description, profilePicture, and profileImageShape. A job has none when X imported it from a job board or no longer shows the account.

{
  "job": {
    "id": "1899202395210649861",
    "title": "Engineer",
    "url": "https://x.com/i/jobs/1899202395210649861",
    "applyUrl": "https://xquik.com/example",
    "location": "United States",
    "locationType": "remote",
    "employmentType": "full_time",
    "seniorityLevel": "lead",
    "jobFunction": "software_engineering",
    "formattedSalary": "Starting at $225K",
    "salaryMin": 225000,
    "salaryCurrencyCode": "USD",
    "salaryInterval": "annually",
    "featured": true,
    "shortDescription": "Commonware is hiring founding engineers.",
    "description": "What is Commonware? We build open primitives.",
    "descriptionMarkdown": "# What is Commonware?",
    "account": {
      "id": "1812126202804711425",
      "username": "commonwarexyz",
      "name": "commonware",
      "verified": true,
      "verifiedType": "Business"
    }
  }
}

400 Invalid job ID

{ "error": "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.

{ "error": "unauthenticated" }

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

{ "error": "job_not_found" }

The job closed or the ID is wrong. This answer is free.

502 X API unavailable

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

503 Service busy

{ "error": "x_api_unavailable" }

X failed the job lookup, or Xquik is busy. Wait for Retry-After, then retry. The request costs nothing.

429 Rate limit exceeded

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

Next steps. Search job listings to find more jobs, or get the hiring account’s profile with the account.username, when the job has an account.

{
  "job": {
    "id": "1899202395210649861",
    "title": "Engineer",
    "url": "https://x.com/i/jobs/1899202395210649861",
    "applyUrl": "https://xquik.com/example",
    "location": "United States"
  }
}

{
  "error": "invalid_job_id",
  "message": "Send a job ID or job URL, such as x.com/i/jobs/123."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "job_not_found",
  "message": "Job not found. Check the job ID or x.com/i/jobs URL."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

X job listing API for descriptions & salary data

curl --request GET \
  --url https://xquik.com/api/v1/x/jobs/{id}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/jobs/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "job": {
    "id": "<string>",
    "title": "<string>",
    "url": "<string>",
    "applyUrl": "<string>",
    "location": "<string>",
    "locationType": "<string>",
    "employmentType": "<string>",
    "seniorityLevel": "<string>",
    "jobFunction": "<string>",
    "team": "<string>",
    "postedAt": "<string>",
    "formattedSalary": "<string>",
    "salaryMin": 123,
    "salaryMax": 123,
    "salaryCurrencyCode": "<string>",
    "salaryInterval": "<string>",
    "featured": true,
    "shortDescription": "<string>",
    "description": "<string>",
    "descriptionMarkdown": "<string>",
    "company": {},
    "account": {}
  }
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

X job listing API for descriptions & salary data

Find a job ID

Read the description

Handle a closed job

Path parameters

Headers

Response

200 OK

400 Invalid job ID

401 Unauthenticated

402 Payment required

404 Job not found

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

​Find a job ID

​Read the description

​Handle a closed job

​Path parameters

​Headers

​Response

​200 OK

​400 Invalid job ID

​401 Unauthenticated

​402 Payment required

​404 Job not found

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

Find a job ID

Read the description

Handle a closed job

Path parameters

Headers

Response

200 OK

400 Invalid job ID

401 Unauthenticated

402 Payment required

404 Job not found

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed