Product Information API Version2

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.
    1. 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.
    2. 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

Swipe left or right to change screens View in landscape mode.
Request Header
No. Physical name Logical name Explanation
1 x-api-key API Key Used for API key authentication when using API.
Swipe left or right to change screens View in landscape mode.
Query Parameters
No. Physical name Logical name Explanation
1 category Category ID Can specify ceramicCapacitorsSMD, ceramicCapacitorsLead, inductors.
2 lang Language Can specify ja, zh, en. If unspecified or not applicable, en (English) is considered.

Each product specification information acquisition API

Swipe left or right to change screens View in landscape mode.
Request Header
No. Physical name Logical name Explanation
1 x-api-key API Key Used for API key authentication when using API.
Swipe left or right to change screens View in landscape mode.
Request Parameters
No. Physical name Logical name Explanation
1 lang Language Can specify ja, zh, en. If unspecified or not applicable, en (English) is considered.
2 $filter Search conditions Specify search conditions.
3 $orderby Sort order Specify the sort order of search results.
Specify "asc" for ascending order and "desc" for descending order.
Swipe left or right to change screens View in landscape mode.
Search Conditions
No. Physical name Logical name Type No
category
specified
Ceramic Capacitors Inductors Expla-
nation
SMD,Lead SMD Lead
1 Category Product Category String × *1
2 Partno Part Number String -
3 Status Status String *2
4 NewProduct New Product Boolean -
5 PackageType Package Type String -
6 Application Application String *2
7 AecQ200Support AEC-Q200 Support Boolean -
8 Rohs RoHS Boolean -
9 Reach REACH Boolean -
10 ReferenceMass Reference Mass Double -
11 Length Length(m) Double × × -
12 Width Width(m) Double × × -
13 Thickness Thickness(m) Double × -
14 ThicknessMax Thickness(max.)(m) Double × -
15 OuterDiameter Outer Diameter(m) Double × × × × -
16 LeadSpace Lead Space (m) Double × × × × -
17 SizecodeMm Size Code mm String × × × -
18 SizecodeInch Size Code Inch String × × × -
19 SmdType SMD Type String × × × × *2
20 Capacitance Capacitance(F) Double × × -
21 ToleranceCapacitance Tolerance Capacitance String × × -
22 RatedVoltageClass Rated Voltage
Class
String × × *2
23 RatedVoltage Rated Voltage(V) Double × × -
24 TemperatureCharacteristicsCompliedStandard Temperature
Characteristics
Complied
Standard
String × × × *2
25 TemperatureCharacteristics Temperature Characteristics String × × × -
26 MaxOperatingTemperature Maximum Operating
Temperature(℃)
Double × × -
27 Benefits Benefits String × × *2
28 Standard Standard String × × *2
29 Mounting Mounting String × × *2
30 TargetCircuitCategory Target Circuit Category String × × × × *2
31 Inductance Inductance Double × × × × -
32 InductanceTolerance Inductance Tolerance String × × × × -
33 RatedCurrentItemp Rated Current (based on temperature rise) Double × × × × -
34 Rdc DC resistance (Ω) (Rdc) Double × × × × -
35 Srf Self Resonance Frequency(SRF) Double × × × × -
36 Construction Construction String × × × × *2

*1 To specify a category in the search condition, use the "Category ID" in the table below.

Swipe left or right to change screens View in landscape mode.
No. Category Name Category ID Explanation
Intermediate category Bottom category
1 Ceramic Capacitors
(SMD,Lead)
- ceramicCapacitors When this category is specified, Ceramic Capacitors (SMD) and Ceramic Capacitors (Lead) product information is retrieved.
2 Ceramic Capacitors (SMD) ceramicCapacitorsSMD -
3 Ceramic Capacitors (Lead) ceramicCapacitorsLead -
4 Inductors - inductors -

Possible values for each search condition

*2 Only the values listed in the table below can be used.

Swipe left or right to change screens View in landscape mode.
No. Physical name Logical name Available values
English Japanese Chinese
1 Status Status Under Development 開発中 开发中
In Production 生産中 目前生产
NRND NRND NRND
To be discontinued 生産中止予定 计划停产
Discontinued 生産中止 已经停产
2 Standard Standard Certified by safety standard 安全規格認定品 安全规格认证品
Based on the Electrical
Appliance and Material Safety
Law of Japan
電気用品安全法準拠品 符合日本国内电气用品安全法
3 Mounting Mounting Reflow soldering リフローはんだ 回流焊接
Flow soldering フローはんだ 波峰焊接
Bonding ボンディング 结合
Welding 溶接 焊接
Fixing with screws ねじ止め 螺丝固定
Conductive adhesive 導電性接着剤 导电性粘合剂
4 Rated Voltage Class Rated Voltage Class AC AC AC
DC DC DC
5 TemperatureCharacteristicsCompliedStandard Temperature
Characteristics
Complied Standard
JIS JIS JIS
EIA EIA EIA
Murata Murata Murata
6 Application Application General 一般用 一般用
Powertrain/Safety パワートレイン/セーフティー 动力传动/安全
Infotainment インフォテインメント 多媒体信息娱乐服务
Implanted Medical Devices インプラント医療機器用 植入式医疗设备用
7 Benefits Benefits Withstands voltage of 10-40 kV 10-40kVの耐圧 10-40kV的耐电压
Low dissipation/HIQ 低損失/High Q 低损耗/High Q
Low inductance 低インダクタンス 低电感
Anti-noise, low distortion 鳴き対策・低歪 啸叫对策/低失真
Fail safe フェールセーフ 防故障功能
Anti-crack while deflecting たわみクラック対策 弯曲裂纹对策
Anti-crack while soldering はんだクラック抑制 减少焊接裂纹
No DC bias Characteristics DCバイアス依存無し 无直流偏置依赖性
Anti-ion migration イオンマイグレーション抑制品 抑制离子移动的产品
Noise suppression ノイズ対策 静噪
8 SmdType SMD Type Two-terminal 2端子 2端子
Metal terminal 金属端子 金属端子
Multi-terminal 多端子 多端子
LW reversed LW逆転 LW逆转型
Array type アレイ型 排容型
Top & bottom electrode 上下電極 上下电极
On substrates 基板付き 基板贴装
Polymer Capacitors 高分子コンデンサ 聚合物电容器
3-Terminal Capacitors 3端子コンデンサ 三端子电容器
Resin molding 樹脂モールド 树脂封装
9 TargetCircuitCategory Target Circuit Category Power lines circuits 電源系回路 电源线回路
General circuits 一般回路 一般回路
High frequency circuits 高周波回路 高频回路
10 Construction Construction Wire wound type (Ferrite) 巻線フェライトコア 绕线型铁氧体磁珠
Wire wound type (Non mag) 巻線非磁性コア 绕线型非磁性芯
Wire wound type (Metal) 巻線メタルアロイコア 绕线型金属合金磁珠
Film type フィルムタイプ 薄膜型
Multilayer type 積層タイプ 多层型
2 coils in 1 unit 2in1インダクタ 2in1电感器

Search Condition Specification Method

Swipe left or right to change screens View in landscape mode.
Search type Search condition Search condition specification example
Part number search, String type item search Prefix match (single value)
  • /v2/products?$filter=startswith(Partno,'GRM')
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and startswith(ToleranceCapacitance,'%C2%B110')
Prefix match (multiple values)
  • /v2/products?$filter=startswith(Partno,'GRM%7CGCM')
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and startswith(ToleranceCapacitance,'%C2%B110%7C%C2%B120')
Intermediate match (single value)
  • /v2/products?$filter=contains(Partno,'CD72')
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and contains(ToleranceCapacitance,'0.1')
Intermediate match (multiple values)
  • /v2/products?$filter=contains(Partno,'CD72%7CCD80')
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and contains(ToleranceCapacitance,'0.1%7C0.25')
Exact match (single value)
  • /v2/products?$filter=Partno eq 'GRM31CD80G107MEA8L'
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and ToleranceCapacitance eq '%C2%B120%25'
Exact match (multiple values)
  • /v2/products?$filter=Partno eq 'GRM31CD80G107MEA8L%7CGRM31CD80G107MEA8K'
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and ToleranceCapacitance eq '%C2%B120%25%7C%C2%B10.1pF'
Double type item search Greater than or equal to /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length ge 0.0032
Less than or equal to /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length le 0.0032
Equal /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length eq 0.0032
Greater than /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length gt 0.0032
Less than /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length lt 0.0032
Range /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length ge 0.0032 and Length le 0.0045
Boolean type item search Equal /v2/products?$filter=NewProduct eq true
List value item search (items listed in the table in *2) Exact match (single value)
  • 【Japanese】
    /v2/products?$filter=Status eq '生産中'&lang=ja
  • 【Chinese】
    /v2/products?$filter=Status eq '目前生产'&lang=zh
  • 【English】
    /v2/products?$filter=Status eq 'In Production'&lang=en
    /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and RatedVoltageClass eq 'AC'
Exact match (multiple values)
  • 【Japanese】
    /v2/products?$filter=Status eq '生産中%7C開発中'&lang=ja
  • 【Chinese】
    /v2/products?$filter=Status eq '目前生产%7C开发中'&lang=zh
  • 【English】
    /v2/products?$filter=Status eq 'In Production%7CUnder Development'&lang=en
    /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and RatedVoltageClass eq 'AC%7CDC'

*Encoded string for "±" is "%C2%B1", for "%" is "%25" and for "|" is "%7C".

Response

All products specification information URL acquisition API

Swipe left or right to change screens View in landscape mode.
No. Physical name Logical name Type Ceramic Capacitors Inductors Explanation
SMD Lead
1 Language Language String -
2 Category Category ID String -
3 ProductDataDownloadUrl All Product Data Download URL String -

Each product specification information acquisition API

Swipe left or right to change screens View in landscape mode.
No. Physical name Logical name Type Ceramic Capacitors Inductors Explanation
SMD Lead
1 HasMoreHits Flag if there are other applicable products Boolean *3
2 Data Product data Object -
3 CeramicCapacitorsSMD,CeramicCapacitorsLead,Inductors Category group Object -
4 Manufacturer Manufacturer String -
5 Lv1Category Product Category
(Level 1)
String -
6 Lv2Category Product Category(Level 2) String -
7 Lv3Category Product Category(Level 3) String -
8 Products List of products List[Object] -
9 Partno Part Number with Package Code String -
10 PartnoWithoutPackageCode Part Number without Package Code String -
11 Status Status String -
12 NewProduct New Product Boolean -
13 LastBuyDate Last Buy Date Date -
14 AlternativePartno Alternative
Part Number
List[String] -
15 PackageType Package Type String -
16 MinOrderQuantity Minimum Order Quantity Integer -
17 Application Application String -
18 ProductDetailUrl Product Detail URL String -
19 SampleRequestUrl Sample Request URL String -
20 MSL MSL String -
21 ProductName Product Name String -
22 Notices Notices String -
23 ProductionEndDate Production End Date String -
24 Benefits Benefits
List[String]
× -
25 Standard Standard String × -
26 Mounting Mounting List[String] × -
27 Caution Caution List[String] × -
28 Series Series Name String × × -
29 Soldering Solder Compatible List[String] × × -
30 MagneticShieldClass Magnetic Shield Class String × × -
31 DcResistanceCenterValues DC Resistance Center Values String × × -
32 FeatureText Feature Text String × × -
33 TargetCircuitCategory Target Circuit Category String × × -
34 Construction Construction List[String] × × -
35 ComplianceInfo Compliance information Object -
36 AecQ200Support AEC-Q200 Support Boolean -
37 Rohs RoHS Boolean -
38 Reach REACH Boolean -
39 LeadFree Lead Free Boolean -
40 SvhcDocumentUrl SVHC Document URL String -
41 Specs Specifications information Object -
42 ReferenceMassText Reference Mass Text String -
43 ReferenceMass Reference Mass(g) Double -
44 LengthText Length Text String -
45 Length Length(m) Double -
46 WidthText Width Text String -
47 Width Width(m) Double -
48 ThicknessText Thickness Text String -
49 Thickness Thickness(m) Double -
50 ThicknessMaxText Thickness(max.) Text String -
51 ThicknessMax Thickness(max.)(m) Double -
52 OuterDiameterText Outer Diameter Text String × × -
53 OuterDiameter Outer Diameter(m) Double × × -
54 LeadSpaceText Lead Space Text String × × -
55 LeadSpace Lead Space (m) Double × × -
56 LeadDiameterText Lead Diameter Text String × × -
57 LeadDiameter Lead Diameter (m) Double × × -
58 SizecodeMm Size Code mm String × -
59 SizecodeInch Size Code Inch String × -
60 SmdType SMD Type String × × -
61 CapacitanceText Capacitance Text String × -
62 Capacitance Capacitance(F) Double × -
63 ToleranceCapacitance Tolerance Capacitance String × -
64 RatedVoltageClass Rated Voltage Class String × -
65 RatedVoltageText Rated Voltage Text String × -
66 RatedVoltage Rated Voltage(V) Double × -
67 TemperatureCharacteristicsCompliedStandard Temperature Characteristics Complied Standard String × -
68 TemperatureCharacteristics Temperature Characteristics String × -
69 MaxOperatingTemperatureText Maximum Operating Temperature Text
String
× -
70 MaxOperatingTemperature Maximum Operating Temperature(℃)
Double × -
71 InductanceText Inductance Text String
× × -
72 Inductance Inductance(H) Double
× × -
73 InductanceTolerance Inductance Tolerance String
× × -
74 RatedCurrentText Rated Current Text String
× -
75 RatedCurrent Rated Current(A) Double
× -
76 RatedCurrentItempText Rated Current(Itemp) Text String
× × -
77 RatedCurrentItemp Rated Current(Itemp)(A) Double
× × -
78 RatedCurrentIsatText Rated Current(Isat) Text String
× × -
79 RatedCurrentIsat Rated Current(Isat)(A) Double
× × -
80 RdcMaxText Rdc(max.) String
× × -
81 RdcMax Rdc(max.)(Ω) Double
× × -
82 SrfMinText SRF(min.) String
× × -
83 SrfMin SRF(min.)(Hz) Double
× × -
84 Dimension Dimension String
× × -
85 OperatingTemperatureRange Operating Temperature Range String
-
86 OperatingTemperatureRangeIncludingSelfRise Operating
Temperature
Range including
Self Rise
String
× × -
87 OperatingTemperatureRangeNotIncludingSelfRise Operating
Temperature
Range not including
Self Rise
String
× × -
88 QMin Q (Minimum) String
× × -
89 QTestFrequencyText Q Test Frequency Text String
× × -
90 QTestFrequency Q Test Frequency(Hz) Double
× × -
91 MediaFileUrls Media file URL information Object -
92 PartNumbering Media File URL (Part Numbering) String -
93 Dimensions Media File URL (Dimensions) String -
94 Appearance Media File URL (Appearance) String -
95 SpecificationsSheet Media File URL (Specifications Sheet) String -
96 RohsDirectiveCertificateUrl Media File URL (RoHS Directive Certificate URL) String -
97 ReachDeclarationDocumentUrl Media File URL (REACH Declaration Document URL) String -
98 ConflictMineralsReportDocumentUrl Media File URL (Conflict Minerals Report Document URL) String -
99 StructuralDrawings Media File URL (Structural Drawings) String × -
100 ReliabilityTestData Media File URL (Reliability Test Data) String × -
101 SafetyCertificates Media File URL (Safety Certificates) String × -

*3 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.