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.

Czy chcą Państwo wypróbować Google for Jobs? Proszę założyć teraz bezpłatne konto.

Konsultacja bez zobowiązań

Chętnie służymy Państwu radą i pomocą, aby zamieścić Państwa ogłoszenia o pracę w Google for Jobs i w pełni wykorzystać ich potencjał.

Julia Weber
Google Jobs Expert
Proszę skorzystać z niezobowiązującej porady już teraz. Chętnie też do Państwa oddzwonimy - wystarczy napisać do nas krótką wiadomość.
Żądanie oddzwonienia
Wszystkie dane są przesyłane w postaci zaszyfrowanej.

To zadziałało

Odezwiemy się do Państwa nie później niż na adres . Jeśli jest to pilne, można się z nami skontaktować pod adresem +1 (805) 324-7981 osiągalny.

Proszę się bezpłatnie zarejestrować

Proszę założyć teraz bezpłatne konto i stworzyć swoje pierwsze ogłoszenie o pracę bez zobowiązań.

Julia Weber
Google Jobs Expert
Proszę skorzystać z niezobowiązującej konsultacji już teraz.
Proszę się bezpłatnie zarejestrować
Wszystkie dane są przesyłane w postaci zaszyfrowanej.

Kontrola bezpłatna

Proszę sprawdzić w ciągu kilku sekund, czy Państwa ogłoszenia o pracę są gotowe dla Google for Jobs.

Gratulacje. Już teraz są Państwo doskonale przygotowani do Google for Jobs.
Sprawdź teraz
Wszystkie dane są przesyłane w postaci zaszyfrowanej.

Wynik testu

Podgląd jest załadowany ...
Pokaż wynik
Dostępność
Dobry początek. Państwa ogłoszenie o pracę jest łatwo dostępne z czasem ładowania sek.
Dostępność
Proszę sprawdzić link , ponieważ nie jest on dostępny.
Treść czytelna
Fundament został stworzony. Treść ogłoszenia o pracę można odczytać maszynowo.
Treść czytelna
Niestety, ponieważ link nie jest dostępny, nie mogliśmy sprawdzić, czy treść jest czytelna.
Gotowi na Google for Jobs
Gratulacje - dane schematu ogłoszenia o pracę są dostępne. Dzięki temu Google for Jobs może zamieścić ogłoszenie o pracę.
Gotowi na Google for Jobs
Państwa ogłoszenie o pracę nie jest jeszcze gotowe na Google for Jobs. Przygotuj się teraz
Gotowi na Google for Jobs
Ponieważ link nie jest dostępny, nie mogliśmy sprawdzić, czy istnieją pasujące dane schematu.
Osoby poszukujące pracy do dyspozycji
Dobry początek. Ogłoszenia o pracę dla "" są aktywnie wyszukiwane przez zainteresowanych w Google for Jobs.
Możliwa publikacja
W dziale "" mogą Państwo publikować ogłoszenia o pracę.
Zarejestruj się teraz
Proszę teraz założyć konto i otrzymać 10% zniżki na wszystkie pakiety. W ten sposób mogą Państwo w pełni wykorzystać potencjał Google for Jobs.
' back
Wszystkie dane są przesyłane w postaci zaszyfrowanej.
Bezpłatny profil pracodawcy
Proszę teraz bez zobowiązań i bezpłat nie założyć swój profil pracodawcy.
Dalej ...