Base URL

The base URL for all API requests is: https://{your_subdomain}.nousai.com. You can use the subdomain provided to you by Nous AI.

Authentication

This endpoint requires API key authentication. You can use the x-api-key provided to you by Nous AI.

Request

Headers

Body

The request body should be in JSON format with the following parameters:

The only required parameter is query.

You can optionally include the following parameters in the request body:

• mode, which determines the search mode. Valid options are: 'fast' and 'powerful'. If not specified, uses the tenant's configured default search mode.
• business_unit_name, which specifies that the response should only consider sources associated with the business unit specified plus any "shared" sources (i.e., sources with no business unit assignment).
• source_path_pattern, which allows you to filter sources using regex patterns matched against the source path. For webpages, the source path is the URL; for files, it is the file path. Pattern matching is case-insensitive. Note that this parameter does not impact or limit media search results.
• source_date_threshold, which specifies that the response should only consider sources dated on or after the given date. Generally, you won't need to use this parameter, as newer sources are automatically prioritized when recency is important for the search query.
• ai_summary_format, which allows you to customize the ai_summary field in the response by specifying its output format (such as a JSON object or a list, instead of a plain string) and other attributes like the desired length and tone of voice. By default, the ai_summary will be provided in Markdown format. This parameter is particularly useful for obtaining structured output in a custom schema of your preference. Pass a JSON schema describing the desired structure, and the response will conform to that format.

{
    "query": "What's expected to happen with interest rates?"
}

{
    "query": "What is our Q4 strategy?",
    "mode": "powerful",
    "business_unit_name": "North Star Division",
    "source_path_pattern": ".*marketing.*\\.pptx$",
    "source_date_threshold": "2025-07-01",
    "ai_summary_format": "500 words, avoid jargon"
}

{
    "query": "What are our 5 biggest holdings?",
    "ai_summary_format": {
        "introduction": "<string> // 30 words",
        "items": [
            {
                "name": "<string> // Name of the holding",
                "value": "<float> // Value of the holding. 2 decimals."
            }
        ],
        "total": "<float> // Sum of item values. 2 decimals."
    }
}

Response

Success Response

• Code: 200 OK
• Content-Type: application/json

{
    "ai_summary": "Interest rates are expected to...",
    "documents": [
        {
        "source": {
            "title": "Global Markets Outlook",
            "path": "https://www.example.com/global-markets-outlook",
        }
        "date": "2025-21-01",
        "extract": "We believe that interest rates are going to...",
        },
        // more document results...
    ]
    "media": [
        "/media/image.png"
    ]
}

Error Responses

Invalid API Key

• Code: 403 Forbidden
• Content: {"detail": "Invalid API key"}

Missing Required Parameter

• Code: 400 Bad Request
• Content: {"query": "This field is missing"}

Invalid Parameter Value

• Code: 400 Bad Request
• Content: {"detail": "Invalid business unit name."}