Qualit.ly
Qualit.ly
StartseiteDiscord BotSuche

API-Referenz

Qualit.ly API

Produktdaten, QC-Bilder und Metadaten von Weidian, Taobao und 1688. Bearer-Token-Authentifizierung, großzügige Ratenlimits, gestufte Pläne.

API-Schlüssel erhalten

Erste Schritte

Alle Anfragen gehen an https://backend.qualit.ly/api/v1. Drei Schritte:

1

Schlüssel holen

Melde dich an und erstelle einen API-Schlüssel im Entwickler-Dashboard.

2

Anfrage senden

Sende deinen Schlüssel als Bearer-Token im Authorization-Header.

3

Daten erhalten

Erhalte JSON-Antworten mit Produktdaten und QC-Bildern.

Schnelles Beispiel

bash
curl -H "Authorization: Bearer qc_live_YOUR_KEY" \
  https://backend.qualit.ly/api/v1/products/weidian/1234567890

Authentifizierung

Füge einen gültigen API-Schlüssel im Authorization-Header mit dem Bearer-Schema ein.

Authorization: Bearer qc_live_xxxxxxxxxxxxxxxxxxxxxxxx

Schlüsselformat

Schlüssel folgen qc_{mode}_{random}, wobei mode entweder live oder test ist und random aus 32 kryptografisch zufälligen Zeichen besteht.

Schlüssel werden nur einmal bei der Erstellung angezeigt. Wir speichern nur den SHA-256-Hash, verlorene Schlüssel können daher nicht wiederhergestellt werden.

IP-Allowlist

Beschränke Schlüssel optional über das Entwickler-Dashboard auf bestimmte IPs oder CIDR-Bereiche. Anfragen von nicht gelisteten IPs erhalten einen 403. Eine leere Allowlist erlaubt alle IPs.

Ratenlimits

Zwei Kontingente: pro Minute und pro Monat. Die Limits hängen von deiner Kontostufe ab und gelten für alle Schlüssel.

Stufe
/ Minute
/ Monat
Basic
30
1,000
Early Adopter
40
3,000
Pro
300
25,000
Pro+
1,000
500,000

Bei Ratenbegrenzung

Die API gibt einen 429 mit einem Retry-After-Header zurück.

json
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Per-minute limit exceeded",
    "retry_after": 12
  }
}

Fehler

Alle Fehler geben ein Top-Level-Objekt error mit code und message zurück.

json
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Product not found"
  }
}
400BAD_REQUESTUngültiger Anfragetext oder ungültige Parameter.
401INVALID_KEYFehlender, fehlerhafter oder unbekannter API-Schlüssel.
401REVOKED_KEYDer API-Schlüssel wurde im Dashboard widerrufen.
403IP_NOT_AUTHORIZEDDie Anfrage-IP ist nicht in der Allowlist des Schlüssels.
403FORBIDDENDeine Stufe hat keinen Zugriff auf diesen Endpunkt.
404NOT_FOUNDDie angeforderte Ressource existiert nicht.
429RATE_LIMITEDMinutenlimit überschritten, siehe Retry-After.
429QUOTA_EXCEEDEDMonatskontingent erschöpft; wird beim UTC-Monatswechsel zurückgesetzt.
500INTERNALServerfehler. Erneut versuchen oder Support kontaktieren.

Endpunkte

Basis: https://backend.qualit.ly/api/v1. Shops: weidian, taobao, 1688.

GET/products/:storefront/:listingIdBasic

Ein einzelnes Produkt nach Shop und Listing-ID abrufen. Gibt Metadaten und bis zu 5 QC-Vorschau-Thumbnails zurück.

Parameter

storefronterforderlich

Eines von: weidian, taobao, 1688

listingIderforderlich

Die Produkt-Listing-ID aus dem Shop

Beispiel

bash
curl -H "Authorization: Bearer qc_live_YOUR_KEY" \
  https://backend.qualit.ly/api/v1/products/weidian/7231368393

Antwort

json
{
  "data": {
    "id": 482910,
    "storefront": "weidian",
    "listing_id": "7231368393",
    "name": "AJ1 Retro High OG",
    "price": "¥470.00",
    "pic_url": "https://cdn.qualit.ly/covers/...",
    "product_url": "https://weidian.com/item.html?itemID=7231368393",
    "qc_count": 12,
    "qc_preview": [
      "https://cdn.qualit.ly/qc/...",
      "https://cdn.qualit.ly/qc/..."
    ]
  }
}
POST/products/batchPro+

Mehrere Produkte in einer einzigen Anfrage abrufen (bis zu 100). Jedes Ergebnis ist unabhängig, ein fehlendes Produkt lässt den Batch also nicht scheitern.

Anfragetext

json
{
  "items": [
    { "storefront": "weidian", "listing_id": "7231368393" },
    { "storefront": "taobao", "listing_id": "123456789" }
  ]
}

Beispiel

bash
curl -X POST \
  -H "Authorization: Bearer qc_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"storefront":"weidian","listing_id":"7231368393"}]}' \
  https://backend.qualit.ly/api/v1/products/batch

Antwort

json
{
  "results": [
    {
      "data": {
        "id": 482910,
        "storefront": "weidian",
        "listing_id": "7231368393",
        "name": "AJ1 Retro High OG",
        "price": "¥470.00",
        "qc_count": 12,
        "qc_preview": ["..."]
      }
    },
    { "error": { "code": "NOT_FOUND" } }
  ]
}
GET/qc/:storefront/:listingIdBasic

QC-Metadaten und die ersten 3 Thumbnail-Bild-URLs eines Produkts abrufen.

Beispiel

bash
curl -H "Authorization: Bearer qc_live_YOUR_KEY" \
  https://backend.qualit.ly/api/v1/qc/weidian/7231368393
json
{
  "data": {
    "storefront": "weidian",
    "listing_id": "7231368393",
    "qc_count": 12,
    "thumbnails": ["..."]
  }
}
GET/qc/:id/imagesPro+

Vollständige Liste der QC-Bilder. Akzeptiert eine numerische Produkt-ID oder einen ?url=-Abfrageparameter für URL-basierte Suchen.

Nach Produkt-ID

bash
curl -H "Authorization: Bearer qc_live_YOUR_KEY" \
  https://backend.qualit.ly/api/v1/qc/482910/images

Nach URL

bash
curl -H "Authorization: Bearer qc_live_YOUR_KEY" \
  "https://backend.qualit.ly/api/v1/qc/0/images?url=https://weidian.com/item.html?itemID=7231368393"

Antwort

json
{
  "data": {
    "id": 482910,
    "storefront": "weidian",
    "listing_id": "7231368393",
    "qc_count": 12,
    "images": [
      "https://cdn.qualit.ly/qc/img1.jpg",
      "https://cdn.qualit.ly/qc/img2.jpg",
      "..."
    ]
  }
}
Nur Pro+. Der ?url=-Parameter akzeptiert vollständige Produkt-URLs von Weidian, Taobao, 1688 und unterstützten Agenten.
GET/meBasic

Gibt deine Kontoinfos, den für die Anfrage verwendeten Schlüssel und deine aktuelle Stufe zurück.

Beispiel

bash
curl -H "Authorization: Bearer qc_live_YOUR_KEY" \
  https://backend.qualit.ly/api/v1/me
json
{
  "user": { "id": 12345, "username": "you" },
  "key": { "id": 1, "mode": "live" },
  "tier": "basic"
}
GET/usageBasic

Prüfe deine aktuelle Nutzung von Ratenlimit und Kontingent. Gibt Minuten- und Monatszähler mit Reset-Zeitstempeln zurück. Der Aufruf selbst verbraucht 1 Anfrage aus beiden Zählern.

Beispiel

bash
curl -H "Authorization: Bearer qc_live_YOUR_KEY" \
  https://backend.qualit.ly/api/v1/usage

Antwort

json
{
  "tier": "pro_plus",
  "key": { "id": 7, "mode": "live" },
  "minute": {
    "limit": 1000,
    "used": 12,
    "remaining": 988,
    "reset_in_seconds": 37,
    "reset_at": "2026-04-17T18:42:00.000Z"
  },
  "month": {
    "limit": 500000,
    "used": 1843,
    "remaining": 498157,
    "reset_in_seconds": 1159200,
    "reset_at": "2026-05-01T00:00:00.000Z",
    "bucket": 202604
  }
}

Felder

tier

Eines von: basic, early_adopter, pro, pro_plus, custom

limit / remaining

null auf der Custom-Stufe (unbegrenzt)

used

Im aktuellen Zeitfenster gezählte Anfragen. Der Minutenzähler wird alle 60 s zurückgesetzt; der Monatszähler beim UTC-Monatswechsel.

reset_at

ISO-8601-UTC-Zeitstempel

bucket

Interner JJJJMM-Schlüssel für den Monatszähler

Fehler

Wie bei anderen /api/v1/*-Routen:401 INVALID_KEY /REVOKED_KEY,403 IP_NOT_AUTHORIZED,429 RATE_LIMITED /QUOTA_EXCEEDED.

Code-Beispiele

Schnellstart-Snippets in beliebten Sprachen.

const res = await fetch(
  'https://backend.qualit.ly/api/v1/products/weidian/7231368393',
  { headers: { Authorization: 'Bearer ' + process.env.QUALITLY_KEY } }
);
const { data } = await res.json();
console.log(data.name, data.qc_count, 'QC images');

MCP-Server

Die Qualit.ly-API ist als Model-Context-Protocol-(MCP)-Server verfügbar. Verbinde ihn mit Claude Desktop, Cursor, VS Code oder einem beliebigen MCP-kompatiblen Client und frage Produkte, QC-Bilder und Nutzungsdaten direkt aus deinem KI-Assistenten ab, ohne manuelles HTTP. Es gelten derselbe API-Schlüssel, dieselben Ratenlimits und Stufenregeln.

Server-URL

https://backend.qualit.ly/api/mcp

Transport

StreamableHTTP (POST)

Authentifizierung

Authorization: Bearer qc_live_…

Verfügbare Tools

Tool
Beschreibung
Stufe
get_product
Ein Produkt nach Shop und Listing-ID abrufen
Basic
get_products_batch
Bis zu 100 Produkte in einem Aufruf abrufen
Pro+
get_qc
QC-Anzahl und 3 Thumbnail-URLs
Basic
get_qc_images
Vollständige CDN-Bildliste (nach ID oder URL)
Pro+
get_me
Aktueller Schlüssel, Nutzer und Stufe
Basic
get_usage
Status von Minuten- und Monatskontingent
Basic
OAuth 2.0 unterstützt. Clients mit OAuth-Auto-Discovery (Claude.ai, ChatGPT usw.) fordern deine Nutzer automatisch auf, sich über eine Anmeldeseite zu autorisieren, ohne fest codierten Schlüssel. Der Server gibt seine OAuth-Endpunkte unter https://backend.qualit.ly/.well-known/oauth-authorization-server.

Claude Desktop (fest codierter Schlüssel)

Füge dies zu deiner claude_desktop_config.json hinzu (Claude → Einstellungen → Entwickler):

json
{
  "mcpServers": {
    "qualitly": {
      "url": "https://backend.qualit.ly/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor / VS Code (fest codierter Schlüssel)

json
{
  "mcp": {
    "servers": {
      "qualitly": {
        "url": "https://backend.qualit.ly/api/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

Schnelle Überprüfung

bash
# List available tools
curl -X POST https://backend.qualit.ly/api/mcp \
  -H "Authorization: Bearer qc_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Pläne & Stufen

Deine Stufe wird bei jeder Anfrage ermittelt, Upgrades werden also sofort wirksam. Batch- und Vollbild-Endpunkte erfordern Pro+.

Plan
/ Minute
/ Monat
Batch + Bilder
Basic
30
1,000
—
Early Adopter
40
3,000
—
Pro
300
25,000
—
Pro+
1,000
500,000
Inklusive

Höhere Limits nötig? [email protected]

Alle Pläne, Preise & Vorteile ansehen
Qualit.ly

Free QC photos and the Discord link converter for Taobao, Weidian and 1688.

Tools

  • Search QC photos
  • Discord link converter
  • Order tracking
  • Public REST API

Marketplaces

  • Weidian QC photos
  • Taobao QC photos
  • 1688 QC photos

Resources

  • Plans & pricing
  • About Qualit.ly
  • Contact
  • Terms of Service
  • Privacy Policy
  • Discord community
  • r/qualitly
  • Telegram channel

© Qualit.ly. Free for the rep finds community.

Questions? [email protected]