{
  "id": "trademe",
  "displayName": "Trade Me API (New Zealand collectibles listings, NZD) — gated",
  "sourceId": "trademe",
  "sourceName": "Trade Me",
  "sourceType": "marketplace",
  "sourceUrl": "https://www.trademe.co.nz",
  "module": "api/trademe",
  "enginePriority": ["api"],
  "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"],
  "regions": ["NZ"],
  "languages": ["en"],
  "currency": ["NZD"],
  "supportsListings": true,
  "supportsSold": false,
  "supportsAuctions": false,
  "supportsImages": true,
  "supportsCatalog": false,
  "supportsPopulation": false,
  "supportsLookup": false,
  "refreshFrequencyMinutes": 360,
  "priority": "low",
  "trustScore": 0.7,
  "attributionRequired": true,
  "termsUrl": "https://developer.trademe.co.nz/api-terms/",
  "acquisitionMethod": "official API (OAuth 1.0a application-only)",
  "historicalDepth": "none",
  "requires": ["TRADEME_CONSUMER_KEY", "TRADEME_CONSUMER_SECRET"],
  "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.",
  "enabled": true,
  "schemaVersion": "1.0",
  "config": {
    "rows": 25,
    "pagesPerCategory": 1,
    "backfillPages": 8,
    "categoriesPerRun": 8,
    "sortOrder": "Default",
    "condition": "All",
    "photoSize": "Large",
    "categories": [
      { "category": "0187-4353-", "categorySlug": "coins" },
      { "category": "0187-4342-", "categorySlug": "banknotes" },
      { "category": "0187-4383-", "categorySlug": "stamps" },
      { "category": "0187-3210-", "categorySlug": "clocks", "hint": "science" },
      { "category": "0187-3224-", "categorySlug": "silver" },
      { "category": "0187-3212-", "categorySlug": "jewelry" },
      { "category": "0187-0451-", "categorySlug": "militaria", "hint": "militaria" },
      { "category": "0187-6216-", "categorySlug": "movie_memorabilia" },
      { "category": "0187-0454-", "categorySlug": "pins" },
      { "category": "0187-0455-", "categorySlug": "postcards" },
      { "category": "0187-2192-", "categorySlug": "design_furniture", "hint": "decorative" },
      { "category": "0187-3215-", "categorySlug": "antiques", "hint": "furniture" },
      { "category": "0187-0443-", "categorySlug": "automotive_memorabilia" },
      { "category": "0187-3232-", "categorySlug": "maps", "hint": "books" },
      { "category": "0187-6492-", "categorySlug": "royal_memorabilia" },
      { "category": "0187-1443-", "categorySlug": "advertising" },
      { "category": "0340-2609-", "categorySlug": "porcelain" },
      { "category": "0340-2650-", "categorySlug": "glass_crystal" },
      { "category": "0347-2695-", "categorySlug": "vintage_toys", "hint": "toys" },
      { "category": "0347-0921-", "categorySlug": "model_cars" },
      { "category": "0347-0923-", "categorySlug": "lego_sets" },
      { "category": "0202-3193-", "categorySlug": "trading_cards", "hint": "cards" },
      { "category": "0343-0894-", "categorySlug": "music" },
      { "category": "0343-3151-", "categorySlug": "music_memorabilia" },
      { "category": "0246-0486-", "categorySlug": "other_watches", "hint": "watches" },
      { "category": "0193-0466-", "categorySlug": "books" },
      { "category": "0193-1222-", "categorySlug": "comics", "hint": "comics" },
      { "category": "0124-3412-", "categorySlug": "cameras" }
    ]
  }
}