Skip to main content
Search the web and get structured results:
from tinyfish import TinyFish

client = TinyFish()
response = client.search.query(query="web automation tools", location="US")

for r in response.results:
    print(f"{r.position}. {r.title}")
    print(f"   {r.url}\n")
Output:
{
  "query": "web automation tools",
  "results": [
    {
      "position": 1,
      "site_name": "www.firecrawl.dev",
      "title": "Top 9 Browser Automation Tools for Web Testing and Scraping in ...",
      "snippet": "This guide covers 9 of the best tools across testing, scraping, and workflow automation...",
      "url": "https://www.firecrawl.dev/blog/browser-automation-tools-comparison"
    },
    {
      "position": 2,
      "site_name": "www.skyvern.com",
      "title": "Best Free Open Source Browser Automation Tools in 2025 - Skyvern",
      "snippet": "Developed by Microsoft, Playwright is the next generation of web automation tools...",
      "url": "https://www.skyvern.com/blog/best-free-open-source-browser-automation-tools-in-2025/"
    }
  ],
  "total_results": 10
}
Get results localized to a specific country and language:
from tinyfish import TinyFish

client = TinyFish()

# Search in French — location auto-resolves to FR
response = client.search.query(query="meilleurs restaurants", language="fr")

for r in response.results:
    print(f"{r.position}. {r.title} ({r.site_name})")
When only language is provided, location auto-resolves to the most common pairing (e.g. frFR, jaJP). See the Reference for details.

Search + Fetch Pipeline

Combine Search with Fetch to get full page content from top results:
from tinyfish import TinyFish

client = TinyFish()

# Step 1: Search
results = client.search.query(query="TinyFish web agent", location="US")
top_urls = [r.url for r in results.results[:3]]

# Step 2: Fetch full content
pages = client.fetch.get_contents(urls=top_urls, format="markdown")
for page in pages.results:
    print(f"## {page.title}")
    print(page.text[:200], "\n")

Search Reference

Full parameter and response docs

Fetch Examples

Extract page content from URLs