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.

Chcete vyzkoušet službu Google pro pracovní místa? Vytvořte si nyní bezplatný účet.

Nezávazná konzultace

Rádi vám pomůžeme radou a podporou při zadávání inzerátů na Google for Jobs a při využití jejich plného potenciálu.

Julia Weber
Odborník na pracovní místa Google
Získejte nezávazné poradenství. Rádi vám také zavoláme zpět - stačí nám napsat krátkou zprávu.
Žádost o zpětné volání
Všechna data jsou přenášena šifrovaně.

To se povedlo

Ozveme se vám nejpozději na adrese . Pokud je to naléhavější, můžete nás kontaktovat na adrese +44 20 4571 7688 dosažitelné.

Zaregistrujte se zdarma

Vytvořte si nyní bezplatný účet a nezávazně vytvořte svůj první pracovní inzerát.

Julia Weber
Odborník na pracovní místa Google
Získejte nezávaznou konzultaci.
Zaregistrujte se zdarma
Všechna data jsou přenášena šifrovaně.

Kontrola zdarma

Během několika sekund zjistíte, zda jsou vaše inzeráty připraveny pro Google for Jobs.

Gratulujeme. Pro Google for Jobs jste již výborně připraveni.
Zkontrolujte nyní
Všechna data jsou přenášena šifrovaně.

Výsledek testu

Náhled je načten ...
Zobrazit výsledek
Přístupnost
Dobrý začátek. Váš pracovní inzerát je snadno dostupný a jeho načtení trvá sec.
Přístupnost
Zkontrolujte prosím odkaz , protože není přístupný.
Čitelný obsah
Byla vytvořena nadace. Obsah inzerátu je strojově čitelný.
Čitelný obsah
Protože odkaz není přístupný, nemohli jsme bohužel ověřit, zda je obsah čitelný.
Připravenost na Google for Jobs
Gratulujeme - data schématu inzerátu jsou k dispozici. Díky tomu může Google for Jobs inzerát zobrazit.
Připravenost na Google for Jobs
Váš inzerát není připraven pro Google for Jobs. Připravte se nyní
Připravenost na Google for Jobs
Protože odkaz není k dispozici, nemohli jsme zkontrolovat, zda existují odpovídající data schématu.
K dispozici jsou uchazeči o zaměstnání
Dobrý začátek. Zájemci aktivně vyhledávají inzeráty na na webu Google for Jobs.
Možnost zveřejnění
V sekci "" je možné zveřejnit inzeráty s nabídkou práce.
Zaregistrujte se nyní
Vytvořte si účet a získejte 10% slevu na všechny balíčky. Tímto způsobem můžete plně využít potenciál služby Google for Jobs.
' zpět
Všechna data jsou přenášena šifrovaně.
Bezplatný profil zaměstnavatele
Vytvořte si nyní nezávazně a bezplatně svůj profil zaměstnavatele.
Přejít na