Skip to main content
The TinyFish Search API lets you run web searches and get back structured results — titles, snippets, and URLs — ready for LLM consumption or programmatic use. 
GET https://api.search.tinyfish.ai
api.search.tinyfish.ai is the public Search API endpoint.

​
Before You Start

1

Get your API key

Visit agent.tinyfish.ai/api-keys and create a key. Store it in your environment:
export TINYFISH_API_KEY="your_api_key_here"
All requests require the X-API-Key header. See Authentication for the full setup and troubleshooting guide.

​
Your First Request

import httpx

response = httpx.get(
    "https://api.search.tinyfish.ai",
    headers={"X-API-Key": "your_api_key_here"},
    params={"query": "web automation tools"},
)

data = response.json()
for result in data["results"]:
    print(result["title"], "→", result["url"])

​
What Success Looks Like

{
  "query": "web automation tools",
  "results": [
    {
      "position": 1,
      "site_name": "tinyfish.ai",
      "title": "TinyFish — AI Web Automation Platform",
      "snippet": "Automate any website with natural language instructions...",
      "url": "https://tinyfish.ai"
    },
    {
      "position": 2,
      "site_name": "github.com",
      "title": "Top Web Automation Tools in 2026",
      "snippet": "A curated list of browser automation frameworks...",
      "url": "https://github.com/example/web-automation-tools"
    }
  ],
  "total_results": 10
}

​
When to Use Search vs the Other APIs

  • Use Search when you need ranked search engine results, snippets, and URLs.
  • Use Fetch when you already have the URLs and want extracted page content.
  • Use Agent when you want TinyFish to browse and execute a workflow on the site.
  • Use Browser when you need direct browser control from your own code.

​
Geo-Targeted Results

Use the location and language parameters to get results tailored to a specific region. 
response = httpx.get(
    "https://api.search.tinyfish.ai",
    headers={"X-API-Key": "your_api_key_here"},
    params={
        "query": "best restaurants",
        "location": "FR",
        "language": "fr",
    },
)

API Reference

Full request and response schema

Authentication

API key setup

For coding agents

One page that routes an agent to the right TinyFish API