葫芦AI智能平台 API 文档

为开发者提供强大的电子元器件数据API服务，支持25,000,000+元器件数据查询

OAuth2 认证 REST API 实时数据

产品详细参数

查询元器件详细规格

获取元器件的完整技术参数、规格书、图片等详细信息

库存价格

获取实时价格信息

查询全球供应商的实时库存数量和价格信息

实时库存搜索

多渠道并发搜索

支持流式响应的多渠道实时库存搜索服务

产品详细参数查询

查询元器件的完整技术参数、规格书、图片等详细信息

POST

请求地址

POST https://api.huluic.cn/api/partdetail

请求参数

参数名	类型	必填	说明
body	string	是	JSON格式的请求体，包含关键字 onepartno
token	string	是	认证令牌，用于验证请求的合法性

Python 代码示例

import json
import requests

access_token = "Your Access token"
url = "https://api.huluic.cn/api/partdetail"
headers = {
    "Authorization": f"Bearer {access_token}"
}
form_body = {
    "body": json.dumps({"onepartno": "STM32F103C8T6"})
}
response = requests.post(url, headers=headers, data=form_body)

if response.status_code == 200:
    result = response.json()
    print(result)
else:
    print(f"Error: {response.status_code}")

响应示例

{
    "onepartno": "STM32F103C8T6",
    "code": 200,
    "msg": "Success",
    "results": {
        "category": ["Microcontrollers", "ARM Cortex-M3"],
        "description": [
            "32-bit ARM Cortex-M3 microcontroller",
            "72MHz maximum frequency"
        ],
        "img": [
            {"STM32F103C8T6 Package": "https://example.com/image1.jpg"},
            "https://example.com/image2.jpg"
        ],
        "keyword": "STM32F103C8T6",
        "manufacturer": "STMicroelectronics",
        "onepartno": "STM32F103C8T6",
        "partno": "STM32F103C8T6",
        "pdf": [
            "https://example.com/datasheet.pdf",
            {"Datasheet": "https://example.com/datasheet2.pdf"}
        ],
        "sn": 101409,
        "specs": [
            {"Package": "LQFP48"},
            {"Operating Temperature": "-40 to 85 °C"},
            {"Flash Memory": "64KB"},
            {"RAM": "20KB"}
        ],
        "mrf": "stmicroelectronics",
        "catecode": ["MCU001", "ARM003"],
        "mrflogo": "https://example.com/st_logo.png"
    }
}

库存价格查询

获取全球供应商的实时库存数量和价格信息

POST

请求地址

POST https://api.huluic.cn/api/v2/offerGet

⚠️ 此API需要OAuth2认证和IP白名单

请求参数

参数名	类型	必填	说明
appname	string	是	应用名称
q	string	是	查询关键词（至少3个字符）
currency	string	否	目标货币：CNY/USD/EUR/GBP/JPY/HKD/CAD/KRW/SGD，默认CNY
vat	integer	否	是否含税：1、0，默认1
lang	string	否	语言：zh-cn、en-us，默认zh-cn

Python 代码示例

import json
import requests

access_token = "Your Access token"
url = "https://api.huluic.cn/api/v2/offerGet"
headers = {
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/x-www-form-urlencoded"
}
form_body = {
    "body": json.dumps({
        "appname": "your_app_name",
        "q": "STM32F103C8T6",
        "currency": "USD",
        "vat": 1,
        "lang": "en-us"
    })
}
response = requests.post(url, headers=headers, data=form_body)

if response.status_code == 200:
    result = response.json()
    print(result)
else:
    print(f"Error: {response.status_code}")

实时库存搜索

支持多渠道并发搜索和流式响应的实时库存搜索服务

POST

请求地址

POST https://api.huluic.cn/api/stock_search

💡 支持流式响应，实时返回搜索结果

请求参数

参数名	类型	必填	说明
partno	string	是	要搜索的零件型号
channels	array	否	指定搜索渠道列表，如：["digikey", "mouser", "element14"]
quantity	integer	否	需求数量
lang	string	否	语言设置：zh/en，默认zh
userid	string	否	用户ID
conversation_id	string	否	会话ID

Python 代码示例

import json
import requests

access_token = "Your Access token"
url = "https://api.huluic.cn/api/stock_search"
headers = {
    "Authorization": f"Bearer {access_token}",
    "Content-Type": "application/x-www-form-urlencoded"
}
form_body = {
    "body": json.dumps({
        "partno": "STM32F103C8T6",
        "channels": ["digikey", "mouser", "element14"],
        "quantity": 100,
        "lang": "zh"
    })
}

# 流式响应处理
response = requests.post(url, headers=headers, data=form_body, stream=True)

for line in response.iter_lines():
    if line:
        data = line.decode('utf-8')
        print(data)
        # 解析JSON数据
        try:
            json_data = json.loads(data)
            event_type = json_data.get('event')
            if event_type == 'final_data':
                print("搜索完成")
                break
        except json.JSONDecodeError:
            continue

响应格式说明

• 流式响应：每行为一个JSON对象
• event字段：表示消息类型（message/final_data/spider_results等）
• data字段：包含具体的响应数据

认证说明

OAuth2 认证

所有API都需要有效的访问令牌进行认证。

Authorization: Bearer YOUR_ACCESS_TOKEN

获取访问令牌

请联系我们获取API访问权限和令牌。

📧 邮箱：contact@huluic.com