Search

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

Search looks up the public web and returns ranked results, a sourced answer, or structured output. Use it when you need links and context before you Fetch a page. The REST endpoint is POST /search. See the request parameters below.

Quick start

curl -X POST https://api.notte.cc/search \
  -H "Authorization: Bearer $NOTTE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q": "notte browser automation", "depth": "standard", "outputType": "searchResults"}'

search.py

import os

import requests

response = requests.post(
    "https://api.notte.cc/search",
    headers={"Authorization": f"Bearer {os.environ['NOTTE_API_KEY']}"},
    json={
        "q": "notte browser automation",
        "depth": "standard",
        "outputType": "searchResults",
    },
)
response.raise_for_status()
print(response.json())

Parameters

string

required

The search query.

string

default:"standard"

How thorough the search is: standard, fast, or deep.

string

default:"searchResults"

What to return:

searchResults: ranked URLs with name and content snippets
sourcedAnswer: a written answer plus source URLs
structured: structured output when you also pass a schema

Extra fields are forwarded (for example maxResults or includeDomains).

Response shapes

searchResults includes a results array. Each item has url, name, and content. sourcedAnswer includes answer (string) and sources (list of supporting URLs).

Getting Started

Sessions

Authentication

Functions

Web API

Guides

Quick start

Parameters

Response shapes

​Quick start

​Parameters

​Response shapes

Quick start

Parameters

Response shapes