Get products using search

How to get products and available refining filters for a specified search term.

URL

HTTP Get

http://api1.asos.com/productlisting/search/{searchTerm}/{pageNumber}/{sortBy}/en_API/{currency}?op={refine}&locale={locale}&country={country}&api_key={apiKey}

Parameters

Name Type Description Default Value Example Value Optional
currency string The currency to show prices in (more info). GBP EUR no
locale string A parameter to identify the location set on the user's mobile device, which can be used to customize content based on that location. en_GB en_US yes
country string Current geographical location of the device user GB AU yes
pageNumber int The page number of the results to return (starts at 1)
1 2 no
refine string Semi colon delimited string of refinement filter options in the format NameOne:ValueOne;NameTwo:ValueTwo
floor:floor_6662 yes
searchTerm string Search query text evening dress no
sortBy string The order in which product listings will be returned (more info). FreshnessAscending PriceDescending no
apiKey string Your API key. Request yours here 1a2b3c4d5e6f7g8h9i no

Example Request

http://api1.asos.com/productlisting/search/dressses/1/PriceAscending/en_API/GBP?op=floor:floor_6662&locale=en_US&country=AU&api_key=1a2b3c4d5e6f7g8h9i

 

Example Response

 

{
   "AlsoSearched":[
      "dresses"
   ],
   "Description":"dressses",
   "Facets":[
      {
         "FacetValues":[
            {
               "Count":4,
               "Id":"base_colour_2",
               "Name":"Green"
            },
            {
               "Count":1,
               "Id":"base_colour_16",
               "Name":"Grey"
            },
            {
               "Count":3,
               "Id":"base_colour_9",
               "Name":"Pink"
            },
            {
               "Count":3,
               "Id":"base_colour_5",
               "Name":"White"
            }
         ],
         "Id":"base_colour",
         "Name":"Colour",
         "Sequence":0
      },
      {
         "FacetValues":[
            {
               "Count":1,
               "Id":"46",
               "Name":"£46.00"
            }
         ],
         "Id":"currentprice",
         "Name":"Current Price",
         "Sequence":0
      }
   ],
   "ItemCount":2,
   "Listings":[
      {
         "Brand":"Gap Kids",
         "CurrentPrice":"NOW £13.00",
         "HasMoreColours":false,
         "IsInSet":false,
         "PreviousPrice":"£17.50",
         "ProductId":978537,
         "ProductImageUrl":[
            "http://images.asos.com/inv/y/127/1178/978537/grngingh/image1l.jpg"
         ],
         "RRP":"",
         "Title":"Gap Crinkle Dress"
      },
      {
         "Brand":"Littlehorn",
         "CurrentPrice":"NOW £15.00",
         "HasMoreColours":false,
         "IsInSet":false,
         "PreviousPrice":"£19.00",
         "ProductId":1004927,
         "ProductImageUrl":[
            "http://images.asos.com/inv/x/127/1178/1004927/green/image1l.jpg"
         ],
         "RRP":"",
         "Title":"Littlehorn When My Love Grows Dress"
      }
   ],
   "RedirectUrl":"",
   "SortType":"PriceAscending"
}

1 Comment

  1. citysexylingerie3 years ago

    We are a Chinese sexy lingerie wholesale company, the company's product quality is very good and the price is cheap! Believe, with our cooperation you must be very happy! Our product is very fashion sexy. I am sure you will love, Please try to click Link: http://www.citysexylingerie.com

Please sign in to post a comment.