Apple Jobs location discovery
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.
Request
- Base URL: https://api.crawlora.net/api/v1
- URL: https://api.crawlora.net/api/v1/apple-jobs/locations
- Auth: API key in header x-api-key
Query parameters
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).
Headers
API key required
Response
OK
Example response
{
"code": 200,
"data": {
"count": 206,
"locations": [
{
"code": "USA",
"level": "country",
"location": "united-states-USA",
"name": "United States"
}
],
"query": "singapore",
"scope": "country"
},
"msg": "OK"
}Changes
No recorded changes to this operation across all 2 revisions of this API.