Endpoint Playground

Try the Apple Jobs location discovery API

Discovery endpoint for apple-jobs-search's `location` parameter, whose accepted values are a closed set Apple itself defines (its own `<slug>-<CODE>` location ids -- free-text location names are rejected). Apple exposes no bulk "list everything" option for this; the only lookup is a fuzzy search capped at 10 results per call covering four granularities (country, state/province, metro area, city) with no empty-input listing mode. With no `q`, this returns the full country-level value space (206 values, live-verified) as a static list -- the granularity apple-jobs-search's own examples use and nearly every caller needs. With `q` supplied, this instead looks up Apple's own location filter live so callers can discover state/metro/city-level values for finer filtering; results at those deeper levels may include more than one candidate and are ranked by Apple's own relevance, not alphabetically.

What a live request returned

14 Oct 2026: 206 locations; 4 fields had a value in every checked item.

Observed request: GET /apple-jobs/locations
Fields with a value in every checked item: location, name, code, level

Sample value profiles: location: “afghanistan-AFG” and 205 other values; name: “Afghanistan” and 205 other values.

Request: GET /apple-jobs/locations
Cost: 1 credit/request
Auth: apiKey

Apple Jobs location discovery API documentation Apple Jobs platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/apple-jobs/locations' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
q	string	No		Optional free-text location search. Omit to get the full country-level list; supply to live-search state/metro/city-level values too (e.g. a city name).

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "scope": "country",
    "count": 206,
    "locations": [
      {
        "location": "singapore-SGP",
        "name": "Singapore",
        "code": "SGP",
        "level": "country"
      },
      {
        "location": "united-states-USA",
        "name": "United States",
        "code": "USA",
        "level": "country"
      }
    ],
    "source_url": "https://jobs.apple.com/api/v1/refData/postlocation",
    "fetched_at": "2026-09-16T12:00:00Z"
  }
}

More Apple Jobs endpoints

Apple Jobs single posting Apple Jobs search

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestapplejobs.locationsResponseDocApple Jobs

GET /apple-jobs/locations

Apple Jobs location discovery

Response behavior

- `scope` is `country` for the default (no-`q`) response, or `search` when `q` was supplied. - Each `locations[].location` value is exactly what `apple-jobs-search`'s `location` parameter expects. - `locations[].level` is one of `country`, `state`, `metro`, `city`, or `other` (an unrecognized upstream level, included rather than silently dropped). - Not every UN member state appears in the country list — Apple's own location taxonomy omits countries where it has no careers presence (e.g. Cuba, Iran, North Korea returned no match during live verification). The 206 values here are exactly what Apple's own reference data returns, not a general country-code list. - A `q` result's `location` slug is computed the same way Apple's own frontend computes it (lowercase, non-alphanumeric runs collapsed to a single hyphen, trimmed) and has been verified correct for every case checked, including multi-word/parenthetical country names and city-level results. A city/metro/state name containing non-ASCII characters is the one case this cannot guarantee byte-for-byte, since Apple's own JS may normalize diacritics differently — treat those specific results as best-effort. Example response (`q` omitted): ```json { "code": 200, "msg": "OK", "data": { "scope": "country", "count": 206, "locations": [ {"location": "singapore-SGP", "name": "Singapore", "code": "SGP", "level": "country"}, {"location": "united-states-USA", "name": "United States", "code": "USA", "level": "country"} ], "source_url": "https://jobs.apple.com/api/v1/refData/postlocation", "fetched_at": "2026-09-16T12:00:00Z" } } ``` Example response (`q=cupertino`): ```json { "code": 200, "msg": "OK", "data": { "query": "cupertino", "scope": "search", "count": 2, "locations": [ {"location": "cupertino-california-united-states-CUP", "name": "Cupertino, California, United States", "code": "CUP", "level": "city"}, {"location": "santa-clara-valley-cupertino-california-united-states-SCV", "name": "Santa Clara Valley (Cupertino), California, United States", "code": "SCV", "level": "city"} ], "source_url": "https://jobs.apple.com/api/v1/refData/postlocation?input=cupertino", "fetched_at": "2026-09-16T12:00:00Z" } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "scope": "country",
    "count": 206,
    "locations": [
      {
        "location": "singapore-SGP",
        "name": "Singapore",
        "code": "SGP",
        "level": "country"
      },
      {
        "location": "united-states-USA",
        "name": "United States",
        "code": "USA",
        "level": "country"
      }
    ],
    "source_url": "https://jobs.apple.com/api/v1/refData/postlocation",
    "fetched_at": "2026-09-16T12:00:00Z"
  }
}

Try the Apple Jobs location discovery API

What a live request returned

14 Oct 2026: 206 locations; 4 fields had a value in every checked item.

Observed request: GET /apple-jobs/locations
Fields with a value in every checked item: location, name, code, level

Sample value profiles: location: “afghanistan-AFG” and 205 other values; name: “Afghanistan” and 205 other values.

Request: GET /apple-jobs/locations
Cost: 1 credit/request
Auth: apiKey

Apple Jobs location discovery API documentation Apple Jobs platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/apple-jobs/locations' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
q	string	No		Optional free-text location search. Omit to get the full country-level list; supply to live-search state/metro/city-level values too (e.g. a city name).

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "scope": "country",
    "count": 206,
    "locations": [
      {
        "location": "singapore-SGP",
        "name": "Singapore",
        "code": "SGP",
        "level": "country"
      },
      {
        "location": "united-states-USA",
        "name": "United States",
        "code": "USA",
        "level": "country"
      }
    ],
    "source_url": "https://jobs.apple.com/api/v1/refData/postlocation",
    "fetched_at": "2026-09-16T12:00:00Z"
  }
}

Apple Jobs location discovery

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "scope": "country", "count": 206, "locations": [ { "location": "singapore-SGP", "name": "Singapore", "code": "SGP", "level": "country" }, { "location": "united-states-USA", "name": "United States", "code": "USA", "level": "country" } ], "source_url": "https://jobs.apple.com/api/v1/refData/postlocation", "fetched_at": "2026-09-16T12:00:00Z" } }