Skip to main content
POST
Returns quick, reliable answers for a variety of questions
Before You Get StartedTo register for usage of our Smart API, please reach out via email at api@you.com.

Authorizations

X-API-Key
string
header
required

A unique API Key required to authorize API access. Ensure it is kept confidential. Get a free API Key at you.com/platform.

Body

application/json
query
string

The main question or statement to be answered. This input directs the scope and context of the response.

chat_id
string<uuid>

A hexadecimal UUID to maintain continuity within the conversation. This can be a randomly generated string that uniquely identifies the session.

instructions
string

Custom commands that allow you to tailor the responses to meet specific requirements or preferences. By providing detailed instructions, you can control the assistant’s tone, style, format, depth of information, and other response characteristics. This enables you to customize responses for different audiences, contexts, or purposes. Instructions up to 2.5K characters are supported by default. For longer instructions—up to 25K characters—custom pricing is available upon request at api@you.com.

Response

200 - application/json

A JSON object containing a dictionary with the answer and a list of search results

answer
string

The main response generated by the API based on the provided query and instructions.

Example:

"A solar eclipse occurs when the Moon passes between the Sun and Earth, casting a shadow on Earth and blocking the Sun's light either partially or completely ..."

search_results
object[]