Chunk Group
Search Within Group
Chunk
- POSTCreate or Upsert Chunk or Chunks
- POSTSearch
- POSTAutocomplete
- POSTGet Recommended Chunks
- POSTScroll Chunks
- POSTCount chunks above threshold
- POSTGenerate suggested queries
- POSTRAG on Specified Chunks
- PUTUpdate Chunk
- PUTUpdate Chunk By Tracking Id
- GETGet Chunk By Id
- GETGet Chunk By Tracking Id
- POSTGet Chunks By Tracking Ids
- POSTGet Chunks By Ids
- DELDelete Chunk
- DELDelete Chunk By Tracking Id
- DELBulk Delete Chunks
- POSTSplit HTML Content into Chunks
Chunk Group
- POSTCreate or Upsert Group or Groups
- POSTSearch Over Groups
- POSTSearch Within Group
- POSTGet Recommended Groups
- POSTAdd Chunk to Group
- POSTAdd Chunk to Group by Tracking ID
- POSTGet Groups for Chunks
- GETGet Chunks in Group by Tracking ID
- GETGet Group by Tracking ID
- PUTUpdate Group
- DELRemove Chunk from Group
- DELDelete Group by Tracking ID
- DELDelete Group
- GETGet Group
- GETGet Chunks in Group
- GETGet Groups for Dataset
Message
Crawl
File
Analytics
Dataset
- POSTCreate Dataset
- POSTBatch Create Datasets
- POSTGet All Tags
- POSTGet events for the dataset
- PUTUpdate Dataset by ID or Tracking ID
- PUTClear Dataset
- GETGet Dataset By ID
- GETGet Dataset by Tracking ID
- GETGet Datasets from Organization
- POSTCreate ETL Job
- PUTCreate Pagefind Index for Dataset
- GETGet Pagefind Index Url for Dataset
- GETGet Usage By Dataset ID
- GETGet dataset crawl options
- GETGet apipublic page
- DELDelete Dataset
- DELDelete Dataset by Tracking ID
Organization
Health
Stripe
Metrics
Chunk Group
Search Within Group
This route allows you to search only within a group. This is useful for when you only want search results to contain chunks which are members of a specific group. If choosing hybrid search, the results will be re-ranked using scores from a cross encoder model.
POST
/
api
/
chunk_group
/
search
curl --request POST \
--url https://api.trieve.ai/api/chunk_group/search \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--header 'TR-Dataset: <tr-dataset>' \
--data '{
"content_only": true,
"filters": {
"must": [
{
"field": "tag_set",
"match_all": [
"A",
"B"
]
},
{
"field": "num_value",
"range": {
"gte": 10,
"lte": 25
}
}
]
},
"get_total_pages": true,
"group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"group_tracking_id": "<string>",
"highlight_options": {
"highlight_delimiters": [
"<string>"
],
"highlight_max_length": 1,
"highlight_max_num": 1,
"highlight_results": true,
"highlight_strategy": "exactmatch",
"highlight_threshold": 123,
"highlight_window": 1,
"post_tag": "<string>",
"pre_tag": "<string>"
},
"metadata": "<any>",
"page": 1,
"page_size": 1,
"query": {
"image_url": "<string>",
"llm_prompt": "<string>"
},
"remove_stop_words": true,
"score_threshold": 123,
"search_type": "fulltext",
"slim_chunks": true,
"sort_options": {
"location_bias": {
"bias": 123,
"location": {
"lat": 123,
"lon": 123
}
},
"mmr": {
"mmr_lambda": 123,
"use_mmr": true
},
"recency_bias": 123,
"sort_by": {
"direction": "desc",
"field": "<string>",
"prefetch_amount": 1
},
"tag_weights": {},
"use_weights": true
},
"typo_options": {
"correct_typos": true,
"disable_on_word": [
"<string>"
],
"one_typo_word_range": {
"max": 1,
"min": 1
},
"prioritize_domain_specifc_words": true,
"two_typo_word_range": {
"max": 1,
"min": 1
}
},
"use_quote_negated_terms": true,
"user_id": "<string>"
}'
{
"chunks": [
{
"chunk": {
"chunk_html": "<p>Some HTML content</p>",
"content": "Some content",
"id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"link": "https://example.com",
"metadata": {
"key1": "value1",
"key2": "value2"
},
"time_stamp": "2021-01-01 00:00:00.000",
"weight": 0.5
},
"highlights": [
"highlight is two tokens: high, light",
"whereas hello is only one token: hello"
],
"score": 0.5
}
],
"corrected_query": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"total_pages": 123
}
Authorizations
Headers
The dataset id or tracking_id to use for the request. We assume you intend to use an id if the value is a valid uuid.
The API version to use for this request. Defaults to V2 for orgs created after July 12, 2024 and V1 otherwise.
Available options:
V1
, V2
Body
application/json
JSON request payload to semantically search a group
The body is of type object
.
Response
200
application/json
Group chunks which are similar to the embedding vector of the search query
The response is of type object
.
The response is of type object
.
The response is of type object
.
Was this page helpful?
curl --request POST \
--url https://api.trieve.ai/api/chunk_group/search \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--header 'TR-Dataset: <tr-dataset>' \
--data '{
"content_only": true,
"filters": {
"must": [
{
"field": "tag_set",
"match_all": [
"A",
"B"
]
},
{
"field": "num_value",
"range": {
"gte": 10,
"lte": 25
}
}
]
},
"get_total_pages": true,
"group_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"group_tracking_id": "<string>",
"highlight_options": {
"highlight_delimiters": [
"<string>"
],
"highlight_max_length": 1,
"highlight_max_num": 1,
"highlight_results": true,
"highlight_strategy": "exactmatch",
"highlight_threshold": 123,
"highlight_window": 1,
"post_tag": "<string>",
"pre_tag": "<string>"
},
"metadata": "<any>",
"page": 1,
"page_size": 1,
"query": {
"image_url": "<string>",
"llm_prompt": "<string>"
},
"remove_stop_words": true,
"score_threshold": 123,
"search_type": "fulltext",
"slim_chunks": true,
"sort_options": {
"location_bias": {
"bias": 123,
"location": {
"lat": 123,
"lon": 123
}
},
"mmr": {
"mmr_lambda": 123,
"use_mmr": true
},
"recency_bias": 123,
"sort_by": {
"direction": "desc",
"field": "<string>",
"prefetch_amount": 1
},
"tag_weights": {},
"use_weights": true
},
"typo_options": {
"correct_typos": true,
"disable_on_word": [
"<string>"
],
"one_typo_word_range": {
"max": 1,
"min": 1
},
"prioritize_domain_specifc_words": true,
"two_typo_word_range": {
"max": 1,
"min": 1
}
},
"use_quote_negated_terms": true,
"user_id": "<string>"
}'
{
"chunks": [
{
"chunk": {
"chunk_html": "<p>Some HTML content</p>",
"content": "Some content",
"id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"link": "https://example.com",
"metadata": {
"key1": "value1",
"key2": "value2"
},
"time_stamp": "2021-01-01 00:00:00.000",
"weight": 0.5
},
"highlights": [
"highlight is two tokens: high, light",
"whereas hello is only one token: hello"
],
"score": 0.5
}
],
"corrected_query": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"total_pages": 123
}