Overview
- It is an API that retrieves product information based on the specified search conditions.
- 2 types of APIs are available, which must be used properly according to the purpose.
- The below 2 APIs use "API key authentication", so it is necessary to send the API key in the request header when calling the API.
- All products specification information URL acquisition API
- GET
- https://api.murata.com/v2/products/getproductdatadownloadurl
Acquires the URL with the specification information of all products.
- All products specification information URL acquisition API call format
- https://api.murata.com/v2/products/getproductdatadownloadurl?category=<Category ID>&lang=<language identifier>
-
- *Specifying the Category ID is mandatory.
- *If lang is not specified, it will be in English.
- *The URL for downloading all product data has an expiration date and can be accessed for 7 days after the URL is issued.
- Each product specification information acquisition API
- GET
- https://api.murata.com/v2/products
Acquires the specification information for 2000 products from the top of the products that match the search conditions.
- Each product specification information acquisition API call format
- https://api.murata.com/v2/products?$filter=<search condition> and <search condition>&$orderby=<sort order>,<sort order>&lang=<language identifier>
-
- *You can search without specifying search conditions. See the table below for the values that can be specified in the search condition.
- *The value specified in the search condition must be encoded.
- *If lang is not specified, it will be in English.
- *You can specify a single search condition or multiple search conditions. To specify multiple search conditions, connect <search condition> with "and". Please refer to the table below for details on how to specify search conditions.
- *To specify the sort order in $orderby, specify "sort_condition asc" for ascending order and "sort_condition desc" for descending order. To specify multiple sort orders, connect <sort order> with ",".
Request Parameter
All products specification information URL acquisition API
Each product specification information acquisition API
*1 To specify a category in the search condition, use the "Category ID" in the table below.
Possible values for each search condition
*2 Only the values listed in the table below can be used.
*3 Search specifications are the same as *2. However, the data format of the response is different.
In the case of *2, when returning multiple values, they are returned in a list format, and in the case of *3, they are returned in a comma-separated string.
For details on the data format, see the sample JSON file at the bottom of this page.
Search Condition Specification Method
*Encoded string for "±" is "%C2%B1", for "%" is "%25" and for "|" is "%7C".
Response
All products specification information URL acquisition API
Each product specification information acquisition API
*4 Regarding "HasMoreHits"
"Each product specification information acquisition API" acquires the specification information for 2000 products from the top of the products that match the search conditions.
The specification of the return value of the response item "HasMoreHits (Flag if there are other applicable products)" of "Each product specification information acquisition API" is as follows.
- When "HasMoreHits=true": There are products that match the search conditions in addition to the returned products.
- When "HasMoreHits=false": There are no products that match the search conditions other than the returned products.
If "HasMoreHits=true" and if you want to get the remaining part numbers, there is a following method.
- Specify additional search conditions such that the number of part numbers in the response is less than or equal to the upper limit of the number of part numbers that can be retrieved using "Each product specification information acquisition API".
API call example
Request
- All products specification information URL acquisition API
Example 1) When Category ID is 'ceramicCapacitorsSMD' is specified in the search condition
- lang=ja(Japanese)
https://api.murata.com/v2/products/getproductdatadownloadurl?category=ceramicCapacitorsSMD&lang=ja
- Each product specification information acquisition API
Example 1) When part number is 'GCM0332C1E100FA01J' is specified in the search condition
- https://api.murata.com/v2/products?$filter=Partno eq 'GCM0332C1E100FA01J'
Example 2) When part number that contains 'GRM' or 'GCM' is specified in the search condition
- https://api.murata.com/v2/products?$filter=contains(Partno,'GRM%7CGCM')
Example 3) When category is 'ceramicCapacitorsSMD' and product status is 'Under Development' is specified in the search condition
- lang not specified, or lang=en(English)
https://api.murata.com/v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Status eq 'Under Development'
https://api.murata.com/v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Status eq 'Under Development'&lang=en
- lang=ja(Japanese)
https://api.murata.com/v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Status eq '開発中'&lang=ja
- lang=zh(Chinese)
https://api.murata.com/v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Status eq '开发中'&lang=zh
Response
*Normal case
You can download the sample response in JSON format from the links below.
- Response of all product data download URL (Originally, data for all products can be retrieved, but since it is a sample, only one product information is available.)
- Each product specification information acquisition API (When 1 part number each of Ceramic Capacitors (SMD), Ceramic Capacitors (Lead) and Inductors are specified in the search condition)
*Error cases
Here are some common error responses and their possible causes.
| HTTP status |
Likely cause |
| 400 Bad Request |
There is a problem with the query parameter. |
| 403 Forbidden |
There is a problem with the specified API key or API method or resource. |
| 404 Not Found |
The resource being accessed does not exist. |
| 429 Too Many Requests |
Blocked by the rate limiter. |
| 500 Internal Server Error |
There was a problem on the server side. |
Excel function which returns information about our products. Display the latest information for the corresponding status, specification, and data, etc. by configuring the Excel function.
The add-in file must be downloaded and installed in advance when using this feature.
For more details about the add-in file installation procedure, function call format, etc., click the version number links in the table below.
Video introducing the product information Excel Add-in feature
- *1The planned date of discontinuation may change depending on the API usage status.