Abfrage per \/products\/search gefolgt von Key\/Value-Paaren, die den Suchfilter beschreiben.<\/p>\n\n\n\n
A call in the form of \/products\/search followed by key\/value pairs describing the search filter:<\/p>\n\n\n\n
The resulting list can either be empty, contain exactly one product or contain up to 50 products.
<\/p>\n\n\n\n
The ‘page’ query parameter allows the next 50 products to be requested for search results with >50 products.<\/p>\n\n\n\n
For example, ‘page = 3’ would request products 101 to 150.<\/p>\n\n\n\n
https:\/\/api.itscope.com\/2.1\/products\/search\/hstpid=MZ-75E250B%252FEU;manufacturer=1015\/standard.xml?page=3<\/a><\/p>\n\n\n\n No information regarding how many products were found is provided in advance during the first request, meaning it is necessary to work with page = xx until there are no more products in order to reach the end of the list. The ‘item’ parameter allows you to retrieve the nth<\/em> data set.<\/p>\n\n\n\n For example, if page = 2 and item = 3, this would retrieve the 3rd result from the 2nd page from a list of (e.g.) 90 products. As each page contains 50 results, this example would return the 53rd result from the list.<\/p>\n\n\n\n https:\/\/api.itscope.com\/2.1\/products\/search\/hstpid=MZ-75E250B%252FEU;manufacturer=1015\/standard.xml?page=2&item=3<\/a><\/p>\n\n\n\n The item number can only be between 1 and 50, i.e. the item number does not depend on the parameter page. You can use the ‘plzproducts’ query parameter to find and display price list lines<\/a>. These products end with a ‘999’ on the ITscope online platform. This parameter is false<\/strong> by default<\/strong>, i.e. not set. Product searches can be sorted according to specific criteria.<\/p>\n\n\n\n Here is a list of sorting criteria including an explanation:<\/p>\n\n\n\n These request parameters are only available starting with API 2.1<\/strong>. These parameters filter according to the entryDate export field for the product, see the relevant format descriptions for products<\/a> for more information. The entry date indicates when the product was added to the ITscope catalogue and not when it was last modified. It is therefore not possible to use these parameters to search for recently modified products.<\/p>\n\n\n\n Historical data and the corresponding request parameters<\/a> are only available starting with API 2.1<\/strong>. When using more than 50 items in a request, you will get an 400 Bad Request error.<\/mark><\/p>\n\n\n\n Looking for a range of ITscope product IDs<\/strong>:<\/p>\n\n\n\n This search can be achieved by using the products\/id and products\/ids api methods<\/a>. Search for a series of EANs<\/strong>:<\/p>\n\n\n\n https:\/\/api.itscope.com\/2.1\/products\/search\/ean=5032037044288,7636490025914,8806086522977\/standard.xml<\/a><\/p>\n\n\n\n This example looks for the following EANs: 8806086522977, 7636490025914, 0194252515587. Up to 50 EANs can be specified in a single request. Looking for a number of manufacturer item numbers<\/strong>:<\/p>\n\n\n\n https:\/\/api.itscope.com\/2.1\/products\/search\/hstpid=0553C001AA,N9J71AE%23301,CLT-P406B%2FELS\/standard.xml<\/a><\/p>\n\n\n\n In this example, we are looking for the following manufacturer item numbers: 0553C001AA, N9J71AE#301, CLT-P406B\/ELS. Up to 50 manufacturer item numbers can be specified in one request.<\/p>\n\n\n <\/p>\n\n\n\n Looking for all products that match a manufacturer and their manufacturer item number:<\/strong><\/p>\n\n\n\n e.g.: Samsung as the manufacturer (ID: 1015, this can be found via the manufacturer API call<\/a>) and manufacturer item number MZ-75E250B\/EU<\/p>\n\n\n\n https:\/\/api.itscope.com\/2.1\/products\/search\/hstpid=MZ-75E250B%252FEU;manufacturer=1015\/standard.xml<\/a><\/p>\n\n\n\n Additionally, in this example with manufacturer item number ‘MZ-75E250B\/EU’, the \/ sign was masked by ‘%2F’ as the ‘\/’ sign has a special meaning in the URL and cannot be unmasked.<\/p>\n\n\n Searching all products that match a manufacturer’s item number<\/strong>: Additionally, in this example with manufacturer item number ‘A7E34AA#ABB’, the ‘#’ character was masked using a ‘%23’ as the ‘#’ character has a special meaning in the URL and cannot be unmasked.<\/p>\n\n\n Searching for all products that fit a category, a manufacturer, and specific property clusters<\/strong>: The ITscope IDs of the manufacturers can be retrieved via the manufacturer metadata API<\/a>.<\/p>\n\n\n\n The ITscope IDs of the categories can be loaded via the categories metadata API<\/a>.<\/p>\n\n\n\n The ITscope IDs of the property clusters can, with the appropriate authorisation<\/a><\/strong>, be retrieved via an export<\/a> or product request<\/a>. However, only property clusters that correspond to the products in the retrieval result<\/a> are output. There is currently no way to get a complete list of property clusters via API.<\/strong> Searching for all products that match a category, manufacturer, and specific entry date period<\/strong>:<\/p>\n\n\n\n https:\/\/api.itscope.com\/2.1\/products\/search\/producttype=114;manufacturer=1032\/standard.xml?productEntryFrom=2019-11-01<\/em> https:\/\/api.itscope.com\/2.1\/products\/search\/producttype=114;manufacturer=1032\/standard.xml?productEntryFrom=2019-11-01&productEntryTo=2019-12-01<\/em> The ITscope IDs of the manufacturers can be retrieved via the manufacturer metadata API<\/a>.<\/p>\n\n\n\n The ITscope IDs of the categories can be loaded via the categories metadata API<\/a>. Carrying out a free text search<\/strong>
<\/p>\n\n\n\nQuery parameter item<\/h2>\n\n\n\n
<\/p>\n\n\n\nQuery Parameter plzproducts<\/h2>\n\n\n\n
<\/p>\n\n\n\nQuery parameter sort<\/h2>\n\n\n\n
\n
<\/li>\n<\/ul>\n\n\n\nQuery parameter for filtering based on product entry date<\/h2>\n\n\n\n
\n
<\/li>\n<\/ul>\n\n\n\nQuery parameters for historical data<\/h2>\n\n\n\n
<\/p>\n\n\n\nExamples – mass queries up to 50 items<\/h2>\n\n\n\n
<\/p>\n\n\n\n
<\/p>\n\n\n\n
For example, the character ‘#’ as %23 -> %2523, or the character ‘\/’ as %2F -> %252F <\/div>\n <\/div>\n <\/div>\n\n\nExamples – filter combinations<\/h2>\n\n\n\n
https:\/\/api.itscope.com\/2.1\/products\/search\/hstpid=A7E34AA%2523ABB\/standard.xml<\/a><\/em><\/p>\n\n\n\n
https:\/\/api.itscope.com\/2.1\/products\/search\/producttype=114;manufacturer=1032;cluster=2404144;cluster=1061\/standard.xml<\/em>
<\/a>
This example looks for products in the ‘disk’ category (producttype = 114), from Seagate (manufacturer ID = 1032), ‘size 2.5″‘ as the property cluster (cluster = 1061) and 4TB storage capacity (cluster = 2404144).<\/p>\n\n\n\n
<\/p>\n\n\n\n
<\/a>
This example looks for products in the ‘disk’ category (producttype = 114), from Seagate (manufacturer = 1032) and an entry date between 01.11.2019 and the current date of the request.<\/p>\n\n\n\n
<\/a>
This example looks for products in the ‘disk’ category (producttype = 114), from Seagate (manufacturer = 1032), and an entry date between 01.11.2019T00:00:00 and 01.12.2019T00:00:00.<\/p>\n\n\n\n
<\/p>\n\n\n\nExamples – free text search<\/h2>\n\n\n\n
https:\/\/api.itscope.com\/2.1\/products\/search\/keywords=lenovo%20thinkpad%20i5\/standard.xml
<\/a>The example above carries out a search for a Lenovo Thinkpad I5.
<\/p>\n\n\n\n