API Reference

SEO for Jobs APIs allow you to integrate Google for Jobs with ease and go beyond the basic job posting integration out of the box.

Register & request API token here: https://app.seo-for-jobs.com/register

The API root URL is https://app.seo-for-jobs.com/api/public. The API token for authentication can be requested within your SEO for Jobs account. An active package is necessary to use the API. The token has to be sent via the additional header "x-api-token". The request limit is 50 requests per hour and can be increased on request.

GET /jobs

Get a list of all job postings within your account.

Parameters:

none

Response (Example):

{
list: [
{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit amet<br>consetetur …"

},
{…}
]
}

CURL (Example):

$curl -XGET -H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' 'https://app.seo-for-jobs.com/api/public/jobs'

POST /job

Create a new job posting within your account.

Parameters:

  • status: One of this "DRAFT" or "PUBLISHED"

  • title: String

  • description: HTML description (allowed tags: br, ul, li)

  • employmentType: NULL or list of this "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (eg.: ["FULLTIME","PARTTIME"])

  • salaryCurrency: NULL or one of this "EUR", "CHF", "INR", "JPY", "USD"

  • salaryValue: Number (eg.: 42.00)

  • salaryUnit: NULL or one of this "DAY", "HOUR", "WEEK", "YEAR", "MONTH"

  • streetAndNo: String

  • city: String

  • postalCode: String (because of leading zeros)

  • countryCode: i18n country code (eg. "DE" or "FR").

  • companyName: String

  • companyLogoUrl: Full URL to a logo (250px x 250px, .png, .jpeg, .jpg)

  • redirectUrl: Full URL for redirecting after click on the "Apply Button" within Google for Jobs.

Response (Example):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6"
status: "PUBLISHED",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit amet<br>consetetur …"

}

CURL (Example):

$curl -XPOST -H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' -H "Content-type: application/json" -d '{status: "PUBLISHED",title: "SAP S/4HANA Senior Developer",description: "Lore Ipsum …",employmentType: ["FULLTIME", "PARTTIME"],streetAndNo:"Jungfernstieg 47",city: "Hamburg",postalCode: "20354",countryCode: "DE",companyName: "SFJ",redirectUrl: "https://www.seo-for-jobs.com/de/jobs/sap-hana-senior-developer"}' 'https://app.seo-for-jobs.com/api/public/job'

PUT /job/{id}

Update an existing job posting with the corresponding {id}. Only submitted parameters will be updated. The update will be automatically pushed to Google in case the status is after the update process "PUBLISHED".

Parameter:

  • status: One of this "DRAFT" or "PUBLISHED"

  • title: String

  • description: HTML description (allowed tags: br, ul, li)

  • employmentType: NULL or list of this "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (eg.: ["FULLTIME","PARTTIME"])

  • salaryCurrency: NULL or one of this "EUR", "CHF", "INR", "JPY", "USD"

  • salaryValue: Number (eg.: 42.00)

  • salaryUnit: NULL or one of this "DAY", "HOUR", "WEEK", "YEAR", "MONTH"

  • streetAndNo: String

  • city: String

  • postalCode: String (because of leading zeros)

  • countryCode: i18n country code (eg. "DE" or "FR").

  • companyName: String

  • companyLogoUrl: Full URL to a logo (250px x 250px, .png, .jpeg, .jpg)

  • redirectUrl: Full URL for redirecting after click on the "Apply Button" within Google for Jobs.

Response (Example):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
status: "PUBLISHED",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit amet<br>consetetur …"

}

CURL (Example):

$curl -XPUT -H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' -H "Content-type: application/json" -d '{title: "SAP S/4HANA Junior Developer",employmentType: ["FULLTIME"]}' 'https://app.seo-for-jobs.com/api/public/job/2fd59d17-14ea-4b86-a3d8-c3126db5fbc6'

DELETE /job/{id}

Delete a job posting with the corresponding {id}.

Parameter:

none

Response (Example):

{
status: "SUCCESS"
}

CURL (Example):

curl -XDELETE -H 'x-api-key: cca265e6-5c40-4187-a0e9-713b4a9c453f' 'https://app.seo-for-jobs.com/api/public/job/2fd59d17-14ea-4b86-a3d8-c3126db5fbc6'

Errors

In case an error occurred while processing your request you will get one of the following codes:

API_TOKEN_INVALID
The provided API Token was not found within an active account. An account is marked as "active" when it has an active package.

REQUEST_LIMIT_REACHED
The daily request limit is reached. your request limit will be reset within a sliding 24h window.

UPGRADE_NECESSARY
The total count of jobs with the status "PUBLISHED" has reached your package limit. Please upgrade your account to publish more jobs.

ID_NOT_FOUND
The provided ID for a specific job posting was not found.

Souhaitez-vous essayer Google for Jobs ? Créez maintenant un compte gratuit.

Conseils sans engagement

Nous sommes à votre disposition pour vous conseiller sur la façon de répertorier vos offres d'emploi sur Google for Jobs et d'exploiter tout leur potentiel.

Julia Weber
Experts Google for Jobs
Obtenir des conseils sans engagement maintenant. Nous vous rappelons avec plaisir - écrivez-nous simplement un petit message.
Demander à être rappelé
Toutes les données sont transmises cryptées.

Tout s'est bien passé.

Nous vous répondrons au plus tard le Si c'est urgent, vous pouvez nous joindre au +49 40 874 081 43.

S'inscrire gratuitement

Créez un compte gratuit maintenant et déposez la première offre d'emploi sans engagement.

Julia Weber
Experts Google for Jobs
Obtenir des conseils sans engagement maintenant
S'inscrire gratuitement
Toutes les données sont transmises cryptées.

Vérifier gratuitement

Vérifiez en quelques secondes si vos offres d'emploi pour Google for Jobs sont prêtes.

Félicitations. Vous êtes déjà bien préparé(e) pour Google for Jobs.
Vérifier maintenant
Toutes les données sont transmises cryptées.

Résultat du test

L'aperçu est chargé ...
Afficher le résultat
Accessibilité
Bon départ. Votre offre d'emploi est facilement accessible avec un temps de chargement de secondes.
Accessibilité
Veuillez vérifier le lien car celui-ci n'est pas accessible.
Contenus lisibles
La base est créée. Les contenus de l'offre d'emploi sont lisibles par machine.
Contenus lisibles
Le lien étant inaccessible, nous n'avons malheureusement pas pu vérifier si le contenu était lisible.
Prêt pour Google for Jobs
Félicitations – les données de Schema de l'offre d'emploi sont disponibles. Cela permet à Google for Jobs de répertorier l'offre d'emploi
Prêt pour Google for Jobs
Votre offre d'emploi n'est pas encore prête pour Google for Jobs. Préparer maintenant
Prêt pour Google for Jobs
Le lien étant inaccessible, nous n'avons malheureusement pas pu vérifier si les données de Schema appropriées sont disponibles.
Demandeurs d'emploi disponibles
Bon départ. Les personnes intéressées recherchent activement des offres d'emploi pour "" sur Google for Jobs.
Publication possible
Il est possible de publier des offres d'emploi dans la rubrique "".
Inscrivez-vous maintenant
Create your account and save 10% on all packages. Use the full potential of Google for Jobs. So nutzen Sie das Potential von Google for Jobs voll aus.
‹ retour
Toutes les données sont transmises cryptées.
Profil d'employeur gratuit
Créez votre profil d'employeur maintenant sans obligation et gratuitement.
Suivant