味探中国 · 数据 API

搜索去重后的逻辑产品；默认只查国内地标，食材知识与国际地标需显式选择。

• scope=domestic 是网页与 API 的默认产品域
• 旧 /api/v1/search 保持 Ingredient 查询契约，不会被替换
• format=llm 或 markdown 返回适合 Agent 的纯文本

参数

响应示例

{
  "query": "祁门红茶",
  "scope": "domestic",
  "total": 1,
  "domainCounts": {
    "domestic": 9994,
    "ingredient": 102,
    "international": 102
  },
  "results": [
    {
      "key": "SINOGI…",
      "name": "祁门红茶",
      "domain": "domestic",
      "kind": "basic",
      "href": "/geo-product/qi-men-hong-cha",
      "verificationTier": "registry_verified",
      "matchReasons": [
        "名称完全匹配"
      ]
    }
  ]
}

分页浏览逻辑产品；默认国内地标，并与网页地图和产品目录使用同一口径。

参数

响应示例

{
  "items": [
    {
      "key": "AGI…",
      "name": "五常大米",
      "domain": "domestic",
      "href": "/ingredient/wu-chang-da-mi"
    }
  ],
  "total": 9994,
  "page": 1,
  "pageSize": 48,
  "totalPages": 209
}

按月份浏览国内逻辑产品，合并登记上市月份与强时令日历证据。

参数

响应示例

{
  "items": [
    {
      "key": "SINOGI…",
      "name": "产品名",
      "seasonality": {
        "source": "calendar",
        "score": 72
      }
    }
  ],
  "total": 120,
  "page": 1,
  "pageSize": 16
}

兼容版食材搜索（Ingredient 维度）。json 支持分页；llm / markdown 固定最多 100 条。

• format=llm 适合 AI agent 直接消费（text/plain）
• format=markdown 返回 Markdown（text/markdown）

参数

响应示例 · format=json，limit=1

{
  "query": "大米",
  "count": 1,
  "total": 101,
  "offset": 0,
  "limit": 1,
  "results": [
    {
      "id": "cmr9bgv4x028qqhtuoephof3p",
      "name": "阿城大米",
      "category": "grain",
      "description": "阿城大米，黑龙江省哈尔滨市阿城区特产，全国农产品地理标志。…",
      "aliases": [
        "精米"
      ],
      "verificationTier": "registry_verified",
      "kind": "deep",
      "dimCount": 7,
      "depthLabel": "完整数据(7维)",
      "productions": [
        {
          "id": "prod_1",
          "region": "黑龙江省",
          "characteristics": "…",
          "certified": false
        }
      ],
      "cookingMethods": [
        "炒",
        "炖",
        "煮",
        "凉拌",
        "炸"
      ],
      "sources": [],
      "confidence": 0.7
    }
  ]
}

搜索自动补全：基于去重逻辑产品，默认国内地标。

参数

响应示例

{
  "suggestions": [
    {
      "id": "ing_1",
      "name": "五常大米",
      "type": "ingredient",
      "domain": "domestic",
      "province": "黑龙江省",
      "category": "粮食",
      "href": "/ingredient/ing_1"
    }
  ]
}

按收获月份与品类时令日历，分页浏览当季公开特产（强时令果蔬优先）。

参数

响应示例

{
  "items": [],
  "total": 0,
  "page": 1,
  "pageSize": 20,
  "totalPages": 0
}

数据透明度概览：总量、信任分层、公开品类/省份分布、字段填充率与近期同步摘要。

参数

响应示例

{
  "total": 3600,
  "publicTotal": 3500,
  "tiers": [
    {
      "tier": "verified",
      "count": 120
    }
  ],
  "categories": [],
  "provinces": [],
  "completeness": {
    "total": 3500,
    "fields": []
  },
  "recentLogs": []
}

分页浏览食材，支持品类与省/市筛选。

参数

响应示例 · pageSize=1

{
  "items": [
    {
      "id": "cmr9bgv4x028qqhtuoephof3p",
      "name": "平潭坛紫菜",
      "category": "aquatic_plant",
      "categoryLabel": "aquatic_plant",
      "categoryZh": "水生植物",
      "confidence": 0.7,
      "regions": [
        "福建省"
      ],
      "verificationTier": "registry_verified",
      "dimCount": 4,
      "dimensions": {
        "flavorProfile": false,
        "selectionTips": true,
        "classicRecipes": false,
        "pairings": false,
        "nutrition": true,
        "healthEfficacy": true,
        "cautions": true
      }
    }
  ],
  "total": 3612,
  "page": 1,
  "pageSize": 1
}

食材详情：营养、产地、烹饪、登记信息、关联地标产品等。仅返回公开可见食材。

参数

响应示例 · 顶层字段示意，嵌套已截断

{
  "id": "cmr9bgv4x028qqhtuoephof3p",
  "name": "平潭坛紫菜",
  "aliases": [],
  "category": "aquatic_plant",
  "categoryZh": "水生植物",
  "description": "坛紫菜（学名：Porphyra haitanensis）中国特有的一种暖温带性海藻…",
  "verificationTier": "registry_verified",
  "kind": "full",
  "dimCount": 7,
  "depthLabel": "完整数据(7维)",
  "confidence": 0.7,
  "dataSource": "wikipedia",
  "registry": {
    "type": "AGI",
    "externalRef": "AGI02908",
    "province": "福建省",
    "registerYear": 2020,
    "holderName": "平潭综合实验区农业农村发展服务中心"
  },
  "nutrition": {
    "source": "china_food_composition",
    "matchedName": "紫菜头",
    "values": {
      "protein": 1.8,
      "fat": 0.2,
      "CHO": 10.6,
      "energyKCal": 42
    }
  },
  "productions": [
    {
      "region": "福建省",
      "regionLevel": "province"
    }
  ],
  "geoProducts": [
    {
      "id": "cmrayanog06ddx9e1y7era9m9",
      "name": "平潭坛紫菜",
      "gi": "GI"
    }
  ],
  "sources": [],
  "related": []
}

地理标志产品详情：产地范围、品质特征、三轨登记号、技术规范全文等。

参数

响应示例 · 长文本字段已截断

{
  "id": "cmrayanog06ddx9e1y7era9m9",
  "name": "平潭坛紫菜",
  "code": "SINOGI08377",
  "gi": "GI",
  "giLabel": "地理标志",
  "listCategory": "水产品",
  "listSubCategory": "紫菜",
  "province": "福建",
  "city": "福州市",
  "addr": "平潭区现辖行政区域内",
  "attr": "藻体暗紫绿略带褐色，披针形、亚卵形或长卵形…",
  "abs": "平潭坛紫菜藻体细长、色泽鲜亮…",
  "registry": {
    "trademark": "35496391",
    "product": "2025年第640号公告",
    "agricultural": "AGI02908"
  },
  "qualityReqTitle": null,
  "qualityReqText": null,
  "relatedDocs": [
    {
      "nid": 22542,
      "text": "一、地理标志产品名称…"
    }
  ],
  "announcement": {
    "no": "第677号",
    "date": "2026-05-20",
    "url": "https://www.cnipa.gov.cn/…",
    "pdfUrl": "https://www.cnipa.gov.cn/module/download/…"
  }
}

国内逻辑产品地理聚合；ingredientCount 字段名为 v1 兼容保留。

参数

响应示例

{
  "provinces": [
    {
      "name": "山东省",
      "ingredientCount": 351
    },
    {
      "name": "四川省",
      "ingredientCount": 201
    }
  ],
  "unmappedIngredientCount": 0
}