iCIMS API: Live-Stellenausschreibungen von jeder iCIMS-Karriereseite abrufen

iCIMS stellt keine öffentliche Read-API für Stellenausschreibungen zur Verfügung, daher schreiben die meisten Teams einen einmaligen Parser pro Arbeitgeber. Dieses Repository zeigt Ihnen den Kurzweg: ein funktionierendes Python-Beispiel plus MCP-Installationsschritte für die iCIMS Careers API auf Apify.

Richten Sie es auf eine Karriereseite, erhalten Sie strukturierte Jobs zurück: Titel, Anforderungs-ID, Arbeitgeber, Standorte, Beschäftigungsart, Veröffentlichungs- und Aktualisierungsdaten, Gehalt, wenn der Arbeitgeber es veröffentlicht, und den Bewerbungslink. Es liest beide öffentlichen iCIMS-Oberflächen, die klassischen careers-{tenant}.icims.com-Portale und die modernen iCIMS-Karriereseiten, die auf der eigenen Domain des Arbeitgebers liegen, sodass Sie nicht wissen müssen, welche ein Arbeitgeber betreibt.

Holen Sie sich hier einen kostenlosen Apify-API-Schlüssel: https://apify.com?fpr=9n7kx3

Text-Walkthrough

Die icims api, die Sie suchen, ist dieser Actor. Sie geben ihm eine Sache, eine Karriereseite, entweder als URL in startUrls oder als einfachen Firmennamen in companies, und er ermittelt, welche iCIMS-Oberfläche dieser Arbeitgeber verwendet, bevor er etwas abruft. Jede aktive Stellenausschreibung kommt als eine Zeile zurück: title, id (die eigene Anforderungsnummer des Arbeitgebers), organization, locations_derived, employment_type, date_posted, date_updated, description_text, salary_raw und apply_url. Die Feldnamen entsprechen bewusst den gängigen Job-Feed-Konventionen, sodass Zeilen ohne Mapping-Ebene in eine bestehende Pipeline fallen.

Der Teil, der echtes Geld spart, ist newerThan. Setzen Sie es auf 7d und der Actor filtert anhand der letzten Änderungsdaten der Seite, bevor er eine Jobseite öffnet, sodass Ihnen eine tägliche Abfrage eines Arbeitgebers mit 400 offenen Stellen nur die wenigen kostet, die sich tatsächlich bewegt haben. Fügen Sie includeDetails: false hinzu und Sie erhalten einen reinen Änderungs-Feed: URL, ID, Titel, Daten. Das ist genau die Form hinter dem Rezept Track New iCIMS Job Postings Every Day, das ein Recruiting-Team zeitgesteuert ausführen und in Slack leiten kann.

Seiten, die fehlschlagen, bleiben nicht still. Ein toter Tenant, ein IP-beschränktes Portal oder eine Domain, die sich doch nicht als iCIMS herausstellt, wird als gekennzeichnete Fehlerzeile mit einem error_code zurückgegeben, sodass ein automatisierter Job zwischen „keine neuen Jobs“ und „dieser Arbeitgeber ist von iCIMS weg“ unterscheiden kann.

Related MCP server: JobDataLake MCP Server

Schnellstart

git clone https://github.com/johnisanerd/Apify-iCIMS-Careers-API.git
cd Apify-iCIMS-Careers-API
uv sync
cp .env.example .env

Fügen Sie Ihr Apify-Token in .env ein, dann:

uv run icims-api-example.py

Dieser erste Lauf zieht fünf Jobs von einer Karriereseite mit Textbeschreibungen, was ihn nahezu kostenlos hält. Jede Eingabe in icims-api-example.py ist kommentiert, sodass Sie sie bewusst erweitern können.

Rezepte

Fertige Eingabesets, jede eine Live-Seite im Apify Store, die Sie ohne Code schreiben ausführen können:

Zeitplan-Tipp: Jedes dieser Rezepte kann zeitgesteuert ausgeführt werden. Öffnen Sie in der Apify Console den Actor, klicken Sie auf Schedules und fügen Sie einen täglichen oder wöchentlichen Cron-Job hinzu. Kombinieren Sie einen Zeitplan mit newerThan: "24h" und includeDetails: false und Sie haben einen Job-Änderungs-Feed, der nur einen Bruchteil eines vollständigen Crawls kostet.

Eingabeparameter

Ausgabefelder

Jede Zeile trägt result_type, entweder job oder error.

url, id, title, organization, organization_url, description_text, description_html, description_markdown, employment_type, locations_derived, remote_derived, date_posted, date_updated, date_validthrough, salary_raw, category, additional_fields, apply_url, latitude, longitude, tenant, source, source_type, source_surface, source_domain, source_url, scraped_at, und bei Fehlerzeilen error_code und error_message.

Der Datensatz liefert zwei Ansichten. Overview ist die vollständige Tabelle. Changes ist die Überwachungsansicht: URL, date_updated, date_posted, title, die einzige Form, die Sie benötigen, wenn Sie Läufe vergleichen.

Installation in Claude Cowork Desktop

Cowork ist der Automatisierungsmodus der Desktop-App. Um ihr die iCIMS-API als Tool zur Verfügung zu stellen, fügen Sie den Apify MCP-Server als Connector hinzu.

1. Öffnen Sie die Claude-Desktop-App und gehen Sie zu Settings > Connectors (oder Settings > Developer > Edit Config, um claude_desktop_config.json direkt zu bearbeiten).

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Fügen Sie den Apify MCP-Server hinzu, der nur mit diesem Actor vorinstalliert ist:

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api"
      ]
    }
  }
}

3. Starten Sie die App neu. Wenn Cowork das Tool zum ersten Mal aufruft, schließen Sie den OAuth-Prompt in Ihrem Browser ab, oder fügen Sie Ihr Apify-API-Token in den Connector-Einstellungen hinzu, um OAuth zu überspringen.

4. Bestätigen Sie in einem Cowork-Chat, dass das Tool verfügbar ist, und bitten Sie es, die iCIMS-API auszuführen.

Laden Sie die Desktop-App herunter und starten Sie eine kostenlose Testversion: https://claude.ai/referral/uIlpa7nPLg Weitere Hilfe: https://docs.apify.com/platform/integrations/claude-desktop

Installation in Claude Code

Claude Code ist das Befehlszeilentool. Fügen Sie den MCP-Server des Actors mit einem Befehl hinzu:

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api"

Um ein Token anstelle von Browser-OAuth zu verwenden:

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

Überprüfen Sie dann mit claude mcp list oder führen Sie /mcp innerhalb einer Sitzung aus. Bitten Sie Claude Code, die iCIMS-API aufzurufen.

Testen Sie Claude Code kostenlos: https://claude.ai/referral/uIlpa7nPLg Claude Code MCP-Dokumentation: https://code.claude.com/docs/en/mcp

Installation in Claude (Website)

Auf claude.ai fügen Sie Apify als Connector hinzu und aktivieren dann nur das Tool dieses Actors.

1. Gehen Sie zu Settings > Connectors > Browse connectors und suchen Sie nach Apify MCP server. Installieren Sie es (aktivieren oder aktualisieren Sie es, wenn Sie dazu aufgefordert werden).

2. Authentifizieren Sie sich beim Verbinden mit Ihrem Apify-API-Token und aktivieren Sie das Tool johnvc/icims-careers-api.

3. Öffnen Sie in einem beliebigen Chat + > Connectors und schalten Sie Apify ein.

4. Alternativ wählen Sie Add custom connector und fügen Sie die vollständige MCP-URL https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api ein, wobei Sie bei Aufforderung OAuth verwenden.

5. Bitten Sie Claude, die iCIMS-API auszuführen.

Öffnen Sie Claude im Web: https://claude.ai

Installation in Cursor

Cursor liest MCP-Server aus einer Projektdatei unter .cursor/mcp.json.

1. Erstellen Sie in Ihrem Projekt .cursor/mcp.json:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api"
    }
  }
}

2. Wenn Sie Token-Auth gegenüber Browser-OAuth bevorzugen, fügen Sie einen Header hinzu:

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Öffnen Sie Cursor > Settings > MCP und bestätigen Sie, dass der apify-Server verbunden ist (grüner Punkt).

4. Bitten Sie in Composer oder Chat Cursor, die iCIMS-API aufzurufen.

Neu bei Cursor? Holen Sie es sich hier: https://cursor.com/referral?code=XQP4VBLI3NNX

Installation in ChatGPT

ChatGPT verbindet sich über den Entwicklermodus mit dem Apify MCP-Server (verfügbar für ChatGPT Pro, Plus, Business, Enterprise und Education-Pläne).

1. Klicken Sie auf Ihr Profilsymbol und gehen Sie dann zu Settings > Apps. Wenn Sie keine Schaltfläche Create app sehen, öffnen Sie Advanced settings und aktivieren Sie Developer mode.

2. Klicken Sie auf Create app und füllen Sie das Formular aus:

   • Name: Apify

   • MCP Server URL: https://mcp.apify.com/?tools=actors,docs,johnvc/icims-careers-api

   • Authentication: OAuth

3. Klicken Sie auf Create und autorisieren Sie die Verbindung mit Apify.

4. Um die App in einer Unterhaltung zu verwenden, klicken Sie auf + im Chat, wählen Sie Developer mode und dann Apify.

Weitere Hilfe: https://docs.apify.com/platform/integrations/mcp

FAQ

Gibt es eine offizielle iCIMS-API für Stellenausschreibungen?
Keine öffentliche, für die man sich anmelden kann. iCIMS verkauft Integrationszugang nur an seine eigenen Kunden. Wenn Sie also Ausschreibungen eines Arbeitgebers benötigen, für den Sie nicht arbeiten, ist die öffentliche Karriereseite die einzige Oberfläche, die Ihnen zur Verfügung steht. Dieser Actor liest diese Oberfläche aus und liefert Ihnen die gleichen strukturierten Felder, die eine API bieten würde.

Funktioniert er mit beiden Arten von iCIMS-Seiten?
Ja. Sowohl klassische Portale auf icims.com als auch moderne iCIMS-Karriereseiten, die auf der eigenen Domain des Arbeitgebers gehostet werden, werden unterstützt. Der Actor prüft die Domain und wählt automatisch den richtigen Pfad, sodass Sie einfach eine URL übergeben können, ohne sich Gedanken machen zu müssen.

Wie kann ich Stellenausschreibungen scrapen, ohne die Seite zu überlasten?
Verwenden Sie newerThan. Beim klassischen Portal wird der Filter auf die Änderungsdaten der Seite selbst angewendet, bevor eine einzelne Stellenanzeige geöffnet wird. Eine unveränderte Stelle wird also nie abgerufen. Mit includeDetails: false wird pro Seite nur eine Seite aufgerufen.

Kann ich dies als ATS-API in meinem eigenen Produkt verwenden?
Das tun die meisten Nutzer damit. Rufen Sie es aus Ihrem Backend mit dem Apify-Client auf, oder aus n8n, oder über MCP von einem Agenten. Die Ausgabefeldnamen folgen gängigen Job-Feed-Konventionen, sodass ein bereits vorhandener Normalisierer die Daten in der Regel unverändert übernehmen kann.

Was passiert, wenn eine Karriereseite tot oder eingeschränkt ist?
Sie erhalten eine Zeile mit result_type: "error" und einem error_code wie tenant_not_found, ip_gated oder not_icims, anstatt eines abgestürzten Runs. Ein Watchlist-Job kann darauf reagieren: Der Arbeitgeber ist von iCIMS weggezogen oder der Mandant wurde stillgelegt.

Wie viel kostet ein Run?
Die Preisgestaltung finden Sie auf der Actor-Seite. Die Abrechnung erfolgt pro ausgelieferter Job-Zeile. Ein Monitoring-Run, der zwei geänderte Jobs findet, kostet also zwei Zeilen, nicht einen vollständigen Crawl. Prüfen Sie dort die aktuellen Preise, anstatt einer in eine README kopierten Zahl zu vertrauen.

Auf welche Felder kann ich mich verlassen?
url, id, title, organization und date_updated sind in jeder Job-Zeile vorhanden. Gehalt, Kategorie und Koordinaten hängen davon ab, was der Arbeitgeber veröffentlicht, und können daher null sein.

Nutzer suchen auch nach

icims api, icims ats, icims jobs, ats api, job data api, scrape job postings, applicant tracking system api, job posting api, companies that use icims, icims api documentation, icims mcp server, track new icims job postings, career site job data, job listings api

n8n-Integration

Verfügbar als n8n-Community-Node, n8n-nodes-icims-careers-api. In n8n: Einstellungen, Community-Nodes, n8n-nodes-icims-careers-api installieren, dann in jedem Workflow verwenden (funktioniert auch als AI Agent Tool).

Mehr

• Actor im Apify Store: https://apify.com/johnvc/icims-careers-api?fpr=9n7kx3

• Kostenloser Apify-Account: https://apify.com?fpr=9n7kx3

• Apify Python-Client-Dokumentation: https://docs.apify.com/api/client/python/

• Apify MCP-Dokumentation: https://docs.apify.com/platform/integrations/mcp

• uv: https://docs.astral.sh/uv/

Letzte Aktualisierung: 2026.08.17