---
title: "Search Xing job listings"
method: GET
path: "/jobs/xing/search"
tags: ["jobs"]
---

# Search Xing job listings

`GET /jobs/xing/search`

## Request

- Base URL: `https://www.socialcrawl.dev/v1`
- URL: `https://www.socialcrawl.dev/v1/jobs/xing/search`
- Auth: API key in header `x-api-key`

Returns Xing job listings matching a keyword, with optional German-language location, date, employment type, career level, remote option, and minimum yearly salary filters. Rows often include a salary range. Page 2 with the cursor from page 1.

## Query parameters

- `query` string
- `location` string
- `date_posted` 'month' | 'week' | 'day'
- `employment_types` string
- `career_levels` string
- `remote_options` string
- `minimum_salary` integer
- `cursor` string

## Headers

- `Cache-Control` string
- `Idempotency-Key` string

## Response `200`

Successful response

- object
  - `success` boolean, required: Whether the request succeeded
  - `platform` string, required: Platform name
  - `endpoint` string, required: API endpoint path
  - `data` object, required: Platform-specific response data
    - `items` object[]: Array of canonical job wrappers ({ job })
      - `job` object: Nested object: job
        - `id` string: String at job.id
        - `title` string, nullable: String at job.title
        - `url` string, nullable: String at job.url
        - `company` object: Nested object: job.company
          - `id` string, nullable: String at job.company.id
          - `name` string, nullable: String at job.company.name
          - `url` string, nullable: String at job.company.url
          - `verified` boolean, nullable: Boolean at job.company.verified
        - `location` string, nullable: String at job.location
        - `listed_at` union: Union: string | integer | null
          - string
          - integer
        - `easy_apply` boolean, nullable: Boolean at job.easy_apply
        - `remote` string, nullable: String at job.remote
        - `employment_type` string, nullable: String at job.employment_type
        - `experience_level` string, nullable: String at job.experience_level
        - `description` string, nullable: String at job.description
        - `apply_url` string, nullable: String at job.apply_url
        - `ext` object, nullable: Nested object: job.ext
          - `is_promote` boolean, nullable: Boolean at job.ext.is_promote
          - `applicant_count` integer, nullable: Numeric at job.ext.applicant_count
          - `skills` string[], nullable: Array at job.ext.skills
          - `job_provider` string, nullable: String at job.ext.job_provider
          - `salary_min` integer, nullable: Numeric at job.ext.salary_min
          - `salary_max` integer, nullable: Numeric at job.ext.salary_max
          - `salary_currency` string, nullable: String at job.ext.salary_currency
          - `country_code` string, nullable: String at job.ext.country_code
          - `linkedin_company_name` string, nullable: String at job.ext.linkedin_company_name
          - `industries` string, nullable: String at job.ext.industries
          - `job_function` string, nullable: String at job.ext.job_function
          - `accepting_applications` boolean, nullable: Boolean at job.ext.accepting_applications
          - `board` string, nullable: String at job.ext.board
    - `next_cursor` string, nullable: Opaque cursor for the next page. Pass it back as a query parameter on endpoints that support pagination. Present only when the upstream reports more results.
    - `total` integer, nullable: Total number of matching results, when the upstream provides a count. Omitted otherwise.
    - `dropped` integer, required: Number of upstream list items dropped because they could not be repaired to the endpoint schema. Valid list responses include 0.
    - `_warnings` string[]: Non-fatal notices about this response (field-map drift, clamped computed values). Advisory only: its presence never means the request failed. Omitted entirely when there is nothing to report, so treat absent as 'no warnings'.
  - `credits_used` integer, required: Number of credits consumed
  - `credits_remaining` integer, nullable, required: Current account balance, or null when this response could not establish one. Free cache hits always return null because they do not establish an authoritative post-request balance. An idempotency replay also returns null when its current-balance lookup fails. It is never a fabricated zero, so a zero here means the account really is empty. The authoritative reading is the one on a billed response, which comes straight from the deduction.
  - `request_id` string, required: Unique request identifier for support
  - `cached` boolean, required: Whether the response was served from cache
  - `idempotent_replay` boolean: True only when this response is an idempotency replay
  - `meta` object: Optional. Present only when this call completed a pattern that one other call does more cheaply or in one step, at most once per pattern per API key per day. Send the header `X-SocialCrawl-Hints: off` to never receive it.
    - `hint` object: One suggestion: what to call instead and why, with the price when the suggested call costs more than the calls it replaces.
      - `code` string: creator_card | batch_profiles | search_multi | incremental_sync | comment_labels | search_repeat
      - `message` string: One sentence for a person or an agent to read.
      - `method` string: GET or POST.
      - `path` string: The call the hint points to.
  - `pagination` object, required: Cursor state for this page. Present on every list response.
    - `next_cursor` string, nullable, required: Opaque token to send back as `cursor` for the next page, or null at end-of-list. Pass it back verbatim; never decode or trim it.
    - `has_more` boolean, required: Explicit stop signal. Prefer this over inspecting next_cursor or comparing against total.
    - `page_size` integer, required: Number of items in THIS page.
    - `stopped_at` 'since' | 'known_id' | 'end' | 'null', nullable: Present only when the request sent `since` or `stop_at_id`. Why the walk stopped: `since` (this page reached a post older than the date), `known_id` (this page reached the post you already hold), `end` (the list ran out first), or null (not yet, keep walking with `next_cursor`).

## Other responses

- `400`: Invalid request - missing or malformed parameters
- `401`: Unauthorized - missing or invalid API key
- `402`: Payment required - the account balance is too low, or the calling key has spent its own per-key credit limit
- `404`: Not found - the endpoint does not exist, or the requested resource was not found upstream
- `405`: Method not allowed - wrong HTTP verb for this endpoint
- `409`: Conflict - an idempotent request is still in flight, its completed body exceeded the replay limit, or the cohort resource is not in a state that allows this operation
- `410`: Gone - the discover run's retention passed and its rows were deleted; start a new run
- `413`: Payload too large: the JSON request body exceeds the 1 MB size limit and is rejected before parsing, or a single cohort result cannot fit beneath the 1 MB response-page ceiling
- `422`: Idempotency payload mismatch - this Idempotency-Key was already used with a different request payload; or a discover request with async=false is over what one call can answer (NEEDS_ASYNC)
- `429`: Rate or concurrency limit exceeded. `RATE_LIMITED`: more than 600 requests in a 1-minute sliding window on this API key (headers `X-RateLimit-Limit`/`Remaining`/`Reset`; `Retry-After` is seconds until the window resets). `CONCURRENCY_LIMIT`: more than 50 simultaneous in-flight requests (headers `X-Concurrency-Limit`/`Remaining`; short static `Retry-After`). Both are unbilled. Honor `Retry-After`, then back off with jitter. See /docs/rate-limits.
- `500`: Internal server error - an immediate refund is attempted; credits_used reports the committed net charge and exact compensation is queued if that refund cannot commit
- `502`: Upstream error - the platform returned an error; an immediate refund is attempted and credits_used reports the committed net charge
- `503`: Service unavailable - the request is unbilled when rejected before deduction, otherwise an immediate refund is attempted and credits_used reports the committed net charge
- `504`: Gateway timeout - the request was still running close to the platform time limit and is answered as UPSTREAM_ERROR, the same code as 502. An immediate refund is attempted and credits_used reports the committed net charge. When details.retry_with is set, retryable is false and there is no Retry-After

---

[API](https://skmtc.dev/socialcrawl/apis/socialcrawl-api.md) · [All operations](https://skmtc.dev/socialcrawl/apis/socialcrawl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialcrawl/apis/socialcrawl-api/revisions/a0ad2511004a?raw)