Trade Me Ecommerce API Integration
Sync Ecommerce Products to Trade Me Marketplace with a Custom API Integration
For ecommerce businesses and in-trade sellers across New Zealand, managing products across an online store and Trade Me Marketplace can become a repetitive operational task. Product information may already exist in WooCommerce, Shopify, Magento, an ERP, inventory system, CRM, or a custom ecommerce platform, yet sellers may still need to maintain a separate listing workflow for Trade Me.
When product information is maintained in multiple systems, even a simple change can create additional work. A price adjustment, inventory update, new product, changed description, shipping configuration, or discontinued item may need to be reflected across multiple sales channels.
A custom Trade Me Marketplace API integration can connect your ecommerce platform directly with Trade Me, allowing supported listing operations to be automated from your primary product and inventory system.
Trade Me’s current API provides dedicated Selling, Listing, Category, Photo, Shipping, My Trade Me, Bidding and Buying, and other marketplace-related methods. Its current marketplace API guidance specifically focuses on in-trade sellers managing their own Trade Me Marketplace listings. :contentReference[oaicite:0]{index=0}
Why build a custom Trade Me ecommerce API integration?
A custom integration allows your existing ecommerce platform to remain the central source of product information while Trade Me becomes an additional sales channel managed through an automated integration layer.
- Reduce duplicate product entry: Publish products from your existing ecommerce or ERP system instead of manually recreating every listing.
- Synchronize prices: Push supported price changes from your primary catalog to Trade Me.
- Manage inventory: Use your central stock system to determine which products should remain available for sale.
- Automate new listings: Create Trade Me listings from eligible products in your store or ERP.
- Update existing listings: Keep supported product and listing information synchronized.
- Automate withdrawals and relisting: Handle supported listing lifecycle operations based on your inventory and business rules.
- Centralize operations: Give your team one primary catalog rather than maintaining separate product databases.
Understanding the Trade Me Marketplace API architecture
Trade Me’s API is divided into specialized sections. For ecommerce integrations, the most relevant areas include Selling Methods, Catalogue Methods, Photo Methods, Shipping Methods, Listing Methods, and My Trade Me Methods. :contentReference[oaicite:1]{index=1}
A typical integration architecture looks like this:
WooCommerce / Shopify / ERP / Custom Store
|
v
+-------------------------+
| Custom Trade Me |
| Integration Layer |
+-------------------------+
|
+---------+---------+
| | |
v v v
Mapping Validation Inventory
| | |
+---------+---------+
|
v
OAuth / API Layer
|
v
Trade Me API
|
v
Trade Me Marketplace
This middleware approach keeps your ecommerce database independent from Trade Me’s listing structure while providing a controlled layer for transformation, validation, synchronization, logging, and error handling.
What ecommerce data can be synchronized?
The exact fields and operations available depend on the Trade Me category and the supported API workflow. The Selling API supports listing information such as category, title, subtitle, description, attributes, external reference IDs, shipping templates, and payment-related settings. :contentReference[oaicite:2]{index=2}
- Product title: Product name and marketplace listing title.
- Description: Product description and selling information.
- Category: Trade Me category and applicable category attributes.
- Price: Buy Now price, starting price, reserve price, or other applicable pricing structures.
- Quantity: Available inventory where supported by the listing type.
- Product attributes: Brand, model, size, condition, color, specifications, and category-specific attributes.
- Images: Product photography and supported listing media.
- Shipping: Shipping options and supported shipping templates.
- Payment: Applicable marketplace payment methods and configuration.
- External reference: Your internal SKU, product ID, or other identifier.
- Listing status: Active, draft, sold, withdrawn, expired, or other applicable states.
Custom product mapping between your store and Trade Me
Your ecommerce platform may use a completely different data model from Trade Me. For example, WooCommerce may store products, variations, attributes, shipping classes, stock quantities, and metadata in separate structures.
A custom connector can transform those records into the format required by the Trade Me listing workflow.
Ecommerce Store Field Trade Me Field --------------------------------------------------------- product.sku ---> ExternalReferenceId product.name ---> Title product.description ---> Description product.price ---> Buy Now Price product.stock_quantity ---> Quantity product.category ---> Trade Me Category product.attributes ---> Category Attributes product.images[] ---> Listing Photos product.shipping_class ---> Shipping Template product.status ---> Listing Lifecycle
The integration can also apply business rules before submitting a product. For example, products with zero inventory can be excluded, products below a certain margin can be skipped, and specific categories can be mapped to predetermined Trade Me categories.
Automated Trade Me product listing workflow
- Read product data: Retrieve new or changed products from WooCommerce, Shopify, ERP, PIM, CRM, or your custom ecommerce platform.
- Check eligibility: Apply rules such as stock availability, product category, brand, price, or marketplace eligibility.
- Resolve Trade Me category: Map the internal product category to the appropriate Trade Me category.
- Validate attributes: Check required category-specific attributes and listing data.
- Transform the product: Convert your internal product object into the Trade Me listing structure.
- Calculate or retrieve fees: Use the applicable Trade Me API functionality to determine listing-related fees where required.
- Create the listing: Submit the product using the supported Selling API workflow.
- Store the Trade Me listing ID: Save the marketplace identifier against your internal SKU or product ID.
- Monitor the result: Store API responses and synchronization information for auditing and troubleshooting.
Trade Me category and attribute mapping
Category mapping is one of the most important parts of a marketplace integration. Trade Me provides category-detail functionality containing information about applicable attributes, legal notices, listing durations, fees, and whether auctions or classifieds are available for the category. :contentReference[oaicite:3]{index=3}
Instead of hard-coding every marketplace attribute into your ecommerce application, a custom integration can retrieve and maintain the relevant category metadata.
- Category mapping: Match your store taxonomy to Trade Me categories.
- Required attributes: Identify information required before a product can be listed.
- Optional attributes: Map additional product specifications when available.
- Listing duration: Use category-supported duration values.
- Legal notices: Surface applicable category requirements during the publishing workflow.
- Fees: Retrieve applicable listing fee information where required.
Trade Me recommends using the current category-details API rather than several older category-specific endpoints for this information. :contentReference[oaicite:4]{index=4}
WooCommerce Trade Me Marketplace integration
If your online store runs on WooCommerce, a custom WordPress plugin can connect your existing WooCommerce catalog with Trade Me Marketplace.
The integration can work with:
- WooCommerce products and product variations.
- WooCommerce inventory and stock quantities.
- Product categories mapped to Trade Me categories.
- Product attributes converted into marketplace attributes.
- Product images prepared for listing workflows.
- Custom product meta containing Trade Me category IDs or listing settings.
- WooCommerce orders where an approved and supported workflow requires downstream order synchronization.
A WordPress admin panel can also expose controls for Trade Me category mapping, listing status, synchronization logs, external listing IDs, and manual retry actions.
Shopify, ERP and custom ecommerce integrations
The same architecture can be implemented outside WordPress. If your product catalog is maintained in Shopify, an ERP, PIM, warehouse system, or custom ecommerce platform, the Trade Me connector can operate as middleware between the two systems.
- Shopify: Read product, variant, pricing, and inventory data through your store’s API.
- ERP: Use your ERP as the source of truth for inventory, pricing, and product information.
- PIM: Transform centralized product information into Trade Me listing data.
- Custom PHP: Build a standalone marketplace synchronization service.
- Laravel: Use queues, scheduled jobs, database mappings, and API workers.
- Node.js: Build an asynchronous marketplace integration service.
Trade Me product inventory synchronization
Inventory synchronization becomes especially important when the same product is sold through your website and Trade Me.
A typical workflow can be designed around a central inventory database:
Central Inventory
|
+--------------------+
| |
v v
Main Ecommerce Store Trade Me
| |
v v
Stock = 5 Listing Quantity
|
v
Sale / Stock Change
|
v
Stock = 4
|
+------------------> Update Trade Me
The integration can compare inventory changes and determine whether a Trade Me listing needs to be created, updated, withdrawn, or otherwise processed according to the applicable listing workflow.
For high-volume catalogs, the synchronization process can use incremental updates rather than processing every product during every scheduled run.
Product price synchronization
Price changes can be managed through the same integration layer. Instead of manually opening individual marketplace listings whenever your ecommerce team changes prices, the connector can detect modified products and process supported listing updates.
Possible business rules include:
- Apply a marketplace-specific price adjustment.
- Add a fixed marketplace handling amount.
- Calculate a marketplace price from your ERP price.
- Skip products below a defined minimum margin.
- Update only products whose source price has changed.
- Maintain different pricing rules for selected categories.
The exact update operation depends on the listing type and current Trade Me API capabilities.
Product images and listing media
Product imagery is another important part of marketplace synchronization. Your ecommerce platform may store image URLs, attachment IDs, or media records that need to be handled differently from the marketplace listing representation.
A custom integration can manage your media workflow by:
- Reading the current product image collection.
- Detecting newly added or removed images.
- Maintaining a relationship between source images and marketplace listings.
- Processing image operations through the applicable Trade Me API methods.
- Recording media errors separately from product-data errors.
- Avoiding unnecessary repeated processing of unchanged products.
Trade Me provides dedicated Photo Methods for listing-related photo operations, while the Selling API’s listing request documentation also describes photo-related fields and limitations. :contentReference[oaicite:5]{index=5}
Shipping and delivery integration
Shipping configuration can be another source of duplicate administration when an ecommerce business already has established shipping rules.
Trade Me provides dedicated Shipping Methods for managing structured shipping templates. The listing API also supports a shipping-template identifier subject to requirements such as Buy Now-only listings, quantity, pricing, and category rules. :contentReference[oaicite:6]{index=6}
A custom integration can map your internal shipping configuration to the applicable Trade Me shipping workflow.
- Map internal shipping classes to Trade Me shipping templates.
- Maintain marketplace-specific shipping rules.
- Apply different templates by product category.
- Store Trade Me shipping-template IDs against your product or category mappings.
- Validate shipping configuration before listing submission.
Trade Me listing validation before publishing
Sending incomplete listing data directly to a marketplace can result in failed publishing requests. Trade Me provides a dedicated Validate a listing request operation that checks whether a listing request is valid without actually creating the listing. :contentReference[oaicite:7]{index=7}
This can be incorporated into an automated publishing workflow:
Product Selected
|
v
Build Trade Me Payload
|
v
Validate Listing
|
+--+--+
| |
Valid Invalid
| |
v v
Publish Log Error
|
v
Store Listing ID
This provides an additional validation stage before the integration attempts to create a live marketplace listing.
Trade Me listing lifecycle automation
Product synchronization should cover the complete listing lifecycle rather than only initial publication.
New Product
|
v
Validate
|
v
Create Listing
|
v
Active Listing
|
+------> Price Changed
|
+------> Stock Changed
|
+------> Product Updated
|
+------> Listing Needs Extension
|
+------> Product Discontinued
|
v
Update / Extend / Withdraw / Relist
Trade Me’s current Selling API includes functionality for creating drafts, updating drafts, listing products, editing listings, extending supported classifieds, relisting items, withdrawing listings, retrieving listing details, and validating listing requests. :contentReference[oaicite:8]{index=8}
This gives a custom integration multiple building blocks for automating the marketplace lifecycle, subject to the applicable listing type and API permissions.
External reference IDs and product-to-listing mapping
Maintaining a reliable relationship between your ecommerce product and its Trade Me listing is essential.
Trade Me’s listing request supports an ExternalReferenceId, allowing an API client to associate its own identifier with a listing. The value can be searched through the API and is otherwise intended for API-client use. :contentReference[oaicite:9]{index=9}
A custom integration can therefore maintain mappings such as:
WooCommerce Product ID
|
+---- SKU
|
+---- External Reference ID
|
v
Trade Me Listing ID
|
+---- Listing Status
+---- Last Sync
+---- Last API Response
This mapping makes future updates much safer because the integration does not need to guess which marketplace listing belongs to a particular product.
Trade Me Marketplace API authentication
Most Trade Me API methods require an application to be registered. Registration provides a Consumer Key and Consumer Secret, which are used as part of the OAuth authentication process. Trade Me specifically states that applications should not request or store a member’s Trade Me username or password. :contentReference[oaicite:10]{index=10}
For marketplace integrations, the authentication architecture can look like:
Ecommerce Application
|
v
Trade Me OAuth
|
v
Authorized Access Token
|
v
Authenticated API Requests
|
+---- Categories
+---- Selling
+---- Listings
+---- Photos
+---- Shipping
+---- Other supported methods
Production credentials should be stored securely on the server and should never be exposed through frontend JavaScript or public source code.
Important Trade Me Marketplace API eligibility
Trade Me’s current API guidance is important when planning an ecommerce integration. Trade Me states that Marketplace API access is generally intended for in-trade sellers who want to list their own products and receive updates on their listings via the API. It is not intended for personal or non-commercial use. :contentReference[oaicite:11]{index=11}
Trade Me also states that, from 10 April 2026, application registration for Marketplace API access is limited to in-trade sellers. In addition, Trade Me’s documentation says that from 10 March 2026, bidding on and buying Marketplace listings through the API is no longer supported for casual listings. :contentReference[oaicite:12]{index=12}
Therefore, before development begins, the intended integration use case and the seller’s API eligibility should be confirmed with Trade Me. Trade Me specifically directs in-trade Marketplace sellers with API access to its Marketplace API support channel for integration assistance. :contentReference[oaicite:13]{index=13}
Sync queues, retries and error handling
A production marketplace integration should not silently fail when an API request is rejected or a temporary network problem occurs.
- Validation errors: Store the product and identify the missing or invalid field.
- Category errors: Flag products where category or attribute mapping is incomplete.
- Authentication errors: Detect authorization problems and alert the administrator.
- Rate limiting: Respect Trade Me’s API limits and schedule requests appropriately.
- Network failures: Retry temporary connectivity errors.
- Duplicate prevention: Maintain source-product-to-Trade-Me-listing mappings.
- Media failures: Track image-specific errors separately from product errors.
- Audit logs: Record every create, update, withdraw, relist, and failed operation.
For large catalogs, background queues and scheduled workers can process products in batches without blocking the main ecommerce website.
Supported ecommerce technology stacks
We can build the Trade Me Marketplace connector around your existing ecommerce architecture.
- WooCommerce: Custom WordPress plugin, WooCommerce products, variations, inventory, attributes, and metadata.
- Shopify: Product, variant, price, inventory, and catalog API integration.
- Magento / Adobe Commerce: Catalog, inventory, pricing, and custom marketplace middleware.
- Laravel: Queue-based marketplace synchronization with scheduled workers.
- Node.js: API middleware, background workers, and asynchronous synchronization.
- Custom PHP: Standalone ecommerce and marketplace connectors.
- ERP / PIM: Centralized product and inventory synchronization into Trade Me.
- Custom ecommerce platforms: REST, JSON, XML, database, or custom API-based integrations.
Build your custom Trade Me ecommerce API integration
If your business already maintains products in an ecommerce store, ERP, PIM, inventory system, or custom platform, you do not necessarily need to manually recreate those products on Trade Me.
A custom Trade Me Marketplace API integration can connect your existing product catalog with your Trade Me seller account and automate supported listing workflows around products, categories, attributes, prices, inventory, images, shipping, listing updates, validation, relisting, and withdrawals.
Whether you operate WooCommerce, Shopify, Magento, Laravel, Node.js, a custom PHP application, an ERP, or a proprietary ecommerce platform, the integration can be designed around your existing database and business rules.
Before development, the intended use case and API eligibility should be confirmed with Trade Me because current Marketplace API access is specifically focused on in-trade sellers managing their own listings. :contentReference[oaicite:14]{index=14}
📩 Contact me on Upwork to discuss your custom Trade Me Marketplace API integration, WooCommerce Trade Me integration, ecommerce marketplace synchronization, or product feed automation project.
FAQs: Trade Me Ecommerce API Integration
Q: Can you integrate Trade Me Marketplace with WooCommerce?
Yes. A custom WordPress plugin can map WooCommerce products, categories, attributes, prices, inventory, images, and shipping configuration into the supported Trade Me Marketplace API workflow.
Q: Can products be automatically listed on Trade Me?
Yes, for eligible in-trade sellers with the required API access. The Selling API supports creating listings, while the integration can handle validation, mapping, and synchronization around the publishing workflow.
Q: Can Trade Me prices be synchronized with my ecommerce store?
Yes. A custom connector can detect product price changes and process supported Trade Me listing updates according to your business rules.
Q: Can inventory be synchronized between WooCommerce and Trade Me?
A custom integration can use your central inventory system to determine which products should be listed or updated. The exact inventory and listing behavior depends on the applicable Trade Me listing workflow and API capabilities.
Q: Can product categories and attributes be mapped automatically?
Yes. Trade Me provides category-detail information that can be used to build category and attribute mappings between your ecommerce catalog and the marketplace.
Q: Can product images be synchronized?
Yes. Trade Me provides dedicated photo-related API methods, and the integration can manage the relationship between your ecommerce media and marketplace listings.
Q: Can shipping templates be integrated?
Yes. Trade Me provides structured Shipping Methods, and the Selling API supports shipping-template identifiers subject to applicable listing requirements.
Q: Can existing Trade Me listings be updated?
Yes. The Selling API provides functionality for editing supported active listings and retrieving a seller’s listing details for editing.
Q: Can products be withdrawn or relisted automatically?
Trade Me provides supported operations for withdrawing, relisting, and relisting with edits. The applicable operation depends on the listing type and current API rules.
Q: Can you integrate Trade Me with an ERP or PIM instead of WooCommerce?
Yes. A standalone Laravel, Node.js, PHP, or other backend middleware service can connect your ERP, PIM, inventory platform, or custom catalog to Trade Me.
Q: Is Trade Me Marketplace API access available to every seller?
Trade Me’s current guidance says Marketplace API access is generally for in-trade sellers managing their own listings, and application registration for Marketplace API access is limited to in-trade sellers from 10 April 2026. API eligibility should therefore be confirmed before development. :contentReference[oaicite:15]{index=15}