如何用Python结合Elasticsearch Query DSL查询芝加哥艺术学院API多条件数据？

要实现你需要的多条件联合查询，核心是正确构建Elasticsearch Query DSL，并通过GET请求的参数正确传递。以下是具体实现步骤：

1. 构建正确的Query DSL结构 #

需要用bool查询的must子句将三个条件组合成逻辑与的关系，确保所有条件同时满足：

• 精确匹配classification_title为painting：用term查询（适合精确值匹配场景）
• colorfulness小于等于13：用range查询的lte参数实现范围限制
• 匹配material_titles包含paper (fiber product)：如果该字段是数组类型，term查询会自动匹配数组中包含该值的文档

DSL示例：

{
  "query": {
    "bool": {
      "must": [
        {"term": {"classification_title": "painting"}},
        {"range": {"colorfulness": {"lte": 13}}},
        {"term": {"material_titles": "paper (fiber product)"}}
      ]
    }
  }
}

2. 通过requests.get正确传递DSL #

GET请求不能直接传递JSON字典，需要将DSL转为JSON字符串，通过source参数传递，同时指定source_content_type为application/json来告诉API正确解析参数。

Python代码示例：

import requests
import json

# 替换为芝加哥艺术学院API的实际搜索端点URL
api_endpoint = "https://api.artic.edu/api/v1/artworks/search"

# 构建查询DSL
query_dsl = {
    "query": {
        "bool": {
            "must": [
                {"term": {"classification_title": "painting"}},
                {"range": {"colorfulness": {"lte": 13}}},
                {"term": {"material_titles": "paper (fiber product)"}}
            ]
        }
    }
}

# 构造GET请求参数
request_params = {
    "source": json.dumps(query_dsl),
    "source_content_type": "application/json"
}

# 发送请求并解析结果
response = requests.get(api_endpoint, params=request_params)
if response.status_code == 200:
    results = response.json()
    # 此处添加结果处理逻辑
else:
    print(f"请求失败: {response.status_code}")

常见问题排查 #

如果之前多条件查询失败，大概率是以下原因：

• 未将DSL转为JSON字符串，直接传递字典导致参数解析错误
• 使用match查询处理精确匹配字段（如classification_title），导致模糊匹配不符合预期
• 误用bool的should子句（逻辑或）而非must（逻辑与），导致条件变为“满足任意一个即可”
• 若material_titles是文本类型而非关键字/数组类型，可将term替换为match查询

内容的提问来源于stack exchange，提问作者Danny