Indexed jobs query format

Sponsor a job aggregated and indexed on Indeed.

 

legal notice

Unless you have a written agreement with Indeed regarding your use of Indeed's APIs, by using this API or its documentation, you agree to apply the Indeed API Terms and the Additional API Terms and Guidelines to your use of Indeed's APIs.

Indexed jobs are jobs that Indeed aggregates from third-party websites. You can use the Sponsored Jobs API to sponsor an indexed job.

To sponsor an indexed job:

1. Call POST /v1/campaigns/ to create a Sponsored Jobs campaign.
2. Set jobsToInclude to ALL to sponsor every job, or set it to QUERY to sponsor a subset.
3. Pass a manually created query string in jobsQuery when jobsToInclude is QUERY.

Use an indexed job query to pull a specific job, or a group of similar jobs, into a campaign.

Query components

Indexed job queries support unique identifiers, Boolean search operators, and Boolean search modifiers.

Unique identifiers

Identifier	Description
title	Sponsors similar jobs, by job title, if they are in similar locations. Examples: title:Lawyer title:("Administrative Assistant" OR Receptionist) To query for exact titles, use ttlcharlen (title character length) to limit the title to a set number of characters: title:"kitchen manager" ttlcharlen:15
location parameters	Specify one location at a time using one of these parameters: city — for example, city:Adelaide. country — for example, country:US. exactcountry — includes country-wide jobs only. Use -exactcountry to exclude them. zip — sponsor by US zip (postal) code if the feed includes it with the location. For example, zip:"01040". locflags:cityempty — includes jobs without a city, such as country- or state-wide jobs. To prevent country- or state-wide jobs from draining a campaign budget too quickly, include one of these queries in every campaign: -locflags:cityempty -locflags:("country" OR "region1" OR "region2") To sponsor country- or state-wide jobs, create a separate campaign for them. To sponsor only state-wide jobs when county-wide jobs also match, add locflags:region2empty to your query.
category	Comma-delimited list of job categories that help job seekers when searching. Use this field to manage jobs, let clients sponsor by category, or add information from the job details page (such as facility or department). Example: category:"Legal"
refnum	If you pass a unique alphanumeric value in the referencenumber element of the XML job feed, you can search for the job by that refnum. The unique identifier is also in the job's URL. When a refnum is available, use refnum instead of category.

Boolean search operators

Use these operators to combine the unique identifiers:

• AND
• OR

All search operators should be uppercase.

To exclude results from a search, use a minus sign -

Example

("Accounting Professional" -"Local Focal Point Italy") OR "Process Engineer"

Boolean search modifiers

Use these modifiers to filter the search for more specific results:

Enclose multiple-word phrases in quotes

Examples:

• city:Tampa
• city:"San Juan"

Lowercase the first letter for each query term

Correct example:

• city:Stamford

Incorrect example:

• City:Stamford

Uppercase US state and country abbreviations

Examples:

• US
• NY
• IE

Complex queries

Complex queries are defined as queries involving more than one boolean modifier paired with more than one unique identifier.

To sponsor two different job titles, which are each in different locations:

(title:xxxx AND city:xxxx) OR (title:xxxx AND city:xxxx)

To sponsor two jobs in one city and two jobs in another city:

(title:(xxxx OR xxxx) AND city:xxxx) OR (title:(xxxx OR xxxx) AND city:xxxx)

To sponsor two jobs that are open in two cities and two jobs that are open in two different cities:

(title:(xxxx OR xxxx) AND city:(xxxx OR xxx)) OR (title:(xxxx OR xxxx) AND city:(xxxx OR xxx))

To easily create complex queries, write each individual search string, then connect them with the appropriate number of ORs and parentheses:

(title:(accountant AND city:(stamford OR austin)) OR
title:("financial analyst" AND city:"san mateo") OR
title:(controller AND city:(toronto OR "new york")))

 

Was this page helpful?