Number of part numbers


Find the number of unique part numbers for one catalog, one category or one product.


This web service requires an API Key. Please use the form to request your API Key.


This API returns the number of unique part numbers depending on the level of data. The number of part numbers is only for the ones which can be predefined. If a part number depends on a manual input, it can not be counted. The number includes the sum of all the sub products under the selected level (catalog or category).

Building a URL

The CountPartNumbers API request takes the following form:


Certain parameters are required while others are optional. As it is standard in URLs, all parameters are separated using the ampersand (&) character. The list of parameters and their possible values are enumerated below.

Required parameters

Parameter NameData typeDefault valueDescription
ApiKeystringnoneCode calling an API to track and control how the API is used
FormatstringnoneAnswer file type (xml, json)
ClassificationIDstringnoneClassificationId given by the CatalogsList API

Optional parameters

Parameter NameData typeDefault valueDescription
UserEmailstringnoneUser email / User ID
ActiveJsonLightboolean0Enables the light version when json is the answer file type
Pathstringroot of the catalogCategory path which contents a list of product(s) given by the CategoriesList API
PartIDstringnoneProduct ID given by the ProductsList

Example of CountPartNumbers API

The request below returns the number of part numbers for the ASCO Numatics catalog, for the “Pneumatics” category, as an xml file.{ApiKey}

By changing the Format and adding the ActiveJsonLight, CountPartNumbers returns the number, as a light Json file.{ApiKey}

CountPartNumbers responses

CountPartNumbers responses are returned in the format indicated by the Format parameter within the URL request’s path.

JSON Output

A sample HTTP request is shown below, displaying the number of part numbers.


XML Output

Same example as above.


CountPartNumbers response elements

CountPartNumbers responses contain one element:

  • “count”: it is the number of unique part numbers in all products of the current catalog/category and the sub categories

Developer support

Please contact us for any problem, question or comment related to this content integration.

Last updated September 26, 2017