SPB Git forge

spb/rareindex

Public
54commits 1branches 0releases
7.1 MBsize
maindefault branch
10 days agolast push
TypeScript 61.9% HTML 37.2% SQL 0.7%
3.1 KB · 55 lines json
Raw Blame History
1{2  "id": "cardtrader",3  "displayName": "CardTrader (API v2 — blueprints & marketplace)",4  "sourceId": "cardtrader",5  "sourceName": "CardTrader",6  "sourceType": "marketplace",7  "sourceUrl": "https://www.cardtrader.com",8  "module": "api/cardtrader",9  "enginePriority": ["api"],10  "categories": ["magic_the_gathering", "pokemon", "yugioh", "one_piece_card_game", "disney_lorcana", "flesh_and_blood", "digimon_tcg", "dragon_ball_tcg", "star_wars_tcg", "other_tcg"],11  "regions": ["EU", "IT"],12  "country": "IT",13  "languages": ["en", "it", "es"],14  "currency": ["EUR", "USD"],15  "supportsListings": true,16  "supportsSold": false,17  "supportsAuctions": false,18  "supportsImages": true,19  "supportsCatalog": true,20  "supportsPopulation": false,21  "supportsLookup": false,22  "refreshFrequencyMinutes": 1440,23  "priority": "medium",24  "trustScore": 0.8,25  "attributionRequired": true,26  "termsUrl": "https://www.cardtrader.com/en/terms",27  "acquisitionMethod": "official REST API v2 (Bearer token from a CardTrader account)",28  "historicalDepth": "none",29  "requires": ["CARDTRADER_API_TOKEN"],30  "capabilities": ["catalog", "live_listings", "images"],31  "accessNotes": "CardTrader (Italy) is Europe's second card marketplace and publishes a documented REST API at https://api.cardtrader.com/api/v2 (docs: https://www.cardtrader.com/docs/api/full). Every call needs `Authorization: Bearer <token>`; the token is issued to any registered CardTrader account from its settings page — unauthenticated calls return 401 (verified live), so the connector is gated behind CARDTRADER_API_TOKEN. Endpoints used, all read-only: GET /games, GET /expansions (id, game_id, code, name), GET /blueprints/export?expansion_id=<id> (one blueprint per printing with scryfall_id, card_market_ids, tcg_player_id, image_url, fixed_properties such as collector_number/rarity) and GET /marketplace/products?expansion_id=<id> (the 25 cheapest public offers per blueprint: price cents + currency, quantity, properties_hash condition/language/foil, seller username/country/type, graded, bundle_size). Rate limits per docs: 200 requests / 10 s overall, 10 req/s on /marketplace/products (we stay at ≤ 1 req/s). The public website (Cloudflare) is never crawled. Seller usernames are personal data for 'normal' (private) sellers and are never stored; only user_type/country_code are kept. Offers are asking prices → listings, never sales; graded and bundle offers are flagged. Fixtures were built from the official documentation's example responses (no token available) and say so in their note.",32  "enabled": true,33  "schemaVersion": "1.0",34  "config": {35    "gameSlugs": {36      "magic": "magic_the_gathering",37      "pokemon": "pokemon",38      "yugioh": "yugioh",39      "one piece": "one_piece_card_game",40      "lorcana": "disney_lorcana",41      "flesh and blood": "flesh_and_blood",42      "digimon": "digimon_tcg",43      "dragon ball": "dragon_ball_tcg",44      "star wars": "star_wars_tcg",45      "vanguard": "other_tcg",46      "riftbound": "other_tcg",47      "union arena": "other_tcg",48      "battle spirits": "other_tcg",49      "gundam": "other_tcg"50    },51    "expansionsPerRun": 30,52    "includeMarketplace": true53  }54}55