timzinin-com Xing Jobs API

openapi: 3.2.0
info:
  title: Zinin M2M Hub Xing Jobs API
  description: Pay-per-call data & tool APIs
  version: 1.0.0
  x-guidance: 'Zinin M2M Hub — pay-per-call data & tool APIs for AI agents. Each POST /api/{slug} operation below is a distinct paid tool: call GET /api/{slug}/schema first for the exact input shape, then POST with a signed PAYMENT-SIGNATURE header (x402 v2, USDC — see x-payment-info per operation) or omit it to receive a 402 with full payment requirements in the PAYMENT-REQUIRED header. The same catalog is also available as MCP JSON-RPC tool bundles at POST /mcp/{bundle} — see GET /.well-known/x402 for the list of bundles.'
tags:
- name: Xing Jobs
paths:
  /api/xing-jobs:
    post:
      summary: XING Jobs (DACH) Scraper
      description: 'Walk xing.com''s own job sitemap and pull public job listings from Germany/Austria/Switzerland: title, company, location, employment type, posted date, industry, and (optionally) the full description — straight from each job''s own public page.'
      operationId: call_xing_jobs
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.020000'
        protocols:
        - x402: {}
        network: eip155:8453
        payTo: '0x409D32aD39C02BC9B23a8b2d447532ed801b12dE'
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              title: XING Jobs (DACH) Scraper input
              type: object
              schemaVersion: 1
              properties:
                max_items:
                  title: Max jobs to return
                  type: integer
                  description: How many job rows to deliver, at most. This Actor walks xing.com's own job sitemap and visits each candidate job page individually — a meaningful share of freshly-listed jobs are already withdrawn (HTTP 410) by the time they're visited, which is normal churn, not a fault. Extra candidates are attempted automatically to compensate, so this number is a target, not a guarantee.
                  default: 20
                  prefill: 3
                  minimum: 1
                  maximum: 200
                freshness_days:
                  title: Only jobs listed in the last N days
                  type: integer
                  description: Skip sitemap entries older than this many days. In practice xing.com's own sitemap entries are typically only minutes to hours old at any given time, so this rarely filters anything out.
                  default: 14
                  minimum: 1
                  maximum: 90
                keyword_filter:
                  title: Keyword filter (optional)
                  type: string
                  description: Optional case-insensitive substring match against each job's title, applied on this Actor's side after fetching the job's own page. xing.com's job search itself needs a browser session and is not used here — there is no server-side keyword search on this Actor. Leave empty to keep every job found.
                  editor: textfield
                fetch_full_description:
                  title: Include full description
                  type: boolean
                  description: Include the job's full description text in the output row. This Actor already fetches each job's own page to get any data at all (title, company, location...), so the description costs no extra request either way — this setting only controls whether it's kept in the row.
                  default: true
                sitemap_override_url:
                  title: Sitemap URL override (advanced/diagnostic)
                  type: string
                  description: 'Advanced: override the internal xing.com jobs sitemap URL this Actor walks. Leave empty to use the live xing.com jobs sitemap index. Mainly useful for diagnostics.'
                  editor: textfield
              required: []
      responses:
        '200':
          description: Actor run succeeded and payment settled
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                    description: Actor output items — shape is actor-specific (varies per tool); see this operation's own requestBody schema/description for what the underlying actor produces.
                  meta:
                    type: object
                    properties:
                      run_ms:
                        type: integer
                        description: Actor run duration in milliseconds
                      item_count:
                        type: integer
                        description: len(results)
                      settled:
                        type: boolean
                        description: Whether the x402 payment was confirmed settled by the facilitator
                      transaction:
                        type:
                        - string
                        - 'null'
                        description: On-chain settlement transaction hash, null if unsettled
                    required:
                    - run_ms
                    - item_count
                    - settled
                    - transaction
                required:
                - results
                - meta
        '400':
          description: Malformed PAYMENT-SIGNATURE header or request body
        '402':
          description: Payment required or invalid — see PAYMENT-REQUIRED header
        '409':
          description: Payment payload already used
        '502':
          description: Actor run failed
        '504':
          description: Actor run timed out
      tags:
      - Xing Jobs