API Reference - Overview

The GradSiren Jobs REST based API is designed to support lightweight content consumption by consumers. It is anticipated that this API will be leveraged by Commercial Job Boards, Mobile Applications and Social Media sites who desire to provide employment opportunities on their site. Typically in these commercial venues, the breadth of data presented to a user (job seeker) is much smaller than the detailed content provided on GradSiren Jobs, as required by law.

Authentication

The search jobs require authentication using an API Key provided by GradSiren after submitting the API Request form.

The code list endpoints do not require authentication.

Guides - Rate Limiting
  • Defaults to only "Public" jobs
  • User must make additional request to search for "Status" jobs
  • Maximum of 5,000 job records per query
  • Maximum of 500 job records returned per request
Guides - Terms of Use

This U. S. Federal Government system is to be used by authorized users only. Information from this system resides on computer systems funded by the government. The data and documents on this system include Federal records that may contain sensitive information protected by various Federal statutes, including the Privacy Act, 5 U.S.C. § 552a.

All access or use of this system constitutes user understanding and acceptance of these terms and constitutes unconditional consent to review, monitoring and action by all authorized government and law enforcement personnel. While using this system your use may be monitored, recorded and subject to audit.

Unauthorized user attempts or acts to (1) access, upload, change, or delete or deface information on this system, (2) modify this system, (3) deny access to this system, (4) accrue resources for unauthorized use or (5) otherwise misuse this system are strictly prohibited. Such attempts or acts are subject to action that may result in criminal, civil, or administrative penalties.

GradSiren Apply

This Documentation forms an integral part of the GradSiren Partner Developer Agreement agreed between you and GradSiren. By accessing the GradSiren API, building the integration or Application or otherwise using the GradSiren API, you agree that: (i) you are granted the license to build the Integration in accordance with the GradSiren Partner Developer Agreement and (ii) you accept the Documentation terms and guidelines and (ii) you agree to follow the guidelines contained here in and (iv) you agree not to use the GradSiren API for any other purpose or in any other manner than described here in. The Integration is subject to GradSiren Verification as described in the GradSiren Partner Developer Agreement.

Guidelines
  • By using the GradSiren Apply API in connection with your Job Listings, you agree not to require or otherwise burden a Job Seeker to submit a duplicate application through other means if that Jobseeker already applied to your Job Listing using GradSiren Apply.
  • You further agree to accurately describe to a Jobseeker what information and data you collect from and about that Job Seeker when they apply to your job using GradSiren Apply, including how you handle and share such information and data. You also agree to honor a Jobseeker request for their information and data that you collect in connection with any API.
  • You shall not configure any parts of the application experience that aren't clearly provided by GradSiren as configurable.
  • You shall not filter or alter applications submitted by Jobseekers.
  • You shall immediately notify GradSiren in writing to support@gradsiren.com of any applications that cannot be processed by your Platform.
  • You shall provide an unrestricted and unmodified test Employer account(s) to GradSiren and GradSiren reserves the right to test Jobseeker application experience by, among other actions, posting test Job Listings. GradSiren is not obliged to perform this test.
  • If you are provided with a URL to specify additional steps required from Jobseekers to apply to Job Listings (such as FinishAppUrl) you shall configure and enable such URL and ensure its appropriate availability.
  • You must inform GradSIren of any changes to your career pages (pages where the job advertisements are hosted) that would impact the GradSiren Apply HTML, at least 30 days prior to implementing such changes.

You agree to inform your clients that the use of GradSiren Integration is at all times governed by GradSiren’s terms of service (https://www.gradsiren.com/terms-conditions), GradSiren’s cookie policy (https://www.gradsiren.co.in/cookie-policy) and privacy policy (https://www.gradsiren.co.in/privacy-policy), and link to those should be provided to your clients (“GradSiren Integration Information'').

GradSiren Integration Information shall be provided in the following manner:

  • For your clients that are opted in to GradSiren Integration by default (if any): you must send a prior notice to all such clients (via an email, your Platform or website pop up or similar means), specifying the date of deployment of and/or date of availability of the GradSiren Integration or API bundle that allows for the GradSiren Integration
  • For all your other clients who must opt into GradSiren Integration in order to activate it, within your marketplace page, your implementation guide page or equivalent page, you shall present the GradSiren Integration Information on said page to those clients before such clients can choose opt into GradSiren Integration (for example, at deployment of the GradSiren Integration; when the client opts in to the API bundle that allows for GradSiren Integration)

In addition, you shall include the following in the GradSiren Integration Information on GradSiren Apply Integration:

  • How GradSiren Apply works, as provided by GradSiren;
  • That clients’ Job Listings will now be included in a comprehensive feed delivered to the GradSiren Platform, which includes www.gradsiren.com together with the global domains in other jurisdictions and all websites owned by GradSiren and its Affiliates which syndicates Job Listings.
  • That applicants will now be able to apply to clients’ Job Listings on GradSiren using the GradSiren Apply functionality; That applicants will now apply to clients’ Job Listings on GradSiren and the resulting application will be ingested by your, and applicants will not be directed to clients’ career pages to apply for a job;
  • They have an explicit option to opt-out of the Integration and/or GradSiren Apply feature (this option to opt-out must be made available for your clients at any time by either (i) providing your clients with your company contact email or (ii) providing an opt out functionality within your Platform. (NOTE such clients shall NOT under any circumstances be instructed to contact GradSiren to opt-out).