{ "openapi": "3.1.0", "info": { "title": "workingstudentjobs.de Jobs API", "version": "1.0-beta", "summary": "Working student jobs and internships in Germany. Free, no key.", "description": "Every live working student job and internship on workingstudentjobs.de. Free, no API key, updated hourly.\n\nLink each job with its `url` (our job page) or `apply_url` (our redirect to the application page). Add `?ref=yourapp` to every request.\n\nBeta until 2026-10-31: fields may still be corrected until then. After that v1 only gets additive changes and stays available for 6 months after a v2 ships.\n\nResponses are cached for up to 1 hour. Send If-None-Match with the ETag to get a 304. Rate limit: 60 requests per minute per IP; replies served from our edge cache may repeat the limit headers.\n\nDocs: https://www.workingstudentjobs.de/developers", "termsOfService": "https://www.workingstudentjobs.de/terms#api", "contact": { "name": "workingstudentjobs.de", "url": "https://www.workingstudentjobs.de/contact" } }, "externalDocs": { "url": "https://www.workingstudentjobs.de/developers" }, "servers": [ { "url": "https://www.workingstudentjobs.de/api/v1" } ], "security": [], "paths": { "/jobs": { "get": { "operationId": "listJobs", "summary": "List live jobs, newest first", "description": "Ordered by first_seen_at descending. Filters combine with AND; values inside one filter combine with OR.", "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "Jobs per page.", "schema": { "type": "integer", "minimum": 1, "maximum": 300, "default": 100 } }, { "name": "cursor", "in": "query", "required": false, "description": "Opaque. Follow `links.next` instead of building it yourself.", "schema": { "type": "string" } }, { "name": "city", "in": "query", "required": false, "description": "City slugs, comma separated (at most 20). See /api/v1/cities. German spellings of the big cities (muenchen, koeln, nuernberg, hannover, braunschweig) work too.", "schema": { "type": "string" }, "example": "berlin,munich" }, { "name": "field", "in": "query", "required": false, "description": "Fields, comma separated (at most 15).", "schema": { "type": "array", "items": { "type": "string", "enum": [ "tech", "finance", "marketing", "operations", "hr", "design", "legal", "engineering", "research", "consulting", "logistics", "healthcare", "education", "sales", "gastronomy-hospitality" ] } }, "style": "form", "explode": false }, { "name": "type", "in": "query", "required": false, "description": "Job types, comma separated. A job can be both.", "schema": { "type": "array", "items": { "type": "string", "enum": [ "working_student", "internship" ] } }, "style": "form", "explode": false }, { "name": "language", "in": "query", "required": false, "description": "`en`: English is enough, no German required. `de`: German required.", "schema": { "type": "string", "enum": [ "en", "de" ] } }, { "name": "remote", "in": "query", "required": false, "description": "Working modes, comma separated.", "schema": { "type": "array", "items": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ] } }, "style": "form", "explode": false }, { "name": "since", "in": "query", "required": false, "description": "Only jobs we first saw at or after this ISO 8601 date or date-time. For syncing, use your last poll minus 72 hours and dedupe by id, and walk the full list once a day to catch jobs held for review longer and to drop closed ones.", "schema": { "type": "string" }, "example": "2026-10-15T00:00:00Z" }, { "name": "ref", "in": "query", "required": false, "description": "Your app's name. Optional, but it lets us contact you before breaking changes and see which apps send students. It is kept on apply_url.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,64}$" }, "example": "myapp" } ], "responses": { "200": { "description": "One page of jobs.", "headers": { "ETag": { "$ref": "#/components/headers/ETag" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobList" } } } }, "304": { "description": "Not modified: the If-None-Match ETag still matches." }, "400": { "description": "A parameter is invalid. `error.code` says which check failed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Only GET, HEAD and OPTIONS are supported.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited (60 requests per minute per IP).", "headers": { "Retry-After": { "description": "Seconds until the window resets.", "schema": { "type": "integer" } }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Something failed on our side.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/jobs/{id}": { "get": { "operationId": "getJob", "summary": "Get one job", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "ref", "in": "query", "required": false, "description": "Your app's name. Optional, but it lets us contact you before breaking changes and see which apps send students. It is kept on apply_url.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,64}$" }, "example": "myapp" } ], "responses": { "200": { "description": "The job.", "headers": { "ETag": { "$ref": "#/components/headers/ETag" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobResponse" } } } }, "301": { "description": "The job was merged into another live listing of the same role. Follow Location.", "headers": { "Location": { "schema": { "type": "string", "format": "uri" } } } }, "304": { "description": "Not modified: the If-None-Match ETag still matches." }, "400": { "description": "A parameter is invalid. `error.code` says which check failed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "No public job with this id.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Only GET, HEAD and OPTIONS are supported.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "410": { "description": "The job has closed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited (60 requests per minute per IP).", "headers": { "Retry-After": { "description": "Seconds until the window resets.", "schema": { "type": "integer" } }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Something failed on our side.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/cities": { "get": { "operationId": "listCities", "summary": "Cities with live jobs, for the city filter", "parameters": [ { "name": "ref", "in": "query", "required": false, "description": "Your app's name. Optional, but it lets us contact you before breaking changes and see which apps send students. It is kept on apply_url.", "schema": { "type": "string", "pattern": "^[A-Za-z0-9._-]{1,64}$" }, "example": "myapp" } ], "responses": { "200": { "description": "All cities with at least one live job, busiest first.", "headers": { "ETag": { "$ref": "#/components/headers/ETag" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CityList" } } } }, "304": { "description": "Not modified: the If-None-Match ETag still matches." }, "400": { "description": "A parameter is invalid. `error.code` says which check failed.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "405": { "description": "Only GET, HEAD and OPTIONS are supported.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited (60 requests per minute per IP).", "headers": { "Retry-After": { "description": "Seconds until the window resets.", "schema": { "type": "integer" } }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Something failed on our side.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "schemas": { "Job": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "slug": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "The job page on workingstudentjobs.de." }, "apply_url": { "type": "string", "format": "uri", "description": "Send applicants here. Redirects to the employer's application page (or our job page) and keeps your ref." }, "company": { "anyOf": [ { "type": "object", "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "The company page on workingstudentjobs.de." }, "logo_url": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] }, "website_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name", "slug", "url", "logo_url", "website_domain" ], "additionalProperties": false }, { "type": "null" } ] }, "location": { "anyOf": [ { "type": "object", "properties": { "city": { "type": "string" }, "city_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_code": { "type": "string" }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "latitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "longitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "city", "city_slug", "state", "state_code", "country_code", "postal_code", "latitude", "longitude" ], "additionalProperties": false }, { "type": "null" } ], "description": "Null for postings that name no city." }, "types": { "type": "array", "items": { "type": "string", "enum": [ "working_student", "internship" ] } }, "field": { "anyOf": [ { "type": "string", "enum": [ "tech", "finance", "marketing", "operations", "hr", "design", "legal", "engineering", "research", "consulting", "logistics", "healthcare", "education", "sales", "gastronomy-hospitality" ] }, { "type": "null" } ] }, "sub_field": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "working_mode": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ] }, "salary": { "anyOf": [ { "type": "object", "properties": { "min": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "currency": { "type": "string" }, "period": { "anyOf": [ { "type": "string", "enum": [ "hour", "day", "week", "month", "year" ] }, { "type": "null" } ] } }, "required": [ "min", "max", "currency", "period" ], "additionalProperties": false }, { "type": "null" } ], "description": "Null when the posting states no pay." }, "skills": { "type": "array", "items": { "type": "string" } }, "languages": { "type": "object", "properties": { "german": { "type": "string", "enum": [ "required", "optional", "not_required" ] }, "english": { "type": "string", "enum": [ "required", "not_required" ] } }, "required": [ "german", "english" ], "additionalProperties": false }, "sponsored": { "type": "boolean", "description": "A paid listing. Shown as a flag only." }, "details": { "anyOf": [ { "type": "object", "properties": { "study_fields": { "type": "array", "items": { "type": "string" } }, "study_fields_or_comparable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "True when the posting accepts \"a comparable degree\"." }, "study_levels": { "type": "array", "items": { "type": "string", "enum": [ "bachelor", "master", "phd" ] } }, "min_semester": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "enrolment": { "anyOf": [ { "type": "string", "enum": [ "required", "not_required" ] }, { "type": "null" } ] }, "german_level": { "anyOf": [ { "type": "object", "properties": { "level": { "anyOf": [ { "type": "string", "enum": [ "basic", "good", "fluent", "native" ] }, { "type": "null" } ] }, "cefr": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "CEFR level, only when the posting names one (\"B2\")." } }, "required": [ "level", "cefr" ], "additionalProperties": false }, { "type": "null" } ] }, "english_level": { "anyOf": [ { "type": "object", "properties": { "level": { "anyOf": [ { "type": "string", "enum": [ "basic", "good", "fluent", "native" ] }, { "type": "null" } ] }, "cefr": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "CEFR level, only when the posting names one (\"B2\")." } }, "required": [ "level", "cefr" ], "additionalProperties": false }, { "type": "null" } ] }, "other_languages": { "type": "array", "items": { "type": "string" } }, "hours_per_week": { "type": "object", "properties": { "min": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "min", "max" ], "additionalProperties": false }, "start": { "type": "object", "properties": { "asap": { "type": "boolean" }, "date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "\"YYYY-MM-DD\", or \"YYYY-MM\" when the posting names a month." } }, "required": [ "asap", "date" ], "additionalProperties": false }, "duration_months": { "type": "object", "properties": { "min": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "min", "max" ], "additionalProperties": false }, "internship_type": { "anyOf": [ { "type": "string", "enum": [ "mandatory", "voluntary", "both" ] }, { "type": "null" } ] }, "remote_days_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "benefits": { "type": "array", "items": { "type": "string" } }, "cover_letter": { "anyOf": [ { "type": "string", "enum": [ "required", "not_needed" ] }, { "type": "null" } ] }, "transcripts": { "anyOf": [ { "type": "string", "enum": [ "required" ] }, { "type": "null" } ] }, "prior_experience": { "anyOf": [ { "type": "string", "enum": [ "required", "preferred", "not_needed" ] }, { "type": "null" } ] } }, "required": [ "study_fields", "study_fields_or_comparable", "study_levels", "min_semester", "enrolment", "german_level", "english_level", "other_languages", "hours_per_week", "start", "duration_months", "internship_type", "remote_days_max", "benefits", "cover_letter", "transcripts", "prior_experience" ], "additionalProperties": false }, { "type": "null" } ], "description": "Facts read from the posting by our extractor. Null or [] means the posting does not say, never \"no\". The whole object is null until the current posting text has been read." }, "posted_at": { "type": "string", "description": "When the employer published it, else when we first saw it." }, "first_seen_at": { "type": "string", "description": "When we first saw it. Used for paging and since." }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "slug", "title", "url", "apply_url", "company", "location", "types", "field", "sub_field", "working_mode", "salary", "skills", "languages", "sponsored", "details", "posted_at", "first_seen_at", "expires_at" ], "additionalProperties": false }, "JobList": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "slug": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "The job page on workingstudentjobs.de." }, "apply_url": { "type": "string", "format": "uri", "description": "Send applicants here. Redirects to the employer's application page (or our job page) and keeps your ref." }, "company": { "anyOf": [ { "type": "object", "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "The company page on workingstudentjobs.de." }, "logo_url": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] }, "website_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name", "slug", "url", "logo_url", "website_domain" ], "additionalProperties": false }, { "type": "null" } ] }, "location": { "anyOf": [ { "type": "object", "properties": { "city": { "type": "string" }, "city_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_code": { "type": "string" }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "latitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "longitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "city", "city_slug", "state", "state_code", "country_code", "postal_code", "latitude", "longitude" ], "additionalProperties": false }, { "type": "null" } ], "description": "Null for postings that name no city." }, "types": { "type": "array", "items": { "type": "string", "enum": [ "working_student", "internship" ] } }, "field": { "anyOf": [ { "type": "string", "enum": [ "tech", "finance", "marketing", "operations", "hr", "design", "legal", "engineering", "research", "consulting", "logistics", "healthcare", "education", "sales", "gastronomy-hospitality" ] }, { "type": "null" } ] }, "sub_field": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "working_mode": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ] }, "salary": { "anyOf": [ { "type": "object", "properties": { "min": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "currency": { "type": "string" }, "period": { "anyOf": [ { "type": "string", "enum": [ "hour", "day", "week", "month", "year" ] }, { "type": "null" } ] } }, "required": [ "min", "max", "currency", "period" ], "additionalProperties": false }, { "type": "null" } ], "description": "Null when the posting states no pay." }, "skills": { "type": "array", "items": { "type": "string" } }, "languages": { "type": "object", "properties": { "german": { "type": "string", "enum": [ "required", "optional", "not_required" ] }, "english": { "type": "string", "enum": [ "required", "not_required" ] } }, "required": [ "german", "english" ], "additionalProperties": false }, "sponsored": { "type": "boolean", "description": "A paid listing. Shown as a flag only." }, "details": { "anyOf": [ { "type": "object", "properties": { "study_fields": { "type": "array", "items": { "type": "string" } }, "study_fields_or_comparable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "True when the posting accepts \"a comparable degree\"." }, "study_levels": { "type": "array", "items": { "type": "string", "enum": [ "bachelor", "master", "phd" ] } }, "min_semester": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "enrolment": { "anyOf": [ { "type": "string", "enum": [ "required", "not_required" ] }, { "type": "null" } ] }, "german_level": { "anyOf": [ { "type": "object", "properties": { "level": { "anyOf": [ { "type": "string", "enum": [ "basic", "good", "fluent", "native" ] }, { "type": "null" } ] }, "cefr": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "CEFR level, only when the posting names one (\"B2\")." } }, "required": [ "level", "cefr" ], "additionalProperties": false }, { "type": "null" } ] }, "english_level": { "anyOf": [ { "type": "object", "properties": { "level": { "anyOf": [ { "type": "string", "enum": [ "basic", "good", "fluent", "native" ] }, { "type": "null" } ] }, "cefr": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "CEFR level, only when the posting names one (\"B2\")." } }, "required": [ "level", "cefr" ], "additionalProperties": false }, { "type": "null" } ] }, "other_languages": { "type": "array", "items": { "type": "string" } }, "hours_per_week": { "type": "object", "properties": { "min": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "min", "max" ], "additionalProperties": false }, "start": { "type": "object", "properties": { "asap": { "type": "boolean" }, "date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "\"YYYY-MM-DD\", or \"YYYY-MM\" when the posting names a month." } }, "required": [ "asap", "date" ], "additionalProperties": false }, "duration_months": { "type": "object", "properties": { "min": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "min", "max" ], "additionalProperties": false }, "internship_type": { "anyOf": [ { "type": "string", "enum": [ "mandatory", "voluntary", "both" ] }, { "type": "null" } ] }, "remote_days_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "benefits": { "type": "array", "items": { "type": "string" } }, "cover_letter": { "anyOf": [ { "type": "string", "enum": [ "required", "not_needed" ] }, { "type": "null" } ] }, "transcripts": { "anyOf": [ { "type": "string", "enum": [ "required" ] }, { "type": "null" } ] }, "prior_experience": { "anyOf": [ { "type": "string", "enum": [ "required", "preferred", "not_needed" ] }, { "type": "null" } ] } }, "required": [ "study_fields", "study_fields_or_comparable", "study_levels", "min_semester", "enrolment", "german_level", "english_level", "other_languages", "hours_per_week", "start", "duration_months", "internship_type", "remote_days_max", "benefits", "cover_letter", "transcripts", "prior_experience" ], "additionalProperties": false }, { "type": "null" } ], "description": "Facts read from the posting by our extractor. Null or [] means the posting does not say, never \"no\". The whole object is null until the current posting text has been read." }, "posted_at": { "type": "string", "description": "When the employer published it, else when we first saw it." }, "first_seen_at": { "type": "string", "description": "When we first saw it. Used for paging and since." }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "slug", "title", "url", "apply_url", "company", "location", "types", "field", "sub_field", "working_mode", "salary", "skills", "languages", "sponsored", "details", "posted_at", "first_seen_at", "expires_at" ], "additionalProperties": false } }, "links": { "type": "object", "properties": { "self": { "type": "string", "format": "uri" }, "next": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ], "description": "The next page. Null on the last page." } }, "required": [ "self", "next" ], "additionalProperties": false }, "meta": { "type": "object", "properties": { "limit": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "count": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "api_version": { "type": "string" } }, "required": [ "limit", "count", "api_version" ], "additionalProperties": false } }, "required": [ "data", "links", "meta" ], "additionalProperties": false }, "JobResponse": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "slug": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "The job page on workingstudentjobs.de." }, "apply_url": { "type": "string", "format": "uri", "description": "Send applicants here. Redirects to the employer's application page (or our job page) and keeps your ref." }, "company": { "anyOf": [ { "type": "object", "properties": { "name": { "type": "string" }, "slug": { "type": "string" }, "url": { "type": "string", "format": "uri", "description": "The company page on workingstudentjobs.de." }, "logo_url": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "null" } ] }, "website_domain": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "name", "slug", "url", "logo_url", "website_domain" ], "additionalProperties": false }, { "type": "null" } ] }, "location": { "anyOf": [ { "type": "object", "properties": { "city": { "type": "string" }, "city_slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "state_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "country_code": { "type": "string" }, "postal_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "latitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "longitude": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "city", "city_slug", "state", "state_code", "country_code", "postal_code", "latitude", "longitude" ], "additionalProperties": false }, { "type": "null" } ], "description": "Null for postings that name no city." }, "types": { "type": "array", "items": { "type": "string", "enum": [ "working_student", "internship" ] } }, "field": { "anyOf": [ { "type": "string", "enum": [ "tech", "finance", "marketing", "operations", "hr", "design", "legal", "engineering", "research", "consulting", "logistics", "healthcare", "education", "sales", "gastronomy-hospitality" ] }, { "type": "null" } ] }, "sub_field": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "working_mode": { "type": "string", "enum": [ "remote", "hybrid", "onsite" ] }, "salary": { "anyOf": [ { "type": "object", "properties": { "min": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "currency": { "type": "string" }, "period": { "anyOf": [ { "type": "string", "enum": [ "hour", "day", "week", "month", "year" ] }, { "type": "null" } ] } }, "required": [ "min", "max", "currency", "period" ], "additionalProperties": false }, { "type": "null" } ], "description": "Null when the posting states no pay." }, "skills": { "type": "array", "items": { "type": "string" } }, "languages": { "type": "object", "properties": { "german": { "type": "string", "enum": [ "required", "optional", "not_required" ] }, "english": { "type": "string", "enum": [ "required", "not_required" ] } }, "required": [ "german", "english" ], "additionalProperties": false }, "sponsored": { "type": "boolean", "description": "A paid listing. Shown as a flag only." }, "details": { "anyOf": [ { "type": "object", "properties": { "study_fields": { "type": "array", "items": { "type": "string" } }, "study_fields_or_comparable": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "description": "True when the posting accepts \"a comparable degree\"." }, "study_levels": { "type": "array", "items": { "type": "string", "enum": [ "bachelor", "master", "phd" ] } }, "min_semester": { "anyOf": [ { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, { "type": "null" } ] }, "enrolment": { "anyOf": [ { "type": "string", "enum": [ "required", "not_required" ] }, { "type": "null" } ] }, "german_level": { "anyOf": [ { "type": "object", "properties": { "level": { "anyOf": [ { "type": "string", "enum": [ "basic", "good", "fluent", "native" ] }, { "type": "null" } ] }, "cefr": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "CEFR level, only when the posting names one (\"B2\")." } }, "required": [ "level", "cefr" ], "additionalProperties": false }, { "type": "null" } ] }, "english_level": { "anyOf": [ { "type": "object", "properties": { "level": { "anyOf": [ { "type": "string", "enum": [ "basic", "good", "fluent", "native" ] }, { "type": "null" } ] }, "cefr": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "CEFR level, only when the posting names one (\"B2\")." } }, "required": [ "level", "cefr" ], "additionalProperties": false }, { "type": "null" } ] }, "other_languages": { "type": "array", "items": { "type": "string" } }, "hours_per_week": { "type": "object", "properties": { "min": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "min", "max" ], "additionalProperties": false }, "start": { "type": "object", "properties": { "asap": { "type": "boolean" }, "date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "\"YYYY-MM-DD\", or \"YYYY-MM\" when the posting names a month." } }, "required": [ "asap", "date" ], "additionalProperties": false }, "duration_months": { "type": "object", "properties": { "min": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "min", "max" ], "additionalProperties": false }, "internship_type": { "anyOf": [ { "type": "string", "enum": [ "mandatory", "voluntary", "both" ] }, { "type": "null" } ] }, "remote_days_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "benefits": { "type": "array", "items": { "type": "string" } }, "cover_letter": { "anyOf": [ { "type": "string", "enum": [ "required", "not_needed" ] }, { "type": "null" } ] }, "transcripts": { "anyOf": [ { "type": "string", "enum": [ "required" ] }, { "type": "null" } ] }, "prior_experience": { "anyOf": [ { "type": "string", "enum": [ "required", "preferred", "not_needed" ] }, { "type": "null" } ] } }, "required": [ "study_fields", "study_fields_or_comparable", "study_levels", "min_semester", "enrolment", "german_level", "english_level", "other_languages", "hours_per_week", "start", "duration_months", "internship_type", "remote_days_max", "benefits", "cover_letter", "transcripts", "prior_experience" ], "additionalProperties": false }, { "type": "null" } ], "description": "Facts read from the posting by our extractor. Null or [] means the posting does not say, never \"no\". The whole object is null until the current posting text has been read." }, "posted_at": { "type": "string", "description": "When the employer published it, else when we first saw it." }, "first_seen_at": { "type": "string", "description": "When we first saw it. Used for paging and since." }, "expires_at": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "id", "slug", "title", "url", "apply_url", "company", "location", "types", "field", "sub_field", "working_mode", "salary", "skills", "languages", "sponsored", "details", "posted_at", "first_seen_at", "expires_at" ], "additionalProperties": false }, "meta": { "type": "object", "properties": { "api_version": { "type": "string" } }, "required": [ "api_version" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false }, "CityList": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "slug": { "type": "string" }, "name": { "type": "string" }, "state_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "jobs": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "Live jobs in this city." } }, "required": [ "slug", "name", "state_code", "jobs" ], "additionalProperties": false } }, "meta": { "type": "object", "properties": { "count": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "api_version": { "type": "string" } }, "required": [ "count", "api_version" ], "additionalProperties": false } }, "required": [ "data", "meta" ], "additionalProperties": false }, "Error": { "type": "object", "properties": { "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "additionalProperties": false } }, "required": [ "error" ], "additionalProperties": false } }, "headers": { "ETag": { "description": "Send it back as If-None-Match to get a 304 when nothing changed.", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Requests allowed per minute.", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Requests left in the current minute.", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Unix time (seconds) when the current minute ends.", "schema": { "type": "integer" } } } } }