{"openapi":"3.1.0","info":{"title":"checkdasinserat.de API","version":"1.0.0","description":"Programmatischer Zugang zum Inserat-Check: Service-Informationen abrufen und bis zu 10 Fahrzeug-Inserate von mobile.de, AutoScout24 oder Kleinanzeigen zur manuellen Prüfung durch einen Kfz-Experten einreichen."},"servers":[{"url":"https://checkdasinserat.de"}],"security":[],"paths":{"/api/v1/service":{"get":{"operationId":"getCheckServiceInfo","summary":"Liefert Metadaten zum Check-Service: unterstützte Portale, Paketgrößen und aktuelle Preise, Kapazität, Lieferzeit und ob die Agenten-API gerade aktiviert ist. Rein lesend, ohne Auth.","x-readOnlyHint":true,"responses":{"200":{"description":"Aktuelle Service-Informationen: unterstützte Portale, Paketgrößen mit Preisen, Kapazität und Lieferzeit.","content":{"application/json":{"schema":{"type":"object","properties":{"service":{"type":"string"},"tagline":{"type":"string"},"description":{"type":"string"},"supported_hosts":{"type":"array","items":{"type":"string"}},"max_links_per_request":{"type":"integer"},"packages":{"type":"array","items":{"type":"object","properties":{"pkg":{"type":"integer","enum":[1,3,5,10]},"name":{"type":"string"},"price_eur":{"type":"number"},"per_listing_note":{"type":"string"}}}},"price_arm":{"type":"string","enum":["a","b"]},"currency":{"type":"string"},"vat_note":{"type":"string"},"capacity_per_week":{"type":"integer"},"delivery_werktage":{"type":"integer"},"response_hours":{"type":"integer"},"agent_api_enabled":{"type":"boolean"},"provider":{"type":"string"},"human_url":{"type":"string","format":"uri"},"checks_endpoint":{"type":"string","format":"uri"}}},"example":{"service":"checkdasinserat.de","tagline":"Inserat-Check für Käufer","description":"Wir prüfen das Inserat, nicht die Fahrzeughistorie. Ein Kfz-Experte öffnet dein Inserat von mobile.de, AutoScout24 oder Kleinanzeigen von Hand und liefert einen Report mit Score, Ampel und Handlungsempfehlung.","supported_hosts":["mobile.de","suchen.mobile.de","www.mobile.de","autoscout24.de","www.autoscout24.de","kleinanzeigen.de","www.kleinanzeigen.de"],"max_links_per_request":10,"packages":[{"pkg":1,"name":"1 Inserat","price_eur":7,"per_listing_note":"entspricht 7 € pro Inserat"},{"pkg":3,"name":"3 Inserate","price_eur":18,"per_listing_note":"entspricht 6 € pro Inserat"},{"pkg":5,"name":"5 Inserate","price_eur":28,"per_listing_note":"entspricht 5,60 € pro Inserat"},{"pkg":10,"name":"10 Inserate","price_eur":49,"per_listing_note":"entspricht 4,90 € pro Inserat"}],"price_arm":"a","currency":"EUR","vat_note":"Gemäß § 19 UStG wird keine Umsatzsteuer berechnet.","capacity_per_week":8,"delivery_werktage":3,"response_hours":24,"agent_api_enabled":true,"provider":"Carovo GmbH","human_url":"https://checkdasinserat.de/check","checks_endpoint":"https://checkdasinserat.de/api/v1/checks"}}}}}}},"/api/v1/checks":{"post":{"operationId":"submitListingCheck","summary":"Reicht bis zu 10 Inserats-Links (mobile.de, AutoScout24, Kleinanzeigen) zur manuellen Prüfung ein. Löst eine Bestätigungsmail aus; erst nach Klick auf den Bestätigungslink wird die Anfrage bearbeitet. Es entsteht keine Zahlungspflicht durch diesen Aufruf.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["urls","email"],"properties":{"urls":{"type":"array","items":{"type":"string","format":"uri"},"maxItems":10,"description":"Ein bis 10 vollständige Inserats-Links (keine Ergebnislisten) von mobile.de, autoscout24.de oder kleinanzeigen.de. Jeder Link muss auf ein einzelnes Inserat zeigen."},"pkg":{"type":"integer","enum":[1,3,5,10],"description":"Optionale gewünschte Paketgröße. Wird nur übernommen, wenn sie größer ist als die Paketgröße, die sich automatisch aus der Anzahl der übergebenen Links ergibt — kleiner wählen geht nicht."},"email":{"type":"string","format":"email","description":"E-Mail-Adresse, an die der Report geschickt wird, nach Bestätigung per Klick."},"src":{"type":"string","description":"Freies Herkunfts-Tag (z. B. Name des aufrufenden Assistenten) für die Statistik."}}},"example":{"urls":["https://suchen.mobile.de/fahrzeuge/details.html?id=123456789","https://www.autoscout24.de/angebote/beispiel-inserat-123456"],"pkg":3,"email":"kaeufer@example.de","src":"chatgpt"}}}},"responses":{"202":{"description":"Anfrage angenommen, aber noch nicht bestätigt. Es entsteht keine Zahlungspflicht, bevor der Nutzer den Bestätigungslink in der E-Mail anklickt.","content":{"application/json":{"example":{"status":"pending_confirmation","request_id":"a1b2c3d4e5f60718293a4b5c6d7e8f9a","pkg":3,"price_eur":18,"currency":"EUR","price_arm":"a","provider":"Carovo GmbH","price_is_total":true,"vat_note":"Gemäß § 19 UStG wird keine Umsatzsteuer berechnet.","delivery":"PDF per E-Mail, in der Regel innerhalb von 3 Werktagen nach Zahlung","capacity_note":"Wir prüfen von Hand: aktuell 8 Checks pro Woche, Bearbeitung in der Reihenfolge des Eingangs.","withdrawal_info_url":"https://checkdasinserat.de/widerruf","terms_url":"https://checkdasinserat.de/agb","imprint_url":"https://checkdasinserat.de/impressum","confirm_required":true,"human_url":"https://checkdasinserat.de/check","next_step":"Wir haben eine Bestätigungsmail an die angegebene Adresse geschickt. Erst nach dem Klick des Nutzers auf den Bestätigungslink wird die Anfrage bearbeitet. Es entsteht keine Zahlungspflicht."}}}},"409":{"description":"Wöchentliche Prüfkapazität oder tägliches Agenten-Limit erschöpft.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://checkdasinserat.de/problems/capacity-reached","title":"Kapazität erreicht","status":409,"detail":"Diese Woche sind alle Prüfplätze vergeben.","instance":"/api/v1/checks","human_url":"https://checkdasinserat.de/check"}}}},"422":{"description":"Eingabe konnte nicht verarbeitet werden (nicht unterstütztes Portal, Ergebnisliste statt Inserat, ungültige E-Mail oder zu viele Links).","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://checkdasinserat.de/problems/unsupported-portal","title":"Portal nicht unterstützt","status":422,"detail":"Diesen Link können wir nicht zuordnen. Wir prüfen Inserate von mobile.de, AutoScout24 und Kleinanzeigen — füg bitte den vollständigen Link aus der Adresszeile ein.","instance":"/api/v1/checks","human_url":"https://checkdasinserat.de/check"}}}},"429":{"description":"Rate-Limit pro IP überschritten.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://checkdasinserat.de/problems/rate-limited","title":"Zu viele Anfragen","status":429,"detail":"Du hast das Limit für Anfragen erreicht. Versuch es später erneut.","instance":"/api/v1/checks","human_url":"https://checkdasinserat.de/check"}}},"headers":{"Retry-After":{"description":"Sekunden bis zum nächsten erlaubten Versuch.","schema":{"type":"integer"}}}},"503":{"description":"Die programmatische Einreichung ist aktuell deaktiviert.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://checkdasinserat.de/problems/service-disabled","title":"Agenten-API deaktiviert","status":503,"detail":"Die programmatische Einreichung ist aktuell deaktiviert. Nutze den Deep-Link.","instance":"/api/v1/checks","human_url":"https://checkdasinserat.de/check"}}}}}}}},"components":{"schemas":{"Problem":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"human_url":{"type":"string","format":"uri"}}}}},"externalDocs":{"url":"https://checkdasinserat.de/api-docs"}}