Facebook for Jobs API

of one

Facebook for Jobs API

Setting up and integrating Facebook Jobs API loosely involves a six step-by-step process from generating the XML feed to getting the jobs live on Facebook and matched to a business account. After integrating with the API, developers/businesses can initiate other API functionalities such as getting the application details of an applicant, deleting job feeds, and so on. Lastly, some benefits of this API include the ability to post job openings to various channels on Facebook, get diverse and qualified candidates, and to get extra traffic from diverse fans.

Setting Up Facebook Jobs API

#1: Generating XML Feed

  • Generating an XML feed according to Facebook's specifications is the first step towards integrating with Facebook through the API. The XML feed functions to properly ingest jobs.
  • The XML (Extensible Markup Language) feed is a text-based markup language that allows developers to define the display and functionality of job posts, according to Facebook's specifications.
  • The XML feed contains default fields, required fields, and other fields that should be defined as the developer wants. The required fields define parameters or variables such as the publisher, address, job title, job description, and others. The default fields define variables that are not required but will default to a value. An example is the job type which defaults to "full-time" if not set.
  • When these are properly defined, the generated values will constitute the display and functionality of job posts when they are live eventually.

#2: Obtaining Job API Permission

  • After creating the XML feed, the next step is to obtain the necessary permissions from Facebook to proceed with the integration. To achieve this, developers must contact Facebook through their Facebook contacts.
  • If granted, this Job API has a 30-day usage policy, beyond which they'd be revoked if not used.
  • Without permission or when revoked, further usage of the API will result in error messages about lacking the required permissions. Hence, this is why generating XML feed comes first so that "developers can be ready to quickly complete registration once permissions are granted."

#3: Registering Recruiting Manager

  • Once all the necessary Jobs API permissions have been obtained from Facebook, developers can start to distribute their job posts on Facebook according to the XML feeds through a registered recruiting manager and job feed.
  • The recruiting manager manages jobs and "configures company properties such as your ATS name, website URL, and data policy URL." It represents the organization while the job feed represents the XML feed.
  • Note that developers must obtain a User Access Token for recruiting manager from the Graph API Explorer tool that will allow them to create the recruiting manager by configuring the necessary company properties as mentioned above.
  • Once the recruiting manager has been configured and created, "developers must notify Facebook by submitting an answer to the 'Register Recruiting Manager' question in the Direct Support Tool," else, their jobs won't be distributed.
  • "Note that developers can only register one recruiting manager with Facebook, although they can have an indefinite number of jobs or feeds associated with that recruiting manager."

#4: Registering Job Feeds

  • Next, is to register the XML/job feed so that Facebook can crawl the feed to post and distribute jobs on the jobs section.
  • With a limit of 100 feeds, each feed can contain no more than 30,000 jobs, else developers must segment them into one or more feeds while "maintaining 1:1 mapping between the jobs and the 'job_feed_id'."
  • Just like creating the recruiting manager, developers must also obtain App Access Tokens to create and register the job feeds by linking the XML feeds and defining the syncing frequency.
  • "Once the feed and recruiting manager are registered, Facebook will continually update the job openings at whatever frequency the developer specified during the registration."

#5: Passing Jobs Review

  • At this point, while the jobs are all set and ready to go live, they must pass through Facebook's integrity test or review process.
  • Facebook checks for discrimination, scam tendencies, restrictions and ensures that the job post satisfies its guidelines; else, they'll not be posted. Even modified jobs will pass through this process.
  • The review process can sometimes take 24-48 hours.
  • Developers can keep track of this by using the GET request method to retrieve the status, identify, and fix any XML-related errors of the jobs.

#6: Getting Jobs Live and Matched to a Facebook Page

  • If there are no errors and the jobs pass Facebook's review processes, they will be live on Facebook and Facebook users can start applying to them.
  • "When someone applies for a job on Facebook, Facebook Jobs Platform will call the webhook configured in the 'application-callback-url' in the XML feed to notify about the job applicant."
  • The developer can then follow up on the applicant or the application process by demanding further information or setting up additional application criteria such as retrieving the full application details, adding screening questions, etc.
  • Facebook's matching algorithm can associate job posts to the correct business Facebook page if the developer provides the business' Facebook URL and sufficient company information in the XML feed.
  • "The Facebook page's page administrator will be presented with a request to match your jobs; if they accept, the jobs will begin to be distributed on that Facebook page, receive that page's branding, and gain extra traffic from the fans of that page."
  • "If the page admin does not accept or reject the job within seven days, it will automatically be matched to the page and begin displaying as if it was accepted."

Functionalities of Facebook Jobs API Post-Integration

#1: Application Callback Payload

  • As earlier mentioned, when a Facebook user applies for a job on Facebook, the Facebook Jobs Platform will call the webhook configured in the 'application-callback-url' in the XML feed to notify the developer/page administrator about the job applicant.
  • The application payload includes the application type, page ID, job opening ID, job application ID, and job external ID.

#2: Get All Job Application Detail

  • Since the application payload contains only the basic, functional details of the applicant, developers can use the GET request method with the 'job_application_id' to retrieve the full details of the applicant.
  • Note that an App Access Token is required to complete this method/command.

#3: Delete Jobs and Feeds

  • After integrating Facebook Jobs API, developers can delete individual jobs or job feeds by removing it from the XML representation of that job from the feed or deleting the job feed from the API.
  • "Upon the next scrape, that job will be removed from the Facebook platform." Note that when a job or feed is deleted, all corresponding job applications will be deleted too.

#4: Modify or Add Jobs to the XML Feed

  • Developers can directly modify XML feeds or even add jobs to them, as each feed can contain no more than 30,000 jobs.
  • Note that for each addition or modification, the job posts would still have to pass through Facebook's integrity test or review before they can be live on Facebook.

Benefits of Facebook Jobs API

  • With the Facebook Job API, "employers can reach diverse and qualified candidates while staying connected to the systems they already use." Also, when jobs are matched and linked to a company's Facebook page, "jobs will then be posted on that company's Facebook page, receive that page's branding, and gain extra traffic from fans of that page."
  • Furthermore, businesses can now post job listings or openings to various channels including their 'jobs tab' on their business pages, Jobs dashboard, Facebook marketplace, and the news feed. To further promote these job posts, businesses can leverage paid or boosted ads.
  • On the side of the job seekers, "they can discover openings, auto-fill applications with their Facebook profile information, edit and submit their application, and communicate via Messenger to schedule interviews." In 2018, Facebook’s VP of Local, Alex Himel, said that in the US, one in four people have searched for or found a job through Facebook.
  • The Facebook Job API is beneficial mostly to low-skill job seekers, such as those who work in industries like retail and foodservice. Since they don't have robust qualifications and/or professional experience that'll good enough for LinkedIn, "they can rely on Facebook to connect them with jobs even if they weren’t actively seeking a position, and quickly apply to lots of different positions by piggybacking off their profile info."