X job locations API: find places & location IDs

{
  "locations": [
    {
      "id": "1720462281849397612",
      "name": "New York, US"
    }
  ],
  "count": 2
}

{
  "error": "missing_query",
  "message": "Search query required. Use q."
}

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

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

{
  "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

locations

X job locations API: find places & location IDs

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

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/jobs/locations"

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

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

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

	fmt.Println(string(body))

}

{
  "locations": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "count": 123
}

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

curl "https://xquik.com/api/v1/x/jobs/locations?q=new%20york&limit=5" \
  -H "x-api-key: xq_your_api_key_here" | jq

const params = new URLSearchParams({ q: "new york", limit: "5" });
const response = await fetch(`https://xquik.com/api/v1/x/jobs/locations?${params}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const { locations } = await response.json();
const firstLocationId = locations[0]?.id ?? null;

import requests

response = requests.get(
    "https://xquik.com/api/v1/x/jobs/locations",
    params={"q": "new york", "limit": 5},
    headers={"x-api-key": "xq_your_api_key_here"},
)
locations = response.json()["locations"]
first_location_id = locations[0]["id"] if locations else None

Search jobs in an exact place

A free-text location 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 id to job search as locationId.

Store the ID with the place name. The same ID works in later searches.

Control the cost

Each returned place costs 1 credit. A broad name such as york can match many places. Send limit to keep only the best matches. No match returns an empty list and costs nothing.

Query parameters

string

required

Place name or its start, such as new york. Alias: query.

integer

Most places to return. Without it, every match returns. Aliases: pageSize, count, max_results, maxItems, max_items & per_page.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object[]

Matching places, best match first. Location object fields.

string

Location ID, which the job search locationId takes.

string

Place name with its region or country code.

number

Places returned, each charged 1 credit.

{
  "locations": [
    { "id": "1720462281849397612", "name": "New York, US" },
    { "id": "1720462281920696805", "name": "New York City, NY" }
  ],
  "count": 2
}

400 Missing query

{ "error": "missing_query" }

Send a place name in q.

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.

502 X API unavailable

{ "error": "x_api_unavailable" }

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

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 with the location ID, or get 1 job listing for its full description.

{
  "locations": [
    {
      "id": "1720462281849397612",
      "name": "New York, US"
    }
  ],
  "count": 2
}

{
  "error": "missing_query",
  "message": "Search query required. Use q."
}

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

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

{
  "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 locations API: find places & location IDs

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

package main

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

func main() {

	url := "https://xquik.com/api/v1/x/jobs/locations"

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

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

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

	fmt.Println(string(body))

}

{
  "locations": [
    {
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "count": 123
}

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 locations API: find places & location IDs

Search jobs in an exact place

Control the cost

Query parameters

Headers

Response

200 OK

400 Missing query

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed

​Search jobs in an exact place

​Control the cost

​Query parameters

​Headers

​Response

​200 OK

​400 Missing query

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​429 Rate limit exceeded

​424 Dependency failed

Search jobs in an exact place

Control the cost

Query parameters

Headers

Response

200 OK

400 Missing query

401 Unauthenticated

402 Payment required

502 X API unavailable

429 Rate limit exceeded

424 Dependency failed