opensearch-docs-cn/_api-reference/count.md

layout	title	nav_order	redirect_from
default	Count	21	/opensearch/rest-api/count/

Count

Introduced 1.0 {: .label .label-purple }

The count API gives you quick access to the number of documents that match a query. You can also use it to check the document count of an index, data stream, or cluster.

Example

To see the number of documents that match a query:

GET opensearch_dashboards_sample_data_logs/_count
{
  "query": {
    "term": {
      "response": "200"
    }
  }
}

{% include copy-curl.html %}

The following call to the search API produces equivalent results:

GET opensearch_dashboards_sample_data_logs/_search
{
  "query": {
    "term": {
      "response": "200"
    }
  },
  "size": 0,
  "track_total_hits": true
}

{% include copy-curl.html %}

To see the number of documents in an index:

GET opensearch_dashboards_sample_data_logs/_count

{% include copy-curl.html %}

To check for the number of documents in a data stream, replace the index name with the data stream name.

To see the number of documents in your cluster:

GET _count

{% include copy-curl.html %}

Alternatively, you could use the cat indexes and cat count APIs to see the number of documents per index or data stream. {: .note }

Path and HTTP methods

GET <target>/_count/<id>
POST <target>/_count/<id>

URL parameters

All count parameters are optional.

Parameter	Type	Description
allow_no_indices	Boolean	If false, the request returns an error if any wildcard expression or index alias targets any closed or missing indexes. Default is false.
analyzer	String	The analyzer to use in the query string.
analyze_wildcard	Boolean	Specifies whether to analyze wildcard and prefix queries. Default is false.
default_operator	String	Indicates whether the default operator for a string query should be AND or OR. Default is OR.
df	String	The default field in case a field prefix is not provided in the query string.
expand_wildcards	String	Specifies the type of index that wildcard expressions can match. Supports comma-separated values. Valid values are all (match any index), open (match open, non-hidden indexes), closed (match closed, non-hidden indexes), hidden (match hidden indexes), and none (deny wildcard expressions). Default is open.
ignore_unavailable	Boolean	Specifies whether to include missing or closed indexes in the response. Default is false.
lenient	Boolean	Specifies whether OpenSearch should accept requests if queries have format errors (for example, querying a text field for an integer). Default is false.
min_score	Float	Include only documents with a minimum _score value in the result.
routing	String	Value used to route the operation to a specific shard.
preference	String	Specifies which shard or node OpenSearch should perform the count operation on.
terminate_after	Integer	The maximum number of documents OpenSearch should process before terminating the request.

Response

{
  "count" : 14074,
  "_shards" : {
    "total" : 1,
    "successful" : 1,
    "skipped" : 0,
    "failed" : 0
  }
}