Job Listings

Returns the current full details and candidate apply URL for one live ApplyGateway job. Use this tool when the user asks for more information about a job previously returned by the job search tools.

get_job

Returns live jobs from the ApplyGateway network that are similar to a specified ApplyGateway job. Use this tool when the user asks for similar jobs, alternatives, or more vacancies like a previously returned ApplyGateway job. The source job is looked up by id, then its primary occupation is used for matching. If it has no occupation, its title is used. The search uses the source job's country and, when available, its coordinates. The source job itself is excluded.

get_similar_jobs

Returns authoritative place-name and postcode suggestions from ApplyGateway location records. Use this to disambiguate locationText before searching jobs.

lookup_locations

Searches live job adverts available through the ApplyGateway network and returns matching vacancies with their location, salary, contract type and apply link. Use this tool when the user wants to search this job catalogue for vacancies. Keywords match the job TITLE only, never the description. Use short role terms ("registered nurse", "hgv driver"), not sentences. Supply locationText for a place name or full postcode, optionally qualifying a town with a county or state after a comma. It is resolved from ApplyGateway location records. Unknown or ambiguous locations return an error. Alternatively supply coordinates. Results are ranked by relevance. Omit a filter to leave it unapplied rather than passing false, which would exclude every job that does not carry that exact flag. If more matching results are requested, use pageNumber to retrieve subsequent pages.

search_jobs

Searches live jobs for an ApplyGateway buyer id or an advertiser/company name. At least one must be supplied. Use this tool when the user wants to find vacancies associated with a specific employer, advertiser, recruitment agency, buyer, or buyer account. A named company is conservatively resolved against ApplyGateway buyer records first. A confident match searches that buyer and its descendants; an ambiguous or absent match remains an exact advert-company search. A buyer-id search automatically includes every descendant buyer in BuyerSubBuyers. Location is optional. Omit country and coordinates for a worldwide search.

search_jobs_by_company