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.

Changes

No recorded changes to this endpoint across all 1 revision of this API.