# Count API **Count API** 允许轻松执行查询并获取该查询的匹配数。 它可以跨一个或多个索引并跨越一个或多个类型执行。 可以使用简单的查询字符串作为参数或使用在请求正文中定义的 **Query DSL** 来提供查询。 这里是一个例子： | `PUT /twitter/tweet/``1``?refresh` `{` `"user"``: ``"kimchy"` `}` `GET /twitter/tweet/_count?q=user:kimchy` `GET /twitter/tweet/_count` `{` `"query"` `: {` `"term"` `: { ``"user"` `: ``"kimchy"` `}` `}` `}` | 注意 在正文中发送的查询必须嵌套在查询键中，与 **Search API** 相同 上面的两个例子都做同样的事情，这是从某个用户的 twitter 索引计数 tweets 的数量。 其结果是： | `{` `"count"` `: ``1``,` `"_shards"` `: {` `"total"` `: ``5``,` `"successful"` `: ``5``,` `"failed"` `: ``0` `}` `}` | 查询是可选的，如果没有提供，它将使用** match_all** 来计算所有的文档。 ### Multi index, Multi type （多索引，多类型） **count API **可以应用于多个索引中的多个类型。 ### Request Parameters （请求参数） 当使用查询参数q执行计数时，传递的查询是使用Lucene查询解析器的查询字符串。 还有其他可以传递的参数： | Name | Description | | --- | --- | | *`df`* | 在查询中未定义字段前缀时使用的默认字段。 | | *`analyzer`* | 分析查询字符串时使用的分析器名称。 | | *`default_operator`* | 要使用的默认运算符，可以是 **AND** 或 **OR**。 默认为 **OR**。 | | *`lenient`* | 如果设置为 **true** 将导致基于格式的失败（例如向数字字段提供文本）被忽略。 默认为 **false**。 | | *`lowercase_expanded_terms`* | 术语是否自动小写，默认为** true **。 | | *`analyze_wildcard`* | 是否分析通配符和前缀查询。 默认为false。 | | *`terminate_after`* | 每个分片的最大计数，到达时，查询执行将提前终止。 如果设置，响应将具有布尔字段**terminated_early** 以指示查询执行是否实际已终止。 默认为无 **terminate_after**。 | ### Request Body （请求主体） 计数可以使用其身体内的 **Query DSL** 来表达应该执行的查询。 主体内容也可以作为名为** source **的 **REST** 参数传递。 **HTTP GET** 和 **HTTP POST** 都可以用于以主体执行计数。 由于并不是所有的客户端都支持带主体的 **GET**，因此也允许 **POST**。 ### Distributed （分布式） 计数操作在所有分片上广播。 每个 **shard id group** 选择一个副本并对其执行。 这意味着副本增加了计数的可伸缩性。 ### Routing （路由） 可以指定路由值（路由值的逗号分隔列表），以控制将对哪些分片执行计数请求。