Query your Collection

The query endpoint allows you to retrieve information from a collection (your resources) via the WetroCloud API.
This endpoint supports two response formats to suit different use cases:

• Free Text Response: A natural language answer to your query.
• Structured Output Response: A structured JSON output.

Each response type has unique request and response formats, which are explained in detail on their respective pages.

​

Free Text Response

Free text response provides natural, conversational-style answers to your queries. It is ideal for general Q&A and scenarios where a narrative or contextualized explanation is needed. Unlike structured output, free text does not require additional parameters like json_schema and json_schema_rules.

​

Request Example

from wetro import Wetrocloud

# Initialize the Wetrocloud client
client = Wetrocloud(api_key="your_api_key")

# Query the collection
response = client.collection.query_collection(
    collection_id="my_unique_collection_id",
    request_query="What are the sales trends for Q1?"
)

print(query_response)

​

Request Example with Stream

from wetro import Wetrocloud

# Initialize the Wetrocloud client
client = Wetrocloud(api_key="your_api_key")

# Query the collection with streaming
streaming_response = client.collection.query_collection(
    collection_id="my_unique_collection_id",
    request_query="What are the sales trends for Q1?",
    stream=True
)

# Process streaming response
for chunk in streaming_response:
    print(chunk.response, end="")

​

Response Example: Free Text

{
  "response": "The sales for Q1 increased by 20% compared to last year, with online channels contributing significantly.",
  "tokens": 120,
  "success": true
}