v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Job Post Searchable Locations

List job post searchable locations

Searchable locations are the individual geographic locations attached to a job post — one row per location, each with a formatted display string plus its component city, region (state/province), postal code, county, country, and latitude/longitude. A single job post can have many searchable locations. Each location's id is the searchable-location identifier used by downstream job boards: for example, Indeed composes its multi-location job identifier as {job_post_id}_{id}, so this endpoint is the canonical source for mapping those identifiers back to a job post and its location. Filter with job_post_ids to retrieve the locations for specific job posts. Results are scoped to the authenticated organization and to the locations the API user is permitted to access.

get/v3/job_post_searchable_locations

Query parameters

cursorstring

Cursor link for pagination from previous page response header. Do not use any other parameters when using this.

per_pageinteger

Number of results per page

idsinteger[]

Comma separated list

gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
gtestring date-time
ltestring date-time
gtstring date-time
ltstring date-time
job_post_idsinteger[]

Return only the searchable locations attached to these job posts. Accepts a comma-separated list of job post ids (the job_post_id on each location); look them up via GET /v3/job_posts.

fieldsstring[]

Comma separated list of fields to return

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
job_post_idinteger nullable

Id of the job post this location belongs to. Use it with GET /v3/job_posts to look up the post, or as job_post_ids to filter this endpoint.

locationstring nullable

Human-readable display string for the full location, typically "City, Region, Country" (for example, "Chicago, IL, United States").

citystring nullable

City of the location.

region_short_namestring nullable

Abbreviated region (state or province) code, for example "IL".

region_long_namestring nullable

Full region (state or province) name, for example "Illinois".

postal_codestring nullable

Postal or ZIP code of the location.

countystring nullable

County (or equivalent administrative subdivision) of the location.

country_short_namestring nullable

Two-letter ISO 3166-1 alpha-2 country code, for example "US".

country_long_namestring nullable

Full country name, for example "United States".

latitudenumber nullable

Latitude of the location in decimal degrees.

longitudenumber nullable

Longitude of the location in decimal degrees.