製品情報API バージョン2.2

概要

  • 検索条件を指定し、製品情報を取得するAPIです。
  • APIは2種類あり、用途に応じて使い分ける必要があります。
  • 下記2つのAPIでは、「APIキー認証」を使用しているため、API呼び出し時に、APIキーをリクエストヘッダーに渡す必要があります。
    1. 全品番スペック情報URL取得API
      GET
      https://api.murata.com/v2/products/getproductdatadownloadurl
      全品番のスペック情報が記載されたURLを取得します。
      • 全品番スペック情報URL取得API 呼び出し形式
        https://api.murata.com/v2/products/getproductdatadownloadurl?category=<製品カテゴリID>&lang=<言語識別子>
        • 製品カテゴリIDを指定する必要があります。
        • langを指定しない場合は英語になります。
        • 全製品データダウンロード用URL(全品番のスペック情報が取得できるURL)は有効期限が設けられており、URL発行から7日間アクセスが可能です。
    2. 品番毎スペック情報取得API
      GET
      https://api.murata.com/v2/products
      検索条件に該当する品番の、上から2000件の品番分のスペック情報を取得します。
      • 品番毎スペック情報取得API 呼び出し形式
        https://api.murata.com/v2/products?$filter=<検索条件> and <検索条件>&$orderby=<ソート順>,<ソート順>&lang=<言語識別子>
        • 検索条件は指定しなくても検索可能です。検索条件に指定できる値は、下の表をご参照ください。
        • 検索条件に指定する値は、エンコードする必要があります。
        • langを指定しない場合は英語になります。
        • 検索条件は単一、複数の検索条件を指定できます。複数の検索条件を指定する場合は、<検索条件>を「and」で接続します。検索条件指定方法の詳細については、下の表をご参照ください。
        • $orderbyでソート順を指定する場合は、昇順は「ソート対象の検索条件 asc」、降順は「ソート対象の検索条件 desc」を指定します。複数のソート順指定する場合は、<ソート順>を「,」で接続します。

リクエストパラメーター

全品番スペック情報URL取得API

左右にスワイプ可能です 横持ちでご覧ください
リクエストヘッダー
No. 物理名 論理名 説明
1 x-api-key APIキー API使用時の、APIキー認証に使用する。
左右にスワイプ可能です 横持ちでご覧ください
クエリパラメーター
No. 物理名 論理名 説明
1 category 製品カテゴリID ceramicCapacitorsSMD, ceramicCapacitorsLead, inductorsのいずれかを指定する。
2 lang 言語 ja,zh,enを指定可能。"指定なし"又は"該当なし"はen(英語)と見做す。

品番毎スペック情報取得API

左右にスワイプ可能です 横持ちでご覧ください
リクエストヘッダー
No. 物理名 論理名 説明
1 x-api-key APIキー API使用時の、APIキー認証に使用する。
左右にスワイプ可能です 横持ちでご覧ください
クエリパラメーター
No. 物理名 論理名 説明
1 lang 言語 ja,zh,enを指定可能。"指定なし"又は"該当なし"はen(英語)と見做す。
2 $filter 検索条件 検索条件を指定する。
3 $orderby ソート順 検索結果のソート順を指定する。昇順は asc、降順はdescを指定する。
左右にスワイプ可能です 横持ちでご覧ください
検索条件
No. 物理名 論理名 カテゴリ
指定なし
セラミックコンデンサ インダクタ 説明
SMD、リード SMD リード
1 Category 製品カテゴリ String × ※1
2 Partno 品番 String -
3 Status 製品ステー
タス
String ※2
4 NewProduct 新製品 Boolean -
5 PackageType 包装情報 String -
6 Application 適用用途 String ※3
7 AecQ200Support AEC-Q200
対応
Boolean -
8 Rohs RoHS Boolean -
9 Reach REACH Boolean -
10 ReferenceMass 参考質量(g) Double -
11 Length L寸法(m) Double × × -
12 Width W寸法(m) Double × × -
13 Thickness T寸法(m) Double × -
14 ThicknessMax T寸法(max.)(m) Double × -
15 OuterDiameter 外径寸法D(m) Double × × × × -
16 LeadSpace リード間隔(m) Double × × × × -
17 SizecodeMm サイズコード mm String × × × -
18 SizecodeInch サイズコード inch String × × × -
19 SmdType SMD形状 String × × × × ※2
20 Capacitance 静電容量(F) Double × × -
21 ToleranceCapacitance 静電容量
許容差
String × × -
22 RatedVoltageClass 定格電圧区分 String × × ※2
23 RatedVoltage 定格電圧(V) Double × × -
24 TemperatureCharacteristicsCompliedStandard 温度特性の
準拠規格
String × × × ※2
25 TemperatureCharacteristics 温度特性 String × × × -
26 MaxOperatingTemperature 最高使用温度(℃) Double × × -
27 Benefits メリット String × × ※2
28 Standard 認定規格 String × × ※2
29 Mounting 実装方法 String × × ※2
30 Brand ブランド String × × × × -
31 TargetCircuitCategory 対象回路分類 String × × × × ※2
32 Inductance インダクタンス Double × × × × -
33 InductanceTolerance インダクタンス偏差 String × × × × -
34 RatedCurrentItemp 定格電流(温度上昇に基づく場合) Double × × × × -
35 Rdc 直流抵抗(Ω)(Rdc) Double × × × × -
36 Srf 自己共振周波数(SRF) Double × × × × -
37 Construction 構造 String × × × × ※2

※1 検索条件にカテゴリを指定するには、以下の表に記載のある「カテゴリID」を使用する。

左右にスワイプ可能です 横持ちでご覧ください
No. カテゴリ名称 カテゴリID 説明
中間カテゴリ 最下層カテゴリ
1 セラミックコンデンサ
(SMD、リード)
- ceramicCapacitors このカテゴリを指定した場合、セラミックコンデンサ(SMD)とセラミックコンデンサ(リード)の情報を取得する。
2 セラミックコンデンサ
(SMD)
ceramicCapacitorsSMD -
3 セラミックコンデンサ
(リード)
ceramicCapacitorsLead -
4 インダクタ - inductors -

各検索条件に使用可能な値

※2 以下の表に記載のある値のみ使用可能です。

※3 検索仕様は※2と同様です。ただしレスポンスのデータ形式が異なります。
  ※2の項目の場合、複数の値を返却する際リスト形式で返却し、※3の項目の場合はカンマ(,)区切りで返却します。
  データ形式の詳細については、ページ下部のサンプルJSONを参照ください。

左右にスワイプ可能です 横持ちでご覧ください
No. 物理名 論理名 使用可能な値
英語 日本語 中国語
1 Status 製品ステータス Under Development 開発中 开发中
In Production 生産中 目前生产
NRND NRND NRND
To be discontinued 生産中止予定 计划停产
Discontinued 生産中止 已经停产
2 Standard 認定規格 Certified by safety standard 安全規格認定品 安全规格认证品
Based on the Electrical
Appliance and Material Safety
Law of Japan
電気用品安全法準拠品 符合日本国内电气用品安全法
3 Mounting 実装方法 Reflow soldering リフローはんだ 回流焊接
Flow soldering フローはんだ 波峰焊接
Bonding ボンディング 结合
Welding 溶接 焊接
Fixing with screws ねじ止め 螺丝固定
Conductive adhesive 導電性接着剤 导电性粘合剂
4 RatedVoltageClass 定格電圧区分 AC AC AC
DC DC DC
5 TemperatureCharacteristicsCompliedStandard 温度特性の準拠規格 JIS JIS JIS
EIA EIA EIA
Murata Murata Murata
6 Application 適用用途 Consumer equipment 民生機器 民用设备
Industrial Equipment 産業機器 工业设备
Automotive infotainment/comfort equipment 自動車用インフォテインメント/コンフォート機器 汽车信息娱乐/舒适设备
Automotive powertrain/safety equipment 自動車用パワートレイン/セーフティ機器 汽车动力总成/安全设备
Medical equipment [GHTF Class C]  医療機器-クラスC 医疗设备-C类
Medical equipment [GHTF Class D]  医療機器-クラスD 医疗设备-D类
Medical equipment [GHTF Class A/B] 医療機器-クラス A/B 医疗设备 [GHTF A/B类]
Mobile Electronics モバイル機器 移动设备
Mobile Communication モバイル通信 移动通讯
Consumer Electronics - Differential Transmission 民生機器-差動伝送 民用设备-差分传输
HDD HDD 硬盘
Double feed detection 重送検知 检测重新发送
Automotive [Ask Murata] 自動車用機器 [ムラタへ問合せ要] 汽车设备[需要向村田咨询]
Medical [Ask Murata] 医療機器 [ムラタへ問合せ要] 医疗设备[需要向村田咨询]
7 Brand ブランド Murata Murata Murata
Murata Power Solutions Murata Power Solutions Murata Power Solutions
8 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 ノイズ対策 静噪
9 SmdType SMD形状 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 樹脂モールド 树脂封装
10 TargetCircuitCategory 対象回路分類 Power lines circuits 電源系回路 电源线回路
General circuits 一般回路 一般回路
High frequency circuits 高周波回路 高频回路
11 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电感器

検索条件指定方法

左右にスワイプ可能です 横持ちでご覧ください
検索タイプ 検索条件 検索条件指定例
品番検索、String型
項目に関する検索
前方一致
(単一値)
  • /v2/products?$filter=startswith(Partno,'GRM')
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and startswith(ToleranceCapacitance,'%C2%B110')
前方一致
(複数値)
  • /v2/products?$filter=startswith(Partno,'GRM%7CGCM')
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and startswith(ToleranceCapacitance,'%C2%B110%7C%C2%B120')
中間一致
(単一値)
  • /v2/products?$filter=contains(Partno,'CD72')
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and contains(ToleranceCapacitance,'0.1')
中間一致
(複数値)
  • /v2/products?$filter=contains(Partno,'CD72%7CCD80')
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and contains(ToleranceCapacitance,'0.1%7C0.25')
完全一致
(単一値)
  • /v2/products?$filter=Partno eq 'GRM31CD80G107MEA8L'
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and ToleranceCapacitance eq '%C2%B120%25'
完全一致
(複数値)
  • /v2/products?$filter=Partno eq 'GRM31CD80G107MEA8L%7CGRM31CD80G107MEA8K'
  • /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and ToleranceCapacitance eq '%C2%B120%25%7C%C2%B10.1pF'
Double型項目に
関する検索
以上 /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length ge 0.0032
以下 /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length le 0.0032
イコール /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length eq 0.0032
より大きい /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length gt 0.0032
より小さい /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length lt 0.0032
範囲 /v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Length ge 0.0032 and Length le 0.0045
Boolean型
項目に関する検索
イコール /v2/products?$filter=NewProduct eq true
リスト値項目
(※2の表に記載のある値)に関する検索
完全一致
(単一値)
  • 【日本語】
    /v2/products?$filter=Status eq '生産中'&lang=ja
  • 【中国語】
    /v2/products?$filter=Status eq '目前生产'&lang=zh
  • 【英 語】
    /v2/products?$filter=Status eq 'In Production'&lang=en
    /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and RatedVoltageClass eq 'AC'
完全一致
(複数値)
  • 【日本語】
    /v2/products?$filter=Status eq '生産中%7C開発中'&lang=ja
  • 【中国語】
    /v2/products?$filter=Status eq '目前生产%7C开发中'&lang=zh
  • 【英 語】
    /v2/products?$filter=Status eq 'In Production%7CUnder Development'&lang=en
    /v2/products?$filter=Category eq 'ceramicCapacitorsLead' and RatedVoltageClass eq 'AC%7CDC'

※「%C2%B1」は「±」、「%25」は「%」、「%7C」は「|」をエンコードした文字列です。

レスポンス

全品番スペック情報URL取得API

左右にスワイプ可能です 横持ちでご覧ください
No. 物理名 論理名 セラミックコンデンサ インダクタ 説明
SMD リード
1 Language 言語 String -
2 Category 製品カテゴリID String -
3 ProductDataDownloadUrl 全製品データ
ダウンロード用URL
String -

品番毎スペック情報取得API

左右にスワイプ可能です 横持ちでご覧ください
No. 物理名 論理名 セラミックコンデンサ インダクタ 説明
SMD リード
1 HasMoreHits 他に該当製品があるかどうかフラグ Boolean ※4
2 Data 製品データ Object -
3 CeramicCapacitorsSMD,CeramicCapacitorsLead,Inductors カテゴリグループ Object -
4 Manufacturer 製造者 String -
5 Lv1Category 製品カテゴリ(大分類) String -
6 Lv2Category 製品カテゴリ(中分類) String -
7 Lv3Category 製品カテゴリ(小分類) String -
8 Products 製品のリスト List[Object] -
9 Partno 包装コード付き品番 String -
10 PartnoWithoutPackageCode #付き品番 String -
11 Status 製品ステータス String -
12 NewProduct 新製品 Boolean -
13 LastBuyDate 最終購入日付 Date -
14 AlternativePartno 代替品 List[String] -
15 PackageType 包装情報 String -
16 MinOrderQuantity 最小受注数量 Integer -
17 Application 適用用途 String -
18 RecommendedApplication オススメ用途 String -
19 ProductDetailUrl 製品詳細URL String -
20 SampleRequestUrl サンプルカート追加URL String -
21 MSL MSL String -
22 ProductName 製品名称 String -
23 Notices 特記事項 String -
24 ProductionEndDate 生産中止日 String -
25 Benefits メリット
List[String]
× -
26 Standard 認定規格 String × -
27 Mounting 実装方法 List[String] × -
28 Caution 注意 List[String] × -
29 Brand ブランド String × × -
30 Series シリーズ名 String × × -
31 Soldering はんだ対応 List[String] × × -
32 MagneticShieldClass 磁気シールドの種類 String × × -
33 DcResistanceCenterValues 直流抵抗センター値 String × × -
34 FeatureText 特長テキスト String × × -
35 TargetCircuitCategory 対象回路分類 String × × -
36 Construction 構造 List[String] × × -
37 ComplianceInfo コンプライアンス情報 Object -
38 AecQ200Support AEC-Q200対応 Boolean -
39 Rohs RoHS Boolean -
40 Reach REACH Boolean -
41 LeadFree Lead Free Boolean -
42 SvhcDocumentUrl SVHCドキュメントURL String -
43 Specs スペック情報項目 Object -
44 ReferenceMassText 参考質量 String -
45 ReferenceMass 参考質量(g) Double -
46 LengthText L寸法 String -
47 Length L寸法(m) Double -
48 WidthText W寸法 String -
49 Width W寸法(m) Double -
50 ThicknessText T寸法 String -
51 Thickness T寸法(m) Double -
52 ThicknessMaxText T寸法(max.) String -
53 ThicknessMax T寸法(max.)(m) Double -
54 OuterDiameterText 外径寸法D String × × -
55 OuterDiameter 外径寸法D(m) Double × × -
56 LeadSpaceText リード間隔 String × × -
57 LeadSpace リード間隔(m) Double × × -
58 LeadDiameterText リード線径 String × × -
59 LeadDiameter リード線径(m) Double × × -
60 SizecodeMm サイズコード mm String × -
61 SizecodeInch サイズコード inch String × -
62 SmdType SMD形状 String × × -
63 CapacitanceText 静電容量 String × -
64 Capacitance 静電容量(F) Double × -
65 ToleranceCapacitance 静電容量許容差 String × -
66 RatedVoltageClass 定格電圧区分 String × -
67 RatedVoltageText 定格電圧 String × -
68 RatedVoltage 定格電圧(V) Double × -
69 TemperatureCharacteristicsCompliedStandard 温度特性の準拠規格 String × -
70 TemperatureCharacteristics 温度特性 String × -
71 MaxOperatingTemperatureText 最高使用温度
String
× -
72 MaxOperatingTemperature 最高使用温度(℃)
Double × -
73 InductanceText インダクタンス String
× × -
74 Inductance インダクタンス(H) Double
× × -
75 InductanceTolerance インダクタンス偏差 String
× × -
76 RatedCurrentText 定格電流 String
× -
77 RatedCurrent 定格電流 (A) Double
× -
78 RatedCurrentItempText 定格電流(Itemp) String
× × -
79 RatedCurrentItemp 定格電流(Itemp)(A) Double
× × -
80 RatedCurrentIsatText 定格電流(Isat) String
× × -
81 RatedCurrentIsat 定格電流(Isat)(A) Double
× × -
82 RdcMaxText Rdc(max.) String
× × -
83 RdcMax Rdc(max.)(Ω) Double
× × -
84 SrfMinText SRF(min.) String
× × -
85 SrfMin SRF(min.)(Hz) Double
× × -
86 Dimension 寸法 String
× × -
87 OperatingTemperatureRange 使用温度範囲 String
-
88 OperatingTemperatureRangeIncludingSelfRise 使用温度範囲(自己温度上昇含む) String
× × -
89 OperatingTemperatureRangeNotIncludingSelfRise 使用温度範囲(自己温度上昇含まない) String
× × -
90 QMin Q(以上) String
× × -
91 QTestFrequencyText Q測定周波数 String
× × -
92 QTestFrequency Q測定周波数(Hz) Double
× × -
93 MediaFileUrls メディアファイルURL情報 Object -
94 PartNumbering メディアファイルURL
(品番の読み方)
String -
95 Dimensions メディアファイルURL
(寸法図)
String -
96 Appearance メディアファイルURL
(外観写真)
String -
97 SpecificationsSheet メディアファイルURL
(スペックシート)
String -
98 RohsDirectiveCertificateUrl メディアファイルURL
(RoHS指令適合証明書URL)
String -
99 ReachDeclarationDocumentUrl メディアファイルURL (REACH宣言文書URL) String -
100 ConflictMineralsReportDocumentUrl メディアファイルURL
(紛争鉱物報告文書URL)
String -
101 StructuralDrawings メディアファイルURL
(構造図)
String × -
102 ReliabilityTestData メディアファイルURL
(信頼性試験データ)
String × -
103 SafetyCertificates メディアファイルURL
(安全規格認定書)
String × -

※4「Hasmorehits」について

「品番毎スペック情報取得API」は、検索条件に該当する品番の、上から2000品番分のスペック情報を取得します。
「品番毎スペック情報取得API」のレスポンス項目「HasMoreHits(該当製品があるかどうか)」の返却値の仕様は以下の通りです。

  • 「HasMoreHits=true」の場合:返却された製品以外にも、検索条件に該当する製品が存在する
  • 「HasMoreHits=false」の場合:返却された製品以外には、検索条件に該当する製品は存在しない

「HasMoreHits=true」で、残りの品番を取得したい場合は以下の方法があります

  • 検索条件を追加で指定し、レスポンスの品番数を、「品番毎スペック情報取得API」の取得品番数上限以下の品番数とする。

API 呼び出し例

リクエスト

  • 全品番スペック情報URL取得API
    例1)「カテゴリはceramicCapacitorsSMD」で指定する場合
    • lang=ja(日本語)
      https://api.murata.com/v2/products/getproductdatadownloadurl?category=ceramicCapacitorsSMD&lang=ja
  • 品番毎スペック情報取得API
    例1)検索条件に、「品番はGCM0332C1E100FA01J」を指定する場合
    • https://api.murata.com/v2/products?$filter=Partno eq 'GCM0332C1E100FA01J'
    例2)検索条件に、「'GRM', 'GCM'を含む品番」を指定する場合
    • https://api.murata.com/v2/products?$filter=contains(Partno,'GRM%7CGCM')
    例3)検索条件に、「カテゴリはceramicCapacitorsSMD」で「製品ステータスは開発中」を指定する場合
    • lang指定なし、またはlang=en(英語)
      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(日本語)
      https://api.murata.com/v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Status eq '開発中'&lang=ja
    • lang=zh(中国語)
      https://api.murata.com/v2/products?$filter=Category eq 'ceramicCapacitorsSMD' and Status eq '开发中'&lang=zh

レスポンス

※正常終了した場合

以下のリンクから、レスポンスのサンプル(JSON形式)をダウンロードできます。

  • 全製品データダウンロード用URLのレスポンス(本来なら全製品のデータが取得できますが、サンプルのため1品番のみとなっています)
  • 品番毎スペック情報取得API(セラミックコンデンサ(SMD)、セラミックコンデンサ(リード)、インダクタの1品番ずつを指定した場合)

※エラーが発生した場合

いくつかの一般的なエラーレスポンスとその考えられる原因です。

HTTP ステータス 考えられる原因
400 Bad Request クエリパラメーターに問題があります。
403 Forbidden 指定されたAPIキー、もしくはAPIメソッドまたはリソースに問題があります。
404 Not Found 取得対象の情報が存在しません。
429 Too Many Requests リクエスト回数の上限を超えたため、ブロックされました。
500 Internal Server Error サーバー側で問題が発生しました。