Allows you to search for listings on Trade Me by category, by keywords or a combination of these two. The result set can be filtered by a variety of properties, including availability of Buy Now, Pay Now, item condition or seller.
Parameters listed below apply to all categories. Additional parameters are available for certain categories (for example, category 3405, digital cameras). Use the return_metadata parameter in combination with the category parameter to retrieve information about the available parameters.
This API is not recommended to search for Residential property as some categories will be excluded unless specified. To search for Residential property use the Residential Search API.
The search results.
{
"TotalCount": 123,
"TotalCountTruncated": false,
"Page": 123,
"PageSize": 123,
"List": [
{
"ListingId": 123,
"Title": "ABC",
"Category": "ABC",
"StartPrice": 123.0,
"BuyNowPrice": 123.0,
"StartDate": "\/Date(1514764800)\/",
"EndDate": "\/Date(1514764800)\/",
"IsFeatured": false,
"HasGallery": false,
"IsBold": false,
"IsHighlighted": false,
"HasHomePageFeature": false,
"MaxBidAmount": 123.0,
"AsAt": "\/Date(1514764800)\/",
"CategoryPath": "ABC",
"PictureHref": "ABC",
"HasPayNow": false,
"IsNew": false,
"RegionId": 123,
"Region": "ABC",
"SuburbId": 123,
"Suburb": "ABC",
"PickupLocality": {
"Suburb": "ABC",
"District": "ABC",
"Region": "ABC"
},
"BidCount": 123,
"IsReserveMet": false,
"HasReserve": false,
"HasBuyNow": false,
"NoteDate": "\/Date(1514764800)\/",
"ReserveState": 0,
"Attributes": [
{
"Name": "ABC",
"DisplayName": "ABC",
"Value": "ABC",
"DisplayValue": "ABC"
},
{
"Name": "ABC",
"DisplayName": "ABC",
"Value": "ABC",
"DisplayValue": "ABC"
}
],
"IsClassified": false,
"OpenHomes": [
{
"Start": "\/Date(1514764800)\/",
"End": "\/Date(1514764800)\/"
},
{
"Start": "\/Date(1514764800)\/",
"End": "\/Date(1514764800)\/"
}
],
"Subtitle": "ABC",
"IsBuyNowOnly": false,
"RemainingGalleryPlusRelists": 123,
"IsOnWatchList": false,
"GeographicLocation": {
"Latitude": 123.0,
"Longitude": 123.0,
"Northing": 123,
"Easting": 123,
"Accuracy": 0
},
"PriceDisplay": "ABC",
"TotalReviewCount": 123,
"PositiveReviewCount": 123,
"HasFreeShipping": false,
"IsClearance": false,
"WasPrice": 123.0,
"PercentageOff": 123,
"Branding": {
"LargeSquareLogo": "ABC",
"LargeWideLogo": "ABC",
"BackgroundColor": "ABC",
"TextColor": "ABC",
"StrokeColor": "ABC",
"DisableBanner": false,
"OfficeLocation": "ABC",
"LargeBannerURL": "ABC"
},
"IsSuperFeatured": false,
"ShortDescription": "ABC",
"PhotoUrls": [
"ABC",
"ABC"
],
"PromotionId": 123,
"HasEmbeddedVideo": false,
"VariantDefinitionSummary": {
"PriceLow": 123.0,
"PriceHigh": 123.0,
"Price": 123.0,
"HasPriceRange": false,
"DiscountPercentLow": 123,
"DiscountPercentHigh": 123,
"DiscountPercent": 123,
"HasDiscountPercentRange": false,
"AllDiscounted": false,
"AllOnClearance": false
},
"AdditionalData": {
"BulletPoints": [
"ABC",
"ABC"
],
"Tags": [
{
"Name": "ABC"
},
{
"Name": "ABC"
}
]
},
"ListingExtras": [
"ABC",
"ABC"
],
"IsLoyaltyEligible": false,
"HasPing": false,
"StoreBrandLogoUrl": "ABC",
"WhyPayPrice": 123.0,
"Has3DTour": false,
"ShippingDetails": {
"ShippingTemplateId": 123,
"SuggestedShipping": {
"Price": 123.0,
"Destination": "ABC",
"DeliveryTime": {
"MinValue": "ABC",
"MaxValue": "ABC"
},
"IsRural": false
}
},
"PriceType": 0,
"HasSpecialOffer": false,
"NewCarInformation": {
"Availability": 2,
"Condition": 1,
"CertifiedPreOwned": {
"LogoUrl": "ABC",
"DarkModeLogoUrl": "ABC"
}
},
"MemberDateJoined": "\/Date(1514764800)\/",
"LastServiceReview": {
"ServiceReviewerNickname": "ABC",
"ServiceReviewText": "ABC",
"ServiceReviewDateEntered": "\/Date(1514764800)\/"
},
"Sponsored": {
"TopSortProductId": "ABC",
"TopSortResolveBidId": "ABC",
"TopSortUniqueId": "ABC"
},
"MotorsExternalMediaOverview": {
"HasInstavid360Spinner": false
},
"ListingPlatform": 0,
"AllowsPickups": 0,
"SearchResultAttributes": [
{
"Id": 1,
"DisplayValue": "ABC",
"Name": "ABC"
},
{
"Id": 1,
"DisplayValue": "ABC",
"Name": "ABC"
}
]
},
{
"ListingId": 123,
"Title": "ABC",
"Category": "ABC",
"StartPrice": 123.0,
"BuyNowPrice": 123.0,
"StartDate": "\/Date(1514764800)\/",
"EndDate": "\/Date(1514764800)\/",
"IsFeatured": false,
"HasGallery": false,
"IsBold": false,
"IsHighlighted": false,
"HasHomePageFeature": false,
"MaxBidAmount": 123.0,
"AsAt": "\/Date(1514764800)\/",
"CategoryPath": "ABC",
"PictureHref": "ABC",
"HasPayNow": false,
"IsNew": false,
"RegionId": 123,
"Region": "ABC",
"SuburbId": 123,
"Suburb": "ABC",
"PickupLocality": {
"Suburb": "ABC",
"District": "ABC",
"Region": "ABC"
},
"BidCount": 123,
"IsReserveMet": false,
"HasReserve": false,
"HasBuyNow": false,
"NoteDate": "\/Date(1514764800)\/",
"ReserveState": 0,
"Attributes": [
{
"Name": "ABC",
"DisplayName": "ABC",
"Value": "ABC",
"DisplayValue": "ABC"
},
{
"Name": "ABC",
"DisplayName": "ABC",
"Value": "ABC",
"DisplayValue": "ABC"
}
],
"IsClassified": false,
"OpenHomes": [
{
"Start": "\/Date(1514764800)\/",
"End": "\/Date(1514764800)\/"
},
{
"Start": "\/Date(1514764800)\/",
"End": "\/Date(1514764800)\/"
}
],
"Subtitle": "ABC",
"IsBuyNowOnly": false,
"RemainingGalleryPlusRelists": 123,
"IsOnWatchList": false,
"GeographicLocation": {
"Latitude": 123.0,
"Longitude": 123.0,
"Northing": 123,
"Easting": 123,
"Accuracy": 0
},
"PriceDisplay": "ABC",
"TotalReviewCount": 123,
"PositiveReviewCount": 123,
"HasFreeShipping": false,
"IsClearance": false,
"WasPrice": 123.0,
"PercentageOff": 123,
"Branding": {
"LargeSquareLogo": "ABC",
"LargeWideLogo": "ABC",
"BackgroundColor": "ABC",
"TextColor": "ABC",
"StrokeColor": "ABC",
"DisableBanner": false,
"OfficeLocation": "ABC",
"LargeBannerURL": "ABC"
},
"IsSuperFeatured": false,
"ShortDescription": "ABC",
"PhotoUrls": [
"ABC",
"ABC"
],
"PromotionId": 123,
"HasEmbeddedVideo": false,
"VariantDefinitionSummary": {
"PriceLow": 123.0,
"PriceHigh": 123.0,
"Price": 123.0,
"HasPriceRange": false,
"DiscountPercentLow": 123,
"DiscountPercentHigh": 123,
"DiscountPercent": 123,
"HasDiscountPercentRange": false,
"AllDiscounted": false,
"AllOnClearance": false
},
"AdditionalData": {
"BulletPoints": [
"ABC",
"ABC"
],
"Tags": [
{
"Name": "ABC"
},
{
"Name": "ABC"
}
]
},
"ListingExtras": [
"ABC",
"ABC"
],
"IsLoyaltyEligible": false,
"HasPing": false,
"StoreBrandLogoUrl": "ABC",
"WhyPayPrice": 123.0,
"Has3DTour": false,
"ShippingDetails": {
"ShippingTemplateId": 123,
"SuggestedShipping": {
"Price": 123.0,
"Destination": "ABC",
"DeliveryTime": {
"MinValue": "ABC",
"MaxValue": "ABC"
},
"IsRural": false
}
},
"PriceType": 0,
"HasSpecialOffer": false,
"NewCarInformation": {
"Availability": 2,
"Condition": 1,
"CertifiedPreOwned": {
"LogoUrl": "ABC",
"DarkModeLogoUrl": "ABC"
}
},
"MemberDateJoined": "\/Date(1514764800)\/",
"LastServiceReview": {
"ServiceReviewerNickname": "ABC",
"ServiceReviewText": "ABC",
"ServiceReviewDateEntered": "\/Date(1514764800)\/"
},
"Sponsored": {
"TopSortProductId": "ABC",
"TopSortResolveBidId": "ABC",
"TopSortUniqueId": "ABC"
},
"MotorsExternalMediaOverview": {
"HasInstavid360Spinner": false
},
"ListingPlatform": 0,
"AllowsPickups": 0,
"SearchResultAttributes": [
{
"Id": 1,
"DisplayValue": "ABC",
"Name": "ABC"
},
{
"Id": 1,
"DisplayValue": "ABC",
"Name": "ABC"
}
]
}
],
"DidYouMean": "ABC",
"FoundCategories": [
{
"Count": 123,
"Category": "ABC",
"Name": "ABC",
"IsRestricted": false,
"CategoryId": 123,
"IsLeaf": false
},
{
"Count": 123,
"Category": "ABC",
"Name": "ABC",
"IsRestricted": false,
"CategoryId": 123,
"IsLeaf": false
}
],
"FavouriteId": 123,
"FavouriteType": 0,
"Parameters": [
{
"DisplayName": "ABC",
"Name": "ABC",
"LowerBoundName": "ABC",
"UpperBoundName": "ABC",
"Type": 0,
"AllowsMultipleValues": false,
"MutualExclusionGroup": "ABC",
"DependentOn": "ABC",
"ExternalOptionsKey": "ABC",
"DisplayValue": "ABC",
"Options": [
{
"Value": "ABC",
"Display": "ABC",
"Count": 123
},
{
"Value": "ABC",
"Display": "ABC",
"Count": 123
}
],
"DependentParameter": {
},
"DisplaySuggested": false,
"DisplayNew": false
},
{
"DisplayName": "ABC",
"Name": "ABC",
"LowerBoundName": "ABC",
"UpperBoundName": "ABC",
"Type": 0,
"AllowsMultipleValues": false,
"MutualExclusionGroup": "ABC",
"DependentOn": "ABC",
"ExternalOptionsKey": "ABC",
"DisplayValue": "ABC",
"Options": [
{
"Value": "ABC",
"Display": "ABC",
"Count": 123
},
{
"Value": "ABC",
"Display": "ABC",
"Count": 123
}
],
"DependentParameter": {
},
"DisplaySuggested": false,
"DisplayNew": false
}
],
"SortOrders": [
{
},
{
}
],
"MemberProfile": {
"FirstName": "ABC",
"Occupation": "ABC",
"Biography": "ABC",
"Quote": "ABC",
"Photo": "ABC",
"IsEnabled": false,
"DateRemoved": "\/Date(1514764800)\/",
"Member": {
"MemberId": 123,
"Nickname": "ABC",
"DateAddressVerified": "\/Date(1514764800)\/",
"DateJoined": "\/Date(1514764800)\/",
"UniqueNegative": 123,
"UniquePositive": 123,
"FeedbackCount": 123,
"IsAddressVerified": false,
"Suburb": "ABC",
"IsDealer": false,
"IsAuthenticated": false,
"IsInTrade": false,
"ImportChargesMayApply": false,
"Profile": {
"Occupation": "ABC",
"Biography": "ABC",
"Quote": "ABC",
"Photo": "ABC"
},
"IsTopSeller": false,
"IsRentiUser": false
},
"FavouriteId": 123,
"Store": {
"Name": "ABC",
"MemberId": 123,
"LogoImageUri": "ABC",
"BannerImageUri": "ABC",
"Promotions": [
{
"ImageUri": "ABC",
"Uri": "ABC",
"AltText": "ABC"
},
{
"ImageUri": "ABC",
"Uri": "ABC",
"AltText": "ABC"
}
],
"ShortDescription": "ABC",
"LargeBannerImage": {
"Small": "ABC",
"Medium": "ABC",
"Large": "ABC",
"XLarge": "ABC"
},
"StorePath": "ABC",
"SaleCount": 123,
"Location": "ABC",
"PhoneNumber": "ABC",
"Website": "ABC",
"Email": "ABC",
"Member": {
},
"Pages": [
{
"Heading": "ABC",
"Text": "ABC"
},
{
"Heading": "ABC",
"Text": "ABC"
}
],
"Tier": 0
},
"IsPropertyAgent": false
},
"SuperFeatures": [
{
"ListingId": 123,
"Title": "ABC",
"Category": "ABC",
"StartPrice": 123.0,
"BuyNowPrice": 123.0,
"StartDate": "\/Date(1514764800)\/",
"EndDate": "\/Date(1514764800)\/",
"IsFeatured": false,
"HasGallery": false,
"IsBold": false,
"IsHighlighted": false,
"HasHomePageFeature": false,
"MaxBidAmount": 123.0,
"AsAt": "\/Date(1514764800)\/",
"CategoryPath": "ABC",
"PictureHref": "ABC",
"HasPayNow": false,
"IsNew": false,
"RegionId": 123,
"Region": "ABC",
"SuburbId": 123,
"Suburb": "ABC",
"PickupLocality": {
"Suburb": "ABC",
"District": "ABC",
"Region": "ABC"
},
"BidCount": 123,
"IsReserveMet": false,
"HasReserve": false,
"HasBuyNow": false,
"NoteDate": "\/Date(1514764800)\/",
"ReserveState": 0,
"Attributes": [
{
"Name": "ABC",
"DisplayName": "ABC",
"Value": "ABC",
"DisplayValue": "ABC"
},
{
"Name": "ABC",
"DisplayName": "ABC",
"Value": "ABC",
"DisplayValue": "ABC"
}
],
"IsClassified": false,
"OpenHomes": [
{
"Start": "\/Date(1514764800)\/",
"End": "\/Date(1514764800)\/"
},
{
"Start": "\/Date(1514764800)\/",
"End": "\/Date(1514764800)\/"
}
],
"Subtitle": "ABC",
"IsBuyNowOnly": false,
"RemainingGalleryPlusRelists": 123,
"IsOnWatchList": false,
"GeographicLocation": {
"Latitude": 123.0,
"Longitude": 123.0,
"Northing": 123,
"Easting": 123,
"Accuracy": 0
},
"PriceDisplay": "ABC",
"TotalReviewCount": 123,
"PositiveReviewCount": 123,
"HasFreeShipping": false,
"IsClearance": false,
"WasPrice": 123.0,
"PercentageOff": 123,
"Branding": {
"LargeSquareLogo": "ABC",
"LargeWideLogo": "ABC",
"BackgroundColor": "ABC",
"TextColor": "ABC",
"StrokeColor": "ABC",
"DisableBanner": false,
"OfficeLocation": "ABC",
"LargeBannerURL": "ABC"
},
"IsSuperFeatured": false,
"ShortDescription": "ABC",
"PhotoUrls": [
"ABC",
"ABC"
],
"PromotionId": 123,
"HasEmbeddedVideo": false,
"VariantDefinitionSummary": {
"PriceLow": 123.0,
"PriceHigh": 123.0,
"Price": 123.0,
"HasPriceRange": false,
"DiscountPercentLow": 123,
"DiscountPercentHigh": 123,
"DiscountPercent": 123,
"HasDiscountPercentRange": false,
"AllDiscounted": false,
"AllOnClearance": false
},
"AdditionalData": {
"BulletPoints": [
"ABC",
"ABC"
],
"Tags": [
{
"Name": "ABC"
},
{
"Name": "ABC"
}
]
},
"ListingExtras": [
"ABC",
"ABC"
],
"IsLoyaltyEligible": false,
"HasPing": false,
"StoreBrandLogoUrl": "ABC",
"WhyPayPrice": 123.0,
"Has3DTour": false,
"ShippingDetails": {
"ShippingTemplateId": 123,
"SuggestedShipping": {
"Price": 123.0,
"Destination": "ABC",
"DeliveryTime": {
"MinValue": "ABC",
"MaxValue": "ABC"
},
"IsRural": false
}
},
"PriceType": 0,
"HasSpecialOffer": false,
"NewCarInformation": {
"Availability": 2,
"Condition": 1,
"CertifiedPreOwned": {
"LogoUrl": "ABC",
"DarkModeLogoUrl": "ABC"
}
},
"MemberDateJoined": "\/Date(1514764800)\/",
"LastServiceReview": {
"ServiceReviewerNickname": "ABC",
"ServiceReviewText": "ABC",
"ServiceReviewDateEntered": "\/Date(1514764800)\/"
},
"Sponsored": {
"TopSortProductId": "ABC",
"TopSortResolveBidId": "ABC",
"TopSortUniqueId": "ABC"
},
"MotorsExternalMediaOverview": {
"HasInstavid360Spinner": false
},
"ListingPlatform": 0,
"AllowsPickups": 0,
"SearchResultAttributes": [
{
"Id": 1,
"DisplayValue": "ABC",
"Name": "ABC"
},
{
"Id": 1,
"DisplayValue": "ABC",
"Name": "ABC"
}
]
},
{
"ListingId": 123,
"Title": "ABC",
"Category": "ABC",
"StartPrice": 123.0,
"BuyNowPrice": 123.0,
"StartDate": "\/Date(1514764800)\/",
"EndDate": "\/Date(1514764800)\/",
"IsFeatured": false,
"HasGallery": false,
"IsBold": false,
"IsHighlighted": false,
"HasHomePageFeature": false,
"MaxBidAmount": 123.0,
"AsAt": "\/Date(1514764800)\/",
"CategoryPath": "ABC",
"PictureHref": "ABC",
"HasPayNow": false,
"IsNew": false,
"RegionId": 123,
"Region": "ABC",
"SuburbId": 123,
"Suburb": "ABC",
"PickupLocality": {
"Suburb": "ABC",
"District": "ABC",
"Region": "ABC"
},
"BidCount": 123,
"IsReserveMet": false,
"HasReserve": false,
"HasBuyNow": false,
"NoteDate": "\/Date(1514764800)\/",
"ReserveState": 0,
"Attributes": [
{
"Name": "ABC",
"DisplayName": "ABC",
"Value": "ABC",
"DisplayValue": "ABC"
},
{
"Name": "ABC",
"DisplayName": "ABC",
"Value": "ABC",
"DisplayValue": "ABC"
}
],
"IsClassified": false,
"OpenHomes": [
{
"Start": "\/Date(1514764800)\/",
"End": "\/Date(1514764800)\/"
},
{
"Start": "\/Date(1514764800)\/",
"End": "\/Date(1514764800)\/"
}
],
"Subtitle": "ABC",
"IsBuyNowOnly": false,
"RemainingGalleryPlusRelists": 123,
"IsOnWatchList": false,
"GeographicLocation": {
"Latitude": 123.0,
"Longitude": 123.0,
"Northing": 123,
"Easting": 123,
"Accuracy": 0
},
"PriceDisplay": "ABC",
"TotalReviewCount": 123,
"PositiveReviewCount": 123,
"HasFreeShipping": false,
"IsClearance": false,
"WasPrice": 123.0,
"PercentageOff": 123,
"Branding": {
"LargeSquareLogo": "ABC",
"LargeWideLogo": "ABC",
"BackgroundColor": "ABC",
"TextColor": "ABC",
"StrokeColor": "ABC",
"DisableBanner": false,
"OfficeLocation": "ABC",
"LargeBannerURL": "ABC"
},
"IsSuperFeatured": false,
"ShortDescription": "ABC",
"PhotoUrls": [
"ABC",
"ABC"
],
"PromotionId": 123,
"HasEmbeddedVideo": false,
"VariantDefinitionSummary": {
"PriceLow": 123.0,
"PriceHigh": 123.0,
"Price": 123.0,
"HasPriceRange": false,
"DiscountPercentLow": 123,
"DiscountPercentHigh": 123,
"DiscountPercent": 123,
"HasDiscountPercentRange": false,
"AllDiscounted": false,
"AllOnClearance": false
},
"AdditionalData": {
"BulletPoints": [
"ABC",
"ABC"
],
"Tags": [
{
"Name": "ABC"
},
{
"Name": "ABC"
}
]
},
"ListingExtras": [
"ABC",
"ABC"
],
"IsLoyaltyEligible": false,
"HasPing": false,
"StoreBrandLogoUrl": "ABC",
"WhyPayPrice": 123.0,
"Has3DTour": false,
"ShippingDetails": {
"ShippingTemplateId": 123,
"SuggestedShipping": {
"Price": 123.0,
"Destination": "ABC",
"DeliveryTime": {
"MinValue": "ABC",
"MaxValue": "ABC"
},
"IsRural": false
}
},
"PriceType": 0,
"HasSpecialOffer": false,
"NewCarInformation": {
"Availability": 2,
"Condition": 1,
"CertifiedPreOwned": {
"LogoUrl": "ABC",
"DarkModeLogoUrl": "ABC"
}
},
"MemberDateJoined": "\/Date(1514764800)\/",
"LastServiceReview": {
"ServiceReviewerNickname": "ABC",
"ServiceReviewText": "ABC",
"ServiceReviewDateEntered": "\/Date(1514764800)\/"
},
"Sponsored": {
"TopSortProductId": "ABC",
"TopSortResolveBidId": "ABC",
"TopSortUniqueId": "ABC"
},
"MotorsExternalMediaOverview": {
"HasInstavid360Spinner": false
},
"ListingPlatform": 0,
"AllowsPickups": 0,
"SearchResultAttributes": [
{
"Id": 1,
"DisplayValue": "ABC",
"Name": "ABC"
},
{
"Id": 1,
"DisplayValue": "ABC",
"Name": "ABC"
}
]
}
],
"SearchQueryId": "ABC",
"AutoCategoryJump": false,
"FavouriteFrequency": 123,
"FavouritePushFrequency": 0,
"SeoDrivenRedirectionData": {
"UrlInfo": {
"Robots": "ABC",
"SeoDrivenCanonicalUrl": "ABC",
"Href": "ABC",
"QueryParamsCollection": [
{
"Key": "ABC",
"Value": "ABC"
},
{
"Key": "ABC",
"Value": "ABC"
}
]
},
"HttpStatusCode": "ABC",
"HasBeenMigrated": false
},
"BusinessLine": 0,
"AggregateCounts": [
{
},
{
}
]
}
