Importing Jobs from API’s
Jobs can be imported from regular RSS feeds or using providers API’s, if you have a Professional plan.
Before reading this article please make sure you’ve read the support article for manually Importing jobs in advanced mode and to learn how to switch between basic/advanced modes.
Importing jobs from API’s is very much the same as importing jobs using regular RSS feeds but API’s offer more granular control over the jobs being imported. You’ll need a publisher ID or API key for each of the providers you intend to use. Please continue reading for more details.
Setup the Provider API
If you have the Professional plan you’ll find all the available API providers under the plugin Settings page. Each provider has its own sub-settings page. For this article we’ll use Indeed but you can use the same steps for other providers.
All API providers will ask for a publisher ID/key. You’ll find a link for the provider page containing details on how to get them.
After you have a publisher ID/key you’ll need to paste it on the respective field.
To start pulling jobs from the API this is all you need. All other settings are optional, and will vary between providers.
Other API Settings
If you are not familiar with other options provided by the API, its suggested to leave them with their default values. Otherwise, you can tweak them as you like. Make sure you read the respective descriptions and tips.
Importantly, any change that you do on these settings will be applied for ALL jobs imported for the provider.
As an example, Indeed has settings like ‘Country Code‘ and ‘Radius‘ which have the default values, ‘25‘ and ‘us‘, respectively:
These values will be applied to ALL imported jobs, meaning that the API will only return jobs from US within 25 km/miles from the location you set. If you need to pull jobs from other locations you’ll need to add your two letter country code.
Most of the settings are also available during the import but they will only apply to each single import, and not to ALL imported jobs. You’ll find descriptions and tips for each setting explaining their functionality.
Import Jobs from API
After setting up the API provider settings you want to use, you are ready to start importing jobs from that source.
Head over to the Import Jobs page and select the provider API from the list of pre-set providers. You can search for API’s if you start typing ‘API’.
At this point you’ll notice why API’s provide more control over imported jobs. The feed builder will show several new fields that allow you to further control the jobs being imported.
The fields available will vary between provider API’s. You’ll find tips on each field with additional information on their functionality. The most important field is ‘Keyword’ since it’s here that you’ll add your comma separated list of keywords that will target your customer base.
All the fields are usually optional but some API’s will require the keyword to be filled. It’s recommended to use only a couple of keywords, otherwise you might get no results. You can test the results by copying&pasting the resulting link and clicking Load. If you don’t get any results try removing keywords or using others.
For this example, I’ve filled the keyword with doctor and the location with new york. After clicking Load you’ll be able to see the number of results found.
At this point you can also map each of the fields provided by the API to any custom fields you use. You can leave the defaults mappings if you don’t know what each custom field means.
Specific API Import Settings
As mentioned before, each provider will have its own settings and feed builder fields, so, its is suggested that you carefully look at each if them to make sure they have the correct values to pull the jobs you want to target.
For Indeed, in particular, notice the ‘Country Code‘ field. By default its set to ‘us‘. This means that even if you set the location to ‘london‘ it will look for jobs in the US and not the UK. You would need to set the ‘Country Code‘ to ‘gb‘ to pull jobs from London, UK.
Thats only one example, so, please make sure you are aware of all the options available and their goal.
Other Import Settings
All other import settings are exactly the same as with regular RSS feeds. You can start importing jobs from the API right away by leaving their defaults or, if you need assistance configure the other settings, please read the related article.