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 Professional or Business 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 AdZuna but you can use the same steps for other providers.
API providers usually require a publisher ID/key or some sort of unique account identifier. You’ll find a link for the provider page containing details on how to get them.
AdZuna, in particular, provides an Application ID and Application Key. Just paste them 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.
Any change that you do on these settings will be applied for ALL jobs imported for the provider.
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’ or just type the provider you’re looking for (e.g: ‘adzuna’).
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 developer and the location with London. 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.
One thing to note is that most API providers allow changing the Country origin for the jobs being searched. You can set a default Country on the provider Settings page, and override it during imports, to create import templates for different countries.
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.