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.

Vill du prova Google för jobb? Skapa ett kostnadsfritt konto nu.

Samråd utan förpliktelse

Vi hjälper dig gärna med råd och stöd för att lista dina jobbannonser på Google for Jobs och utnyttja deras fulla potential.

Patrick Schmidt
Expert på Google-jobb
Få icke-bindande råd nu. Vi ringer också gärna upp dig - skriv bara ett kort meddelande.
Begär en återkallelse
Alla uppgifter överförs krypterade.

Det fungerade

Vi återkommer till dig senast på Om det är mer brådskande kan du nå oss på följande adress +1 (805) 3247981 nås.

Registrera dig gratis

Skapa ett kostnadsfritt konto nu och skapa din första jobbannons utan några förpliktelser.

Patrick Schmidt
Expert på Google-jobb
Få en icke-bindande konsultation nu.
Registrera dig gratis
Alla uppgifter överförs krypterade.

Gratis kontroll

Kontrollera på några sekunder om dina jobbannonser är redo för Google for Jobs.

Grattis! Du är redan utmärkt förberedd för Google for Jobs.
Kontrollera nu
Alla uppgifter överförs krypterade.

Testresultat

Förhandsgranskningen är laddad ...
Visa resultatet
Tillgänglighet
En bra start. Din platsannons är lätt tillgänglig med en laddningstid på sek.
Tillgänglighet
Kontrollera länken , eftersom den inte är tillgänglig.
Innehållet är läsbart
Grunden har skapats. Innehållet i platsannonsen är maskinläsbart.
Innehållet är läsbart
Eftersom länken inte är tillgänglig kan vi tyvärr inte kontrollera om innehållet är läsbart.
Redo för Google för jobb
Grattis - jobbannonsens schemadata är tillgänglig. Detta gör det möjligt för Google for Jobs att lista platsannonsen.
Redo för Google för jobb
Din platsannons är inte redo för Google för jobb. Förbered dig nu
Redo för Google för jobb
Eftersom länken inte är tillgänglig kan vi inte kontrollera om det finns matchande schemadata.
Jobbsökare tillgängliga
En bra start. Jobbannonser för "" söks aktivt av intresserade på Google for Jobs.
Publicering möjlig
Det är möjligt att publicera platsannonser i avsnittet "".
Registrera dig nu
Skapa ditt konto nu och få 10 % rabatt på alla paket. På så sätt kan du dra full nytta av potentialen hos Google for Jobs.
' tillbaka
Alla uppgifter överförs krypterade.
Gratis arbetsgivarprofil
Skapa din arbetsgivarprofil nu utan förpliktelser och utan kostnad.
Nästa ...