Referencia de la API

Las API de SEO for Jobs le permiten integrar Google for Jobs con facilidad y van más allá de la integración básica de la publicación de ofertas de empleo de forma inmediata.

Regístrese y solicite el token de la API aquí: https://app.seo-for-jobs.com/register

La URL raíz de la API es https://app.seo-for-jobs.com/api/public.. El token de la API para la autenticación se puede solicitar dentro de su cuenta de SEO for Jobs. Es necesario un paquete activo para utilizar la API. El token debe enviarse a través de la cabecera adicional "x-api-token". El límite de solicitudes es de 50 solicitudes por hora y puede aumentarse si se solicita.

GET /jobs

Obtenga una lista de todas las ofertas de empleo de su cuenta.

Parámetros:

ninguno

Respuesta (Ejemplo):

{
list: [
{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur
.
.." ...
},
{...}
]
}

CURL (Ejemplo):

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

POST /trabajo

Cree un nuevo puesto de trabajo dentro de su cuenta.

Parámetros:

  • Estado: Uno de estos "BORRADOR" o "PUBLICADO".

  • título: Cadena

  • descripción: descripción HTML (etiquetas permitidas: br, ul, li)

  • employmentType: NULL o lista de este "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (eg.: ["FULLTIME", "PARTTIME"])

  • salaryCurrency: NULL o una de estas "EUR", "CHF", "INR", "JPY", "USD".

  • salaryValue: Número (por ejemplo: 42,00)

  • salaryUnit: NULL o una de estas "DAY", "HOUR", "WEEK", "YEAR", "MONTH

  • streetAndNo: Cadena

  • ciudad: Cadena

  • Código postal: Cadena (por los ceros a la izquierda)

  • countryCode: código de país i18n (por ejemplo, "DE" o "FR").

  • companyName: Cadena

  • companyLogoUrl: URL completa de un logotipo (250px x 250px, .png, .jpeg, .jpg)

  • redirectUrl: URL completa para redirigir después de hacer clic en el "botón de solicitud" dentro de Google for Jobs.

Respuesta (Ejemplo):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6"
status: "PUBLISHED",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur ...
"
...
}

CURL (Ejemplo):

$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}

Actualice un puesto de trabajo existente con el correspondiente {id}. Sólo se actualizarán los parámetros enviados. La actualización se enviará automáticamente a Google en caso de que el estado sea "PUBLICADO" tras el proceso de actualización.

Parámetro:

  • Estado: Uno de estos "BORRADOR" o "PUBLICADO".

  • título: Cadena

  • descripción: descripción HTML (etiquetas permitidas: br, ul, li)

  • employmentType: NULL o lista de este "INTERN", "PERDIEM", "FULLTIME", "PARTTIME", "TEMPORARY", "VOLUNTEER", "CONTRACTOR" (eg.: ["FULLTIME", "PARTTIME"])

  • salaryCurrency: NULL o una de estas "EUR", "CHF", "INR", "JPY", "USD".

  • salaryValue: Número (por ejemplo: 42,00)

  • salaryUnit: NULL o una de estas "DAY", "HOUR", "WEEK", "YEAR", "MONTH

  • streetAndNo: Cadena

  • ciudad: Cadena

  • Código postal: Cadena (por los ceros a la izquierda)

  • countryCode: código de país i18n (por ejemplo, "DE" o "FR").

  • companyName: Cadena

  • companyLogoUrl: URL completa de un logotipo (250px x 250px, .png, .jpeg, .jpg)

  • redirectUrl: URL completa para redirigir después de hacer clic en el "botón de solicitud" dentro de Google for Jobs.

Respuesta (Ejemplo):

{
id: "2fd59d17-14ea-4b86-a3d8-c3126db5fbc6",
status: "PUBLISHED",
title: "SAP S/4HANA Senior Developer",
description: "Lorem ipsum dolor sit ametconsetetur ...
"
...
}

CURL (Ejemplo):

$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}

Elimine un puesto de trabajo con el correspondiente {id}.

Parámetros:

ninguno

Respuesta (Ejemplo):

{
estado: "SUCCESS"
}

CURL (Ejemplo):

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'

Errores

En caso de que se produzca un error al procesar su solicitud, obtendrá uno de los siguientes códigos:

API_TOKEN_INVALID
El token de API proporcionado no se ha encontrado en una cuenta activa. Una cuenta está marcada como "activa" cuando tiene un paquete activo.

REQUEST_LIMIT_REACHED
Se ha alcanzado el límite de solicitudes diario. su límite de solicitudes se restablecerá en un plazo de 24 horas.

UPGRADE_NECESSARY
El recuento total de trabajos con el estado "PUBLICADO" ha alcanzado su límite de paquetes. Por favor, actualice su cuenta para publicar más trabajos.

ID_NOT_FOUND
No se ha encontrado el ID proporcionado para un puesto de trabajo específico.

Autor: Redacción de SEO for Jobs
Publicado el 01.10.2020
Actualizado el 18.03.2024
Otros artículos ...
¿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.

Emma Williams
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 +1 (628) 227-9321.

Registrarse gratis

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

Emma Williams
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.
Continuar