API reference · Public jobs API

Attribution and source terms

Link to the GreenHired job url whenever you show a job. The API serves jobs posted on GreenHired itself, and never hands out a third-party apply link.

2 min read Updated Maintained by the GreenHired team
View Markdown
On this page
  1. The attribution rule
  2. Which jobs the API serves
  3. What you must not do
  4. Frequently asked questions

#The attribution rule

Every job has a url on greenhired.com. When you show a GreenHired job anywhere, link to that url next to it, and do not present it as your own listing. Applying happens on the GreenHired page.

The API never gives you the address a third-party job came from (the apply_url of the original posting). Send people to the url instead.

A correct link
JSON
{ "title": "Wind Farm Site Engineer", "url": "https://greenhired.com/jobs/wind-farm-site-engineer-bergen-f3b1/" }

#Which jobs the API serves

By default the API serves only jobs posted on GreenHired itself, and the counts and statistics computed from them. Every job list, job detail, category count and salary figure is filtered the same way.

Jobs that GreenHired collects from partner feeds are not served until each provider's terms have been read and the source cleared. A job from a source that is not cleared is a 404 on its own address, like a job that does not exist.

source_typeMeaning
first_partyPosted on GreenHired by an employer

If a partner feed is cleared for the API in future, its jobs will carry the feed's name in source_type, and that feed's own credit rules will be added to this page first.

#What you must not do

  • Present a GreenHired job as your own listing.
  • Remove or hide the link to the job url.
  • Keep showing a job after the API says it is 410 gone.
  • Share your key with another company. Ask them to request their own.

#Frequently asked questions

Does the rule apply in emails, chats and apps?
Yes. "Anywhere" means anywhere you show a GreenHired job: a web page, an email, a chat answer or an app screen. Include the job url next to it.
Will the API include jobs from other sites later?
Only when the source is cleared. Until then they are not served, and a page about such a job answers 404.
Can I keep a copy of the data?
Remove a job when the API says it is gone (410). If you plan to keep a large copy, write to partners@greenhired.com first so we can agree how.