# Explore graph analytics


**POST /{index}/_graph/explore**

**All methods and paths for this operation:**

<div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/{index}/_graph/explore</span>
                      </div>
                    <div>
                      <span class="operation-verb post">POST</span>
                      <span class="operation-path">/{index}/_graph/explore</span>
                      </div>
                    

Extract and summarize information about the documents and terms in an Elasticsearch data stream or index.
The easiest way to understand the behavior of this API is to use the Graph UI to explore connections.
An initial request to the `_explore` API contains a seed query that identifies the documents of interest and specifies the fields that define the vertices and connections you want to include in the graph.
Subsequent requests enable you to spider out from one more vertices of interest.
You can exclude vertices that have already been returned.

[External documentation](https://www.elastic.co/docs/explore-analyze/visualize/graph)

## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **index** (string | array[string])
  Name of the index.

### Query parameters
- **routing** (string)
  Custom value used to route operations to a specific shard.
- **timeout** (string)
  Specifies the period of time to wait for a response from each shard.
  If no response is received before the timeout expires, the request fails and returns an error.
  Defaults to no timeout.

### Body: application/json (object)

- **connections** (object)
  Specifies or more fields from which you want to extract terms that are associated with the specified vertices.
- **controls** (object)
  Direct the Graph API how to build the graph.
- **query** (object)
  A seed query that identifies the documents of interest. Can be any valid Elasticsearch query.
- **vertices** (array[object])
  Specifies one or more fields that contain the terms you want to include in the graph as vertices.


## Responses
### 200


#### Body: application/json (object)
- **connections** (array[object])

- **failures** (array[object])

- **timed_out** (boolean)

- **took** (number)

- **vertices** (array[object])



[Powered by Bump.sh](https://bump.sh)