API-Zugang einrichten und nutzen
Integriere Resell Scan über die vorhandene REST API. Du erstellst einen API-Schlüssel, nutzt Bearer Auth und arbeitest mit Sammlungen, Produkten und Batch-Analysen.
In diesem Guide
Was die API abdeckt
Die API bietet Zugriff auf Sammlungen, Produkte, manuelle Felder und Batch-Analysen. Sie ersetzt nicht den WaWi-KI-Endpunkt: Dieser hat eigene URLs und einen eigenen Header.
API-Key im Dashboard erstellen
Öffne „Entwickler“ -> „API Zugang“ und erstelle einen neuen API-Schlüssel mit Name, optionaler Beschreibung und optionalem Ablaufdatum.
Schlüssel sofort sichern
Requests mit Bearer Token authentifizieren
Sende den API-Key in jedem Request im Authorization-Header. Die API antwortet im JSON-Format.
curl https://app.resell-scan.de/api/v1/collections \
-H "Authorization: Bearer $RESELL_SCAN_API_KEY" \
-H "Content-Type: application/json"const response = await fetch('https://app.resell-scan.de/api/v1/collections?limit=20', {
headers: {
Authorization: `Bearer ${process.env.RESELL_SCAN_API_KEY}`,
'Content-Type': 'application/json',
},
});
if (!response.ok) {
throw new Error(`Resell Scan API error: ${response.status}`);
}
const data = await response.json();Rate Limit und Rechte
Sammlungen und Produkte abrufen
Starte meist mit den Sammlungen, wähle eine collectionId und lade anschließend Produkte oder manuelle Felder.
/api/v1/collectionsSammlungen abrufen, optional mit page, limit und search.
/api/v1/collections/{collectionId}Eine Sammlung im Detail abrufen.
/api/v1/collections/{collectionId}/productsProdukte einer Sammlung abrufen, optional mit include_images und Datumsfiltern.
/api/v1/collections/{collectionId}/manual-fieldsManuelle Felder einer Sammlung abrufen.
curl "https://app.resell-scan.de/api/v1/collections/{collectionId}/products?include_images=true&limit=50" \
-H "Authorization: Bearer $RESELL_SCAN_API_KEY"Produkte anlegen oder analysieren
Für bestehende Produkte startest du /products/analyze. Für neue Produkte mit Bildern nutzt du /products/createAndAnalyze.
/api/v1/productsProdukte ohne Analyse anlegen.
/api/v1/products/analyzeAnalyse für bestehende Produkt-IDs starten.
/api/v1/products/createAndAnalyzeProdukte mit Bildern anlegen und direkt analysieren.
{
"collectionId": "00000000-0000-0000-0000-000000000000",
"products": [
{
"images": [
{
"url": "https://example.com/product-front.jpg",
"fileName": "product-front.jpg",
"removeBackground": true
}
],
"manual_fields": {
"Einkaufspreis": 12.5
}
}
]
}Pflichtfelder gelten auch per API
Status und Ergebnisse abrufen
Nach dem Start bekommst du eine batchId. Damit fragst du Status und später die Ergebnisse ab.
/api/v1/products/analyze/{batchId}Status einer Batch-Analyse abrufen.
/api/v1/products/analyze/{batchId}/resultsErgebnisse einer Batch-Analyse abrufen.