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.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.

¿Desea probar Google for Jobs? Cree ahora una cuenta gratuita.

Asesoramiento sin compromiso

Estamos encantados de asesorarte en la publicación de tus próximas ofertas de empleo en Google for Jobs. Contáctanos y aprovecha todo el potencial.

Julia Weber
Experto Google Jobs
Llámanos ahora y solicita el servicio de asesoramiento (sin compromiso). También puedes enviarnos un breve mensaje y nosotros te llamaremos!
Solicitar llamada
Todos los datos se transmiten cifrados.

¡Todo correcto!

Le responderemos a más tardar el Si es más urgente, nos puede contactar en el 932 20 82 69.

Registrarse gratis

Cree ahora una cuenta gratuita y añada sin compromiso la primera oferta de empleo.

Julia Weber
Experto Google Jobs
Déjese asesorar ahora sin compromiso.
Regístrate gratis
Todos los datos se transmiten cifrados.

Comprobar gratis

Compruebe en pocos segundos si sus ofertas de empleo para Google for Jobs están listas.

¡Felicidades! Está perfectamente preparado para Google for Jobs.
Comprobar ahora
Todos los datos se transmiten cifrados.

Resultado del test

La vista previa está cargada ...
Mostrar resultado
Disponibilidad
Buen comienzo. Con un tiempo de carga de segundos, su oferta de empleo está perfectamente disponible.
Disponibilidad
Compruebe el enlace , ya que no está disponible.
Contenido legible
Se ha creado la base. Los contenidos de la oferta de empleo son legibles por medios mecánicos.
Contenido legible
Puesto que el enlace no está disponible, no hemos podido comprobar si los contenidos son legibles.
Lista para Google for Jobs
¡Felicidades! Existen datos de Schema de la oferta de empleo. Por tanto, Google for Jobs puede registrar la oferta de empleo
Lista para Google for Jobs
Su oferta de empleo aún no está lista para Google for Jobs. Preparar ahora
Lista para Google for Jobs
Puesto que el enlace no está disponible, no hemos podido comprobar si existen datos de Schema apropiados.
Existen solicitantes de empleo
Buen comienzo. En Google for Jobs se buscan activamente ofertas de empleo de "".
Publicación posible
Es posible publicar ofertas de empleo en la categoría "".
Regístrese ahora
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.
‹ volver
Todos los datos se transmiten cifrados.
Perfil de empresa gratis
Crea ahora el perfil de tu empresa sin compromiso y de forma gratuita.
Siguiente ...