How can we help you?

America's Job Exchange (AJE)

The Greenhouse API integration is a seamless method of transmitting your jobs to America’s Job Exchange. It is intended for employers whose recruitment efforts are powered by Greenhouse Recruiting. Those clients can opt for an API integration to have their jobs indexed to America’s Job Exchange automatically to meet their diversity recruitment and/or OFFCP compliance needs. 

 

Preparation

Interested clients need to purchase a package deal by contacting AJE sales. Please find AJE contact details below:

Phone: 1-866-926-6284
Email: sales@americasjobexchange.com

Once the contract is signed and the client’s account is setup; the client will receive a confirmation email from their dedicated account manager. The account manager will setup an Onboarding call with client to give them an overview of services and process. 

Note: The complete integration process takes 2-3 weeks for the compliance clients (due to state job board account creation requirements) and 7-10 working days for diversity recruitment clients. 

 

How does it work?

If you are integrating with the Job Board API, you will be able to post open jobs for different organizations and departments. With Greenhouse’s Job Board API, you will have easy access to a simple JSON representation of your company’s offices, departments, and published jobs.

Greenhouse supports JSONP callbacks, and have a POST method which can be used to build your own online job application form.

 

Configuring your Job Board

To pull open jobs from customers, you will also need the job board token from them. Usually that's pretty simple (e.g. CompanyABC’s board token is "companyabc" with the URL being https://api.greenhouse.io/v1/boards/companyabc/jobs)

To find the job board token, the Greenhouse user will need to complete the following steps:

  • The Greenhouse user will click on the Configure tab
  • Select Job Board
  • Click Edit
  • The job board token will be located in the URL field
  • Forward job board token to America’s Job Exchange to integrate GreenHouse API. 
  • America’s Job Exchange has created a script to parse GreenHouse API based on instructions given on GreenHouse-Job-Board-API-Configuration
  • The standard URL to send HTTP request for the GreenHouse API is:

HTTP Request

GET https://api.greenhouse.io/v1/boards/{board_token}/jobs

  • The above-mentioned URL returns a simple JSON representation of your company’s offices, departments, and published jobs.
  • AJE API parser uses JSONP callback methods given on GreenHouse-Job-Board-API-Configuration page to pull client’s job data from API
  • That data is then converted to AJE’s specification and mapped to AJE related fields. See following table for AJE related job fields.

Req

Field Names

Type

Length

Expected Values

 

R

OriginationJobID

T

1 to 40

   

We identify a new job based on Origination Job ID and it must be unique for every job.

 

R

JobTitle

T

1-120

Text string

 

 

StreetAddress1

T

1 to 80

Text string

 

 

StreetAddress2

T

1 to 80

Text string

 

*

City

T

1 to 40

Text string

 

*

State

T

2

Required if city and zip code are not NULL

 
 
 

*

ZIP

T

5 or 10 (US)

*Valid Postal Code of USA.

 

*e.g. "12345" or  "12345-6789"

 

 

 

 

 

R

Country

T

2

Valid two-letter country abbreviation. Use "US" for USA

 

*

SalaryUnit

T

30-Jan

The salary unit of a job (per hour, per week, etc.)-

 

Hourly

 

Daily

 

Weekly

 

Monthly

 

Yearly

 

 

MinimumSalary

N

1 to 10

*the salary can't be more than $500 per hour or $1,040,000 per year.

 

*minimum salary must be < max salary

 

 

MaximumSalary

N

1 to 10

*the salary can't be more than $500 per hour or $1,040,000 per year.

 

*minimum salary must be < max salary

 

 

Experience

AN

1 to 40

-Must specify year or month. e.g. 5 years

 

-We consider it as ‘year’ if not specified.

 

-We always take minimum experience. e.g. 2-5 years will be considered 2 years.

 

 

Education

AN

1 to 40

Minimum education required for the job

 

R

PositionCount

I

3-Jan

Value of 1 - 500 ( it will be 'one' by default if not provided)

 

 

HoursPerWeek

I

3-Jan

Value of 0 - 168

 

R

JobDuration

T

1 to 40

Full Time Or Part Time Or Per diem or Intern etc.

 

R

JobType

T

1 to 40

Permanent or Temporary or Regular Or Temp etc.

 

 

Shift

T

1 to 40

 

 

1 First shift

 

2 Second shift

 

3 Third Shift

 

R

JobDescription

T

100 - 8000

*Text String in plain text. HTML will be converted to plain text

 

 

 

 

 

 

 

R

ApplicantionURL

T

4 - 1000

AJE will redirect users to GreenHouse to complete application. We've not integrated application at this point.

 

 

CompanyName

T

1 to 40

If not given- we will use company name as it's given on your contract signed with AJE

 

Required Column Values

R - Always required. See What Makes up a Job—Required Items for a description of content

* - Conditionally required, see field descriptions in What Makes up a Job— Optional Items for more information.

Type Column Values

AN - alphanumeric

I - integer

N - number

T – text

  • The job data gets indexed to America’s Job Exchange database overnight.
  • Once jobs are indexed to AJE database, we distribute those jobs for OFCCP Compliance and/or Diversity recruitment to AJE partner network within 72 hours.
  • AJE calls API data daily between 6:30pm EST to Midnight EST and data is indexed to AJE database overnight (approx. by 4am EST).

I want to be able to track source of applicants coming from AJE?

Please refer to this page for steps to assign AJE as a source in your account. From there, please follow the steps below to generate a tracking link.

  1. Go to Job Board
  2. Click on Tracking Link 
  3. Select AJE 
  4. Create source code

1594a201-5d1a-49dc-b375-553101111493.png

Forward that tracking token (which you have assigned to AJE at GreenHouse) toajetechsupport@americasjobexchange.com to have it applied at our end.

 

Daily API Activity Report

AJE sends daily activity report to client stating API processing results and errors. Please see below-

The results mentioned in the daily activity e-mail identify what Data Exchange does with the records received in the API JSONP Callback. The records from the most recently submitted file are compared with those in the previously submitted file, and they are tagged as follows:

  • Records that are in the recent file, but not in the previous file, are tagged as ADD;
  • Records that have changed from the previous to the recent file are tagged as CHANGE;
  • Records that are not in the recent file, but were in the previous file are tagged as DELETE;
  • Records that are in both files that have not changed are tagged as NO CHANGES.

Records that are tagged as Add, Change and Delete become corresponding transactions to the AJE database.

Technical Contacts

AJE Tech Support- ajetechsupport@americasjobexchange.com

Greenhouse - Submit a question

Frequently Asked Questions (FAQs)

What are the general errors in daily activity report and how to decipher those

There are following errors appear frequently in the daily report. 

  • FATAL ERROR: Error getting value No jobs have been processed for this account.
    • Caused by NULL value in the Company requisition ID or Job Title fields. None of the jobs will be processed in this case. 
  • You must provide both STATE and ZIP CODE for the JOB LOCATION CITY you entered.
    • Caused by missing state or zip code or both for the related job record.
  • Duplicate Job Origination ID detected while processing job file. Only the first job record with this id has been processed.
    • Caused by duplicate record in the file and only first record is processed.
  • The value provided for JOB LOCATION ZIPCODE is not found on our database.
    • Invalid zip code or could be other than US zip code
  • <Field name> has exceeded the maximum length of <Character limit> characters.
    • Every field has specific number of characters allowed. You need to correct that.
  • The JOB DESCRIPTION is required and must be at least one hundred characters in length.
    • Job description is less than 100 characters.
  • All jobs posted in NC, PA, WV, and FL require the full address in the state. We do not have the full address information on file for posting the following job(s) on the State Employment Service Delivery System:
    • Caused by missing address for the states of NC, PA, WV, and FL. Client needs to forward complete address to AJE

 

What’s the benefit of going for API integration vis-à-vis scraping?

Scraping is not as stable as API integration since websites are updated by the applicant tracking systems all the time and scraping depends the internal HTML structure of the website which mostly gets changed after website update. The scraper fails whenever that happens and we have to update our scraping script as per the new design of the page. However, API remain consistent since it provides direct interaction with job data in a consistent format and therefore, it remains stable regardless of website changes.

 

I've changed my Applicant Tracking System (ATS). What do I need to do to ensure a smooth transition?

Please contact your Account Manager or ajetechsupport@americasjobexchange.com

 

I received an error that my job description is exceeding 8000 characters; however, it’s less than 8000 characters with spaces. Why is that?

There could be HTML tags or formatting in the job description field. Do not include any HTML tags or formatting in this (or any) field. On the Job Exchange site, they will be treated as regular text and counted as a valid character. However, we filter them out while displaying your job on America’s Job Exchange.

 

Can I use HTML tags and formatting in the job description field?

We only accept plain text for the job description field. Do not include any HTML tags or formatting in this (or any) field. On the America’s Job Exchange site, they will be treated as regular text and counted as a valid character. However, we filter them out while displaying your job on America’s Job exchange.

 

I received an error that my job could not be distributed for OFCCP compliance due to missing city and the zip code. Why is that?

We are unable to distribute the nationwide or statewide jobs for OFCCP compliance purpose. A valid US city, state and zip code are must for the OFCCP related distribution of your job. You may post your regional jobs to the biggest city in the region, statewide jobs to the capital city of the state and nationwide jobs to the corporate office location of the company; to make them available for OFCCP related distribution.

 

I received an error on a job with a salary of $50,000 that said the salary can't be more than $500 per hour or $1,040,000 per year.

Please contact your Account Manager or ajetechsupport@americasjobexchange.com

 

I want to post jobs based in other countries. How can I do that?

We only post US jobs. International jobs are skipped.

 

I entered the correct state name and it still displays invalid state error. How can I fix it?

Please check, there could be typo in the state’s name or contact ajetechsupport@americasjobexchange.com

 

I want to post a job remote/nationwide/regional sales jobs for OFCCP compliance. How can I do that?

We need valid USA city, state and zip code to distribute jobs for OFCCP compliance. Those jobs can be mapped to your Corporate Headquarters location to enable OFCCP related distribution. Let us know if you want to do that and we’ll apply mapping.

 

I want to post a job statewide/countywide jobs for OFCCP compliance. How can I do that?

We need valid USA city, state and zip code to distribute jobs for OFCCP compliance. Those jobs can be mapped to your Corporate Headquarters location or capital of the state or county seat, to enable OFCCP related distribution. Let us know if you want to do that and we’ll apply mapping.

 

How do I edit my active jobs?

Jobs posted to AJE are linked to jobs posted on Greenhouse. If you edit a GreenHouse job, it will be edited on AJE, the next day.

 

How do I delete/expire my jobs?

Jobs posted to AJE are linked to jobs posted on Greenhouse. If you delete/expire a GreenHouse job, it will be expired on AJE, the next day.

 

Do you expire API Jobs after 60/30 days, like online jobs postings?

No, we don’t have an expiry date for the jobs posted through an API, Your job will remain active on America’s Job Exchange as long as active on GreenHouse.

 

What do I do if my daily activity report status says 'Error'?

Click on the 'Details' next to the record that says 'Error'. The reasons for the error will be stated. For any technical questions or assistance, please contact us at ajetechsupport@americasjobexchange.com

 

Where can I view the active jobs in my account?

To view all your active jobs, log in to your online Employer Account and click on 'Job Activity' from top navigation panel. Select Job Summary. 

Why do you send me Daily activity e-mail every day? What is this?

The e-mail is your API activity reports. Every night database processing takes place, and the results for your account are e-mailed to the address specified as your API reports e-mail. If you have sent new data files for that day's processing, you will receive status e-mail for those files.  This report includes alerts for any errors that were encountered during processing as well as a record of how many changes, additions, and deletes were performed on your collection of jobs in our database, based on the files that you sent to us.

How do I change the email address that receives the transmission report?

Please contact us at ajetechsupport@americasjobexchange.com 

What do the results in the Transaction Summary section of the e-mail mean—Add, Change, Delete, and No Changes?

The results mentioned in the e-mail identify what Data Exchange does with the records received in the submitted file. The records from the most recently submitted file are compared with those in the previously submitted file, and they are tagged as follows:

  • Records that are in the recent file, but not in the previous file, are tagged as ADD;
  • Records that have changed from the previous to the recent file are tagged as CHANGE;
  • Records that are not in the recent file, but were in the previous file are tagged as DELETE;
  • Records that are in both files that have not changed are tagged as NO CHANGES.

Records that are tagged as Add, Change and Delete become corresponding transactions to the AJE database. 

I want my API Daily report to be e-mailed to two (or three, or five) people at my business. How do I do that?

We support Max. 120 Characters recipients list separated by comma and it can support up to 3 email addresses. However, if your email list is longer than that; we would suggest you to create a group mailing list at your company that includes the people who should receive API reports. You should set up the mailing list so it is able to receive e-mail from outside your company.  A benefit of doing this is that you can send the reports to an unlimited number of people, and you may change your list of recipients whenever you wish, without having to update your information with us. 

How often do you run the program that updates the database?

AJE calls API data daily between 6:30pm EST to Midnight EST and data is indexed to AJE database overnight (approx. by 4am EST the next day). 

Can you run my jobs at 9:00pm (1:00am, 2:30am, etc.) instead of midnight Eastern Time?

Sorry, the Data Exchange processing is timed around other America's Job Exchange processes so we have very little leeway in scheduling runs. The current run time of midnight Eastern Time ensures that we can process the growing list of AJE users in enough time that everyone's jobs will be available the following morning. 

Why aren't my jobs in the database?

It is possible that there was a validation error in your file that prevented it from processing.  Contact ajetechsupport@americasjobexchange.com  for assistance.

 

How long does it take for the jobs to show up in the search after they are processed?

These will show up by the following morning.

Do you also use API to sync application process at AJE?

No, we are not using API to sync application process with GreenHouse at this time. We redirect job seekers to GreenHouse to complete application process. The state job boards only approve jobs if they have clear indication that job application is completed at client’s website. Based on their feedback we have applied it in this way.

I want to be able to track source of applicants coming from AJE?

Please work with your GreenHouse rep to assign a tracking token for AJE. You may refer to this page for more details. Forward AJE’s tracking token to ajetechsupport@americasjobexchange.com to have it applied at our end.