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%
6.2 KB · 72 lines json
Raw Blame History
1{2  "id": "trademe",3  "displayName": "Trade Me API (New Zealand collectibles listings, NZD) — gated",4  "sourceId": "trademe",5  "sourceName": "Trade Me",6  "sourceType": "marketplace",7  "sourceUrl": "https://www.trademe.co.nz",8  "module": "api/trademe",9  "enginePriority": ["api"],10  "categories": ["coins", "banknotes", "stamps", "clocks", "scientific_instruments", "silver", "jewelry", "other_watches", "militaria", "medals", "movie_memorabilia", "pins", "postcards", "design_furniture", "antiques", "automotive_memorabilia", "maps", "historical_documents", "royal_memorabilia", "advertising", "porcelain", "glass_crystal", "vintage_toys", "model_cars", "lego_sets", "trading_cards", "music", "music_memorabilia", "books", "comics", "cameras"],11  "regions": ["NZ"],12  "languages": ["en"],13  "currency": ["NZD"],14  "supportsListings": true,15  "supportsSold": false,16  "supportsAuctions": false,17  "supportsImages": true,18  "supportsCatalog": false,19  "supportsPopulation": false,20  "supportsLookup": false,21  "refreshFrequencyMinutes": 360,22  "priority": "low",23  "trustScore": 0.7,24  "attributionRequired": true,25  "termsUrl": "https://developer.trademe.co.nz/api-terms/",26  "acquisitionMethod": "official API (OAuth 1.0a application-only)",27  "historicalDepth": "none",28  "requires": ["TRADEME_CONSUMER_KEY", "TRADEME_CONSUMER_SECRET"],29  "accessNotes": "Official Trade Me API v1 (developer.trademe.co.nz). GET https://api.trademe.co.nz/v1/Search/General.json?category=<number>&rows=25&page=N&sort_order=Default&photo_size=Large. Public search methods accept application-only OAuth 1.0a: Authorization: OAuth oauth_consumer_key=\"<key>\", oauth_signature_method=\"PLAINTEXT\", oauth_signature=\"<consumer_secret>&\" — no member token is required or requested. Response: TotalCount, Page, PageSize and List[] of listings with ListingId, Title, Subtitle, Category (number), CategoryPath, StartPrice, BuyNowPrice, MaxBidAmount, BidCount, HasBuyNow, HasReserve/ReserveState, IsClassified, IsNew, StartDate/EndDate (.NET '/Date(ms)/'), PictureHref, Region/Suburb (public listing location, no member data), Attributes. All prices NZD → listings (Buy Now price when offered, else leading bid, else start price; auctions labelled listingType=auction with bidCount). Seeds: the category numbers from /v1/Categories.json (public, verified 2026-09-08): Antiques & collectables (0187-…: Coins 4353, Banknotes 4342, Stamps 4383, Clocks & scientific instruments 3210, Silver metalware & tins 3224, Jewellery 3212, Militaria 0451, Movie & TV memorabilia 6216, Pins badges & patches 0454, Postcards & writing 0455, Art deco & retro 2192, Furniture & woodenware 3215, Automotive & transport 0443, Documents & maps 3232, Royal family 6492, Advertising 1443), Toys & models (0347-2695 Vintage, 0347-0921 Die casts, 0347-0923 Lego), Gaming trading cards 0202-3193, Music vinyl 0343-0894 & memorabilia 0343-3151, Jewellery & watches 0246-0486, Pottery & glass (0340-2609, 0340-2650), Rare & collectable books 0193-0466, Comics 0193-1222, Film cameras 0124-3412. Rate limits: Trade Me counts calls per hour per application (1,000/h per authenticated user; application-only calls share the app allowance) and answers HTTP 429 when exceeded — we run ≤ 8 categories × 1 page every 6 h (rows=25, the documented default; larger row counts may need a member token). Production applications must be reviewed by Trade Me staff (developer.trademe.co.nz → Register an application; sandbox api.tmsandbox.co.nz with TRADEME_ENV=sandbox). Set TRADEME_CONSUMER_KEY and TRADEME_CONSUMER_SECRET; until then the framework reports the connector DISABLED (requires) and the crawler exits with a missing_credentials anomaly. Trade Me has no public sold-price endpoint (closed listings are only visible to the parties) → listings only. Fixture synthesised from the documented response fields (SearchResults/Listing), not a live capture. API Terms: data may be displayed with attribution to Trade Me and must not be resold as a raw feed; RareIndex keeps only listing-level market data with source links.",30  "enabled": true,31  "schemaVersion": "1.0",32  "config": {33    "rows": 25,34    "pagesPerCategory": 1,35    "backfillPages": 8,36    "categoriesPerRun": 8,37    "sortOrder": "Default",38    "condition": "All",39    "photoSize": "Large",40    "categories": [41      { "category": "0187-4353-", "categorySlug": "coins" },42      { "category": "0187-4342-", "categorySlug": "banknotes" },43      { "category": "0187-4383-", "categorySlug": "stamps" },44      { "category": "0187-3210-", "categorySlug": "clocks", "hint": "science" },45      { "category": "0187-3224-", "categorySlug": "silver" },46      { "category": "0187-3212-", "categorySlug": "jewelry" },47      { "category": "0187-0451-", "categorySlug": "militaria", "hint": "militaria" },48      { "category": "0187-6216-", "categorySlug": "movie_memorabilia" },49      { "category": "0187-0454-", "categorySlug": "pins" },50      { "category": "0187-0455-", "categorySlug": "postcards" },51      { "category": "0187-2192-", "categorySlug": "design_furniture", "hint": "decorative" },52      { "category": "0187-3215-", "categorySlug": "antiques", "hint": "furniture" },53      { "category": "0187-0443-", "categorySlug": "automotive_memorabilia" },54      { "category": "0187-3232-", "categorySlug": "maps", "hint": "books" },55      { "category": "0187-6492-", "categorySlug": "royal_memorabilia" },56      { "category": "0187-1443-", "categorySlug": "advertising" },57      { "category": "0340-2609-", "categorySlug": "porcelain" },58      { "category": "0340-2650-", "categorySlug": "glass_crystal" },59      { "category": "0347-2695-", "categorySlug": "vintage_toys", "hint": "toys" },60      { "category": "0347-0921-", "categorySlug": "model_cars" },61      { "category": "0347-0923-", "categorySlug": "lego_sets" },62      { "category": "0202-3193-", "categorySlug": "trading_cards", "hint": "cards" },63      { "category": "0343-0894-", "categorySlug": "music" },64      { "category": "0343-3151-", "categorySlug": "music_memorabilia" },65      { "category": "0246-0486-", "categorySlug": "other_watches", "hint": "watches" },66      { "category": "0193-0466-", "categorySlug": "books" },67      { "category": "0193-1222-", "categorySlug": "comics", "hint": "comics" },68      { "category": "0124-3412-", "categorySlug": "cameras" }69    ]70  }71}72