# API Requests

The TrustedParts.com API receives search requests via HTTPS POST. It supports both JSON and XML requests and responses. Please indicate with your requests which format you would like to use by including the "Content-Type" and "Accept" headers set to either "application/json" or "application/xml". The url for the API is: https://api.trustedparts.com/api/Search/Query

# Contents

# Fields

*Required

Name Value Additional Information
CompanyID* Enter the assigned company identifier The assigned company identifier can be found on the API Credentials page.
APIKey* Enter the assigned API key The assigned API key can be found on the API Credentials page.
Queries* Add a separate Queries section for each part number search. Note: If you enter multiple part numbers, an exact match search will be performed for each part number. Partial match results are only available for single part number requests.
SearchToken* Enter the part number The part number must be at least 3 characters long.
Manufacturers Add this section to limit the search results to one or more manufacturers. Omit this section to search all authorized manufacturers.
     - Name Enter the name of the manufacturer Add separate Name elements for each manufacturer to search. See the List of Manufacturer Names for supported manufacturers.
CountryCode Enter a two-character ISO code If left blank, the search results default to US.
CurrencyCode Enter a three-character ISO code If left blank, the search results default to USD.
Distributors Add this section to limit a search to one or more distributors. Omit this section to search all authorized distributors.
Name Enter the name of the distributor Add separate Name elements for each distributor to search. See the List of Distributor Names for supported distributors.
InStockOnly* Set to true or false Set to true to view in-stock results only. Set to false to view all results.
ExactMatch* Set to true or false Set to true to view parts that match the SearchToken exactly. Set to false to include partial match results. Note: Partial match results are only available for single part number requests. Most punctuation and spacing are ignored when determining what is an exact match. For instance, BAT-54C is an exact match for the SearchToken BAT54C.
IsCrawler* Set to true or false Set to true if the end user is a crawler or bot (e.g. Google, Bing, Baidu). Set to false if the end user is not a crawler or if undetermined.
UseCachedData Set to true or false If this parameter is not supplied or set to false, the TrustedParts.com API will provide results based on real-time stock and pricing services provided by participating distributors. This is the preferred setting since it yields the most accurate results. However, if you need extremely fast responses or need to submit a high volume of requests in a short period of time, you may set this parameter to true. This will direct the TrustedParts.com API to use an optimized search process that retrieves results from locally-cached data instead of real-time data. Note: If the IsCrawler parameter is set to true or the TrustedParts.com API detects that a request is made on behalf of a crawler, the UseCachedData parameter is ignored since results for crawlers are always retrieved from locally cached data.
UserAgent* Enter user agent For requests made by a web site: Provide the web browser user agent of the end user or crawler who will view the results. Please ensure the accuracy of this value so that TrustedParts.com can verify the identity of users who receive results.
For requests made by an internal application instead of a web site: Provide the name of the application that is making the request and, if possible, a unique user identifier (preferably an ID number; no personally identifiable information should be supplied).
SourceIP* Enter the IP address For requests made by a web site: Provide the IP (Internet Protocol) address of the end user or crawler who will view the results. Please ensure the accuracy of this value so that TrustedParts.com can verify the identity of users who receive results.
For requests made by an internal application instead of a web site: Provide an external IP address used by your location. Note: Please do not provide an internal IP address for this value.

Once your API Key Request has been approved, you can use your credentials to test searches in our API Search Tool.

# API Request Limits

# Soft Limits

The following chart indicates the soft limits for TrustedParts.com API requests. Requests from API customers who exceed these limits are still processed, but they use a search process that consumes fewer system resources. This optimized search process renders pricing and availability information from cached data instead of real-time data. Note: The soft limits only apply to requests where the IsCrawler and UseCachedData parameters are false. If either of those parameters are true, the soft limits do not apply.

Interval Max Number of Parts
10 Seconds 50
1 Minute 150
1 Hour 2,000
24 Hours 15,000

# Hard Limits

The TrustedParts.com API will not process requests that contain more than 50 part numbers. If you need to search for more than 50 part numbers, please make multiple requests to the TrustedParts.com API with each request having no more than 50 part numbers. The following chart indicates other hard limits for TrustedParts.com API requests. If an API customer exceeds one of these limits, their API key will be suspended for an hour. Repeated suspensions could lead to an API key being revoked.

Interval Max Number of Parts
10 Seconds 250
1 Minute 1,000
1 Hour 25,000
24 Hours 250,000

# Custom Request Limits

Please make an effort to keep your request volume within the Soft Limits. If you have a use case where you will regularly exceed your Soft Limits and cannot make adjustments to prevent exceeding them, you may send an email to user-requests@trustedparts.com to request that they be increased. Since Hard Limits protect the health of the TrustedParts.com infrastructure, it is very rare that they would be increased for a customer.

The Trusted Source for Authorized Inventory

TrustedParts.com was created by ECIA in collaboration with participating distributors as a free service to support the authorized electronic components industry by giving users access to aggregated price and availability data for genuine parts from only authorized sources.

While other inventory aggregation sites may include data from sources that are not authorized by the manufacturer, ECIA works extensively on an ongoing basis to verify that price and availability data displayed on TrustedParts.com is only for products for which the distributors are authorized/franchised. This is why TrustedParts.com is the best source for searching the authorized channel for the electronic components you need.
Membership in ECIA is not required to participate on the site.

To learn more about how to list your inventory, or to view our Terms of Use and other information related to participating on TrustedParts.com, please visit our documentation for participating distributors.

©2021 Electronic Components Industry Association