v1

latestOpenAPI 3.0.0Apache 2.02026-07-17263751.6 KB
Search

search.content

Search documents on GroundX for the most relevant information to a given query.

The result of this query is typically used in one of two ways; result['search']['text'] can be used to provide context to a language model, facilitating RAG, or result['search']['results'] can be used to observe chunks of text which are relevant to the query, facilitating citation.

Interact with the "Request Body" below to explore the arguments of this function. Enter your GroundX API key to send a request directly from this web page. Select your language of choice to structure a code snippet based on your specified arguments.

post/v1/search/{id}

Path parameters

integer required
OR
string uuid required

The bucketId, groupId, projectId, or documentId to be searched. The document or documents within the specified container will be compared to the query, and relevant information will be extracted.

Query parameters

ninteger

The maximum number of returned search results. Accepts 1-100 with a default of 20.

nextTokenstring
Example:eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9

A token for pagination. If the number of search results for a given query is larger than n, the response will include a "nextToken" value. That token can be included in this field to retrieve the next batch of n search results.

verbosityinteger

The amount of data returned with each search result. 0 == no search results, only the recommended context. 1 == search results but no searchData. 2 == search results and searchData.

Request body

querystring required

The search query to be used to find relevant documentation.

relevancenumber float

The minimum search relevance score required to include the result. By default, this is 10.0.

Example request

{
  "query": "my search query",
  "relevance": 10
}

Response

Search query success