Qualit.ly
Qualit.ly
HemDiscord-botSök

API-referens

Qualit.ly API

Produktdata, QC-bilder och metadata från Weidian, Taobao och 1688. Bearer-token-autentisering, generösa hastighetsgränser, nivåbaserade planer.

Skaffa API-nyckel

Kom igång

Alla förfrågningar går till https://backend.qualit.ly/api/v1. Tre steg:

1

Skaffa en nyckel

Logga in och skapa en API-nyckel från utvecklarens kontrollpanel.

2

Gör en förfrågan

Skicka din nyckel som en Bearer-token i Authorization-headern.

3

Hämta data

Ta emot JSON-svar med produktdata och QC-bilder.

Snabbt exempel

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

Autentisering

Inkludera en giltig API-nyckel i Authorization-headern med Bearer-schemat.

Authorization: Bearer qc_live_xxxxxxxxxxxxxxxxxxxxxxxx

Nyckelformat

Nycklar följer qc_{mode}_{random} där mode är live eller test, och random är 32 kryptografiskt slumpmässiga tecken.

Nycklar visas en gång vid skapandet. Vi lagrar bara SHA-256-hashen, så borttappade nycklar kan inte återställas.

IP-tillåtelselista

Begränsa valfritt nycklar till specifika IP:er eller CIDR-intervall via utvecklarens kontrollpanel. Förfrågningar från olistade IP:er får en 403. En tom tillåtelselista tillåter alla IP:er.

Hastighetsgränser

Två hinkar: per minut och per månad. Gränserna är kopplade till din kontonivå och gäller för alla nycklar.

Nivå
/ minut
/ månad
Basic
30
1,000
Early Adopter
40
3,000
Pro
300
25,000
Pro+
1,000
500,000

När du är hastighetsbegränsad

API:et returnerar 429 med en Retry-After-header.

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

Fel

Alla fel returnerar ett error-objekt på toppnivå med code och message.

json
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Product not found"
  }
}
400BAD_REQUESTOgiltig förfrågningskropp eller parametrar.
401INVALID_KEYSaknad, felformaterad eller okänd API-nyckel.
401REVOKED_KEYAPI-nyckeln återkallades i kontrollpanelen.
403IP_NOT_AUTHORIZEDFörfrågningens IP finns inte i nyckelns tillåtelselista.
403FORBIDDENDin nivå saknar åtkomst till den här slutpunkten.
404NOT_FOUNDDen begärda resursen finns inte.
429RATE_LIMITEDGränsen per minut överskriden, kontrollera Retry-After.
429QUOTA_EXCEEDEDMånadskvoten förbrukad; återställs vid UTC-månadsskiftet.
500INTERNALServerfel. Försök igen eller kontakta supporten.

Slutpunkter

Bas: https://backend.qualit.ly/api/v1. Marknadsplatser: weidian, taobao, 1688.

GET/products/:storefront/:listingIdBasic

Slå upp en enskild produkt via marknadsplats och annons-ID. Returnerar metadata och upp till 5 QC-förhandsvisningsminiatyrer.

Parametrar

storefrontobligatoriskt

En av: weidian, taobao, 1688

listingIdobligatoriskt

Produktens annons-ID från marknadsplatsen

Exempel

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

Svar

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/..."
    ]
  }
}
GET/products/searchBasic

Sök i katalogen på produktnamn (matchar även produkt-URL:en). Filtrera valfritt till en marknadsplats eller till produkter som har QC-foton. Ingen paginering — antalet resultat begränsas av din plan.

Frågeparametrar

qobligatoriskt

Söktext. Flera ord AND-matchas mot produktnamnet och URL:en. (obligatoriskt)

storefront

Valfritt. Begränsa resultaten till en av: weidian, taobao, 1688

has_qc

Valfritt. Sätt till true för att endast returnera produkter som har QC-foton

limit

Valfritt. Färre resultat än din plans gräns. Värden över gränsen justeras nedåt — aldrig uppåt.

Resultatgränser

Ingen paginering. Varje plan returnerar upp till ett fast antal resultat per sökning. Skicka en lägre gräns för att få färre; du kan inte överskrida din plans gräns.

Plan
Max resultat
Basic
5
Early Adopter
10
Pro
50
Pro+
100
Custom
250

Exempel

bash
curl -H "Authorization: Bearer qc_live_YOUR_KEY" \
  "https://backend.qualit.ly/api/v1/products/search?q=jordan+1&storefront=weidian&has_qc=true&limit=10"

Svar

json
{
  "query": "jordan 1",
  "count": 10,
  "limit": 10,
  "max_results": 100,
  "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/..."]
    }
  ]
}
POST/products/batchPro+

Slå upp flera produkter i en enda förfrågan (upp till 100). Varje resultat är oberoende, så en saknad produkt får inte batchen att misslyckas.

Förfrågningskropp

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

Exempel

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

Svar

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

Hämta QC-metadata och de första 3 miniatyrbild-URL:erna för en produkt.

Exempel

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+

Fullständig lista över QC-bilder. Accepterar ett numeriskt produkt-ID eller en ?url=-frågeparameter för URL-baserade uppslag.

Via produkt-ID

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

Via 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"

Svar

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",
      "..."
    ]
  }
}
Endast Pro+. Parametern ?url= accepterar fullständiga produkt-URL:er från Weidian, Taobao, 1688 och agenter som stöds.
GET/meBasic

Returnerar din kontoinformation, nyckeln som användes för förfrågan och din aktuella nivå.

Exempel

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

Kontrollera din aktuella användning av hastighetsgräns och kvot. Returnerar räknare per minut och per månad med återställningstidsstämplar. Själva anropet förbrukar 1 förfrågan från båda räknarna.

Exempel

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

Svar

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
  }
}

Fält

tier

En av: basic, early_adopter, pro, pro_plus, custom

limit / remaining

null på custom-nivån (obegränsat)

used

Förfrågningar räknade i det aktuella fönstret. Minuträknaren återställs var 60:e sekund; månadsräknaren återställs vid UTC-månadsskiftet.

reset_at

ISO 8601 UTC-tidsstämpel

bucket

Intern YYYYMM-nyckel för månadsräknaren

Fel

Samma som andra /api/v1/*-vägar:401 INVALID_KEY /REVOKED_KEY,403 IP_NOT_AUTHORIZED,429 RATE_LIMITED /QUOTA_EXCEEDED.

Kodexempel

Snabbstartsnuttar i populära språk.

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

Qualit.ly-API:et är tillgängligt som en Model Context Protocol (MCP)-server. Anslut den till Claude Desktop, Cursor, VS Code eller vilken MCP-kompatibel klient som helst och fråga efter produkter, QC-bilder och användningsdata direkt från din AI-assistent, utan att behöva manuell HTTP. Samma API-nyckel, hastighetsgränser och nivåregler gäller.

Server-URL

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

Transport

StreamableHTTP (POST)

Autentisering

Authorization: Bearer qc_live_…

Tillgängliga verktyg

Verktyg
Beskrivning
Nivå
get_product
Slå upp en produkt via marknadsplats och annons-ID
Basic
search_products
Sök produkter på namn, med filter för marknadsplats / har QC
Basic
get_products_batch
Slå upp upp till 100 produkter i ett anrop
Pro+
get_qc
QC-antal och 3 miniatyr-URL:er
Basic
get_qc_images
Fullständig CDN-bildlista (via ID eller URL)
Pro+
get_me
Aktuell nyckel, användare och nivå
Basic
get_usage
Kvotstatus per minut och per månad
Basic
OAuth 2.0 stöds. Klienter som stöder automatisk OAuth-upptäckt (Claude.ai, ChatGPT osv.) uppmanar automatiskt dina användare att auktorisera via en inloggningssida, utan att någon hårdkodad nyckel behövs. Servern annonserar sina OAuth-slutpunkter på https://backend.qualit.ly/.well-known/oauth-authorization-server.

Claude Desktop (hårdkodad nyckel)

Lägg till detta i din claude_desktop_config.json (Claude → Inställningar → Utvecklare):

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

Cursor / VS Code (hårdkodad nyckel)

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

Snabb verifiering

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":{}}'

Planer och nivåer

Din nivå avgörs vid varje förfrågan, så uppgraderingar träder i kraft omedelbart. Batch- och fullbildsslutpunkter kräver Pro+.

Plan
/ minut
/ månad
Batch + bilder
Basic
30
1,000
—
Early Adopter
40
3,000
—
Pro
300
25,000
—
Pro+
1,000
500,000
Ingår

Behöver du högre gränser? [email protected]

Se fullständiga planer, priser och förmåner
Qualit.ly

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

Tools

  • Search QC photos
  • QC photo finder
  • 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]