# Semantic Search API

**URL:** https://discuss.elastic.co/t/semantic-search-api/328113
**Category:** Elasticsearch
**Created:** [March 20, 2023, 9:36pm UTC](https://discuss.elastic.co/t/semantic-search-api/328113 "2023-03-20T21:36:17Z")
**Posts on this page:** 9
**Page:** 1

<div class="post-metadata">

### Author: ![rpmansion](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/rpmansion/32/118689_2.png) [@rpmansion](https://discuss.elastic.co/u/rpmansion)
#### Post date: [March 20, 2023, 9:36pm UTC](https://discuss.elastic.co/t/semantic-search-api/328113/1 "2023-03-20T21:36:17Z")

</div>

There is a semantic search API endpoint (/index\_name/\_semantic-search) that was released in the documentation, what is the reason this was removed?

---

<div class="post-metadata">

### Author: ![warkolm](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/warkolm/32/39224_2.png) [@warkolm](https://discuss.elastic.co/u/warkolm)
#### Post date: [March 20, 2023, 11:56pm UTC](https://discuss.elastic.co/t/semantic-search-api/328113/2 "2023-03-20T23:56:13Z")

</div>

I can't see that in the documentation sorry, but do you mean [k-nearest neighbor (kNN) search | Elasticsearch Guide [8.6] | Elastic](https://www.elastic.co/guide/en/elasticsearch/reference/8.6/knn-search.html)?

---

<div class="post-metadata">

### Author: ![rpmansion](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/rpmansion/32/118689_2.png) [@rpmansion](https://discuss.elastic.co/u/rpmansion)
#### Post date: [March 21, 2023, 12:31am UTC](https://discuss.elastic.co/t/semantic-search-api/328113/3 "2023-03-21T00:31:07Z")

</div>

Well, it was removed. There is an endpoint something like \_semantic-search that you can do in an index.

---

<div class="post-metadata">

### Author: ![warkolm](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/warkolm/32/39224_2.png) [@warkolm](https://discuss.elastic.co/u/warkolm)
#### Post date: [March 21, 2023, 12:38am UTC](https://discuss.elastic.co/t/semantic-search-api/328113/4 "2023-03-21T00:38:10Z")

</div>

What version did you see it in?

---

<div class="post-metadata">

### Author: ![rpmansion](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/rpmansion/32/118689_2.png) [@rpmansion](https://discuss.elastic.co/u/rpmansion)
#### Post date: [March 21, 2023, 3:47am UTC](https://discuss.elastic.co/t/semantic-search-api/328113/5 "2023-03-21T03:47:43Z")

</div>

If I'm not mistaken v8.5

---

<div class="post-metadata">

### Author: ![warkolm](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/warkolm/32/39224_2.png) [@warkolm](https://discuss.elastic.co/u/warkolm)
#### Post date: [March 21, 2023, 4:05am UTC](https://discuss.elastic.co/t/semantic-search-api/328113/6 "2023-03-21T04:05:28Z")

</div>

I can't find a reference to this in GitHub about it. Unless you can find something concrete then not sure we can help sorry.

---

<div class="post-metadata">

### Author: ![droberts195](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/droberts195/32/17692_2.png) [@droberts195](https://discuss.elastic.co/u/droberts195)
#### Post date: [March 21, 2023, 9:50am UTC](https://discuss.elastic.co/t/semantic-search-api/328113/7 "2023-03-21T09:50:43Z")

</div>

The `_semantic_search` endpoint existed in code for a while but was never released.

You would have seen it mentioned in docs with the yellow banner at the top saying, "You are looking at preliminary documentation for a future release. Not what you want? See the [current release documentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html)."

We decided that instead of having a separate `_semantic_search` endpoint we'd be better off integrating the functionality into the standard `_search` endpoint. This was done in [https://github.com/elastic/elasticsearch/pull/93531](https://github.com/elastic/elasticsearch/pull/93531). The docs for it were added in [[DOCS] Adds semantic search section to kNN search page by szabosteve · Pull Request #93782 · elastic/elasticsearch · GitHub](https://github.com/elastic/elasticsearch/pull/93782). So you can read the docs for the upcoming `text_embedding` query type already in [k-nearest neighbor (kNN) search | Elasticsearch Guide [master] | Elastic](https://www.elastic.co/guide/en/elasticsearch/reference/master/knn-search.html#semantic-search). However, once again you'll see the yellow banner at the top of this page, and you must be aware that unreleased functionality will not necessarily ever be released.

---

<div class="post-metadata">

### Author: ![warkolm](https://sea2.discourse-cdn.com/elastic/user_avatar/discuss.elastic.co/warkolm/32/39224_2.png) [@warkolm](https://discuss.elastic.co/u/warkolm)
#### Post date: [March 21, 2023, 8:52pm UTC](https://discuss.elastic.co/t/semantic-search-api/328113/8 "2023-03-21T20:52:25Z")

</div>

Thanks for clarifying!

---

<div class="post-metadata">

### Author: ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)
#### Post date: [April 18, 2023, 8:53pm UTC](https://discuss.elastic.co/t/semantic-search-api/328113/9 "2023-04-18T20:53:22Z")

</div>

This topic was automatically closed 28 days after the last reply. New replies are no longer allowed.
