Skip to main content
The TinyFish Fetch API renders web pages using a real browser (including JavaScript-heavy sites) and returns clean extracted text in your preferred format. Submit a URL, get back structured content. 
POST https://api.fetch.tinyfish.ai
api.fetch.tinyfish.ai is the public Fetch 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.post(
    "https://api.fetch.tinyfish.ai",
    headers={"X-API-Key": "your_api_key_here"},
    json={"urls": ["https://www.tinyfish.ai/"]},
    timeout=120,
)

data = response.json()
print(data["results"][0]["title"])
print(data["results"][0]["text"])

​
What Success Looks Like

{
  "results": [
    {
      "url": "https://www.tinyfish.ai/",
      "final_url": "https://www.tinyfish.ai/",
      "title": "TinyFish | Enterprise Web Agent Infrastructure",
      "description": "TinyFish provides enterprise infrastructure for AI web agents.",
      "language": "en",
      "text": "# TinyFish | Enterprise Web Agent Infrastructure\n\nTinyFish provides enterprise infrastructure for AI web agents...\n"
    }
  ],
  "errors": []
}

​
When to Use Fetch vs the Other APIs

  • Use Fetch when you already know the URL and need clean extracted page content.
  • Use Search when you need help finding the right URLs first.
  • Use Agent when TinyFish should perform a multi-step workflow on the site.
  • Use Browser when you need direct browser control from your own code.

​
Fetching Multiple URLs

Submit up to 10 URLs in a single request. Each URL is processed independently — one failure doesn’t affect the others. 
response = httpx.post(
    "https://api.fetch.tinyfish.ai",
    headers={"X-API-Key": "your_api_key_here"},
    json={
        "urls": [
            "https://www.tinyfish.ai/",
            "https://en.wikipedia.org/wiki/Web_scraping",
            "https://docs.python.org/3/tutorial/index.html",
        ]
    },
)

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

for error in data["errors"]:
    print("Failed:", error["url"], "–", error["error"])
Per-URL failures (timeouts, DNS errors, anti-bot blocks) appear in errors[] alongside a 200 response — they do not cause the entire request to fail.

​
Output Formats

Control the format of the text field with the format parameter. When omitted, the default is markdown.
Semantic HTML.
{
  "format": "html",
  "text": "<h1>Async Fn in Traits Are Now Available</h1>
<p>Starting with Rust 1.75, you can use <code>async fn</code> directly inside traits.</p>
<h2>What Changed</h2>
<ul>
<li>Works in all stable traits</li>
<li>No heap allocation for simple cases</li>
</ul>"
}

​
Supported Content Types

The Fetch API handles more than just HTML. See the full content types table in the reference — highlights: PDF text extraction works, JSON endpoints return raw JSON, but binary files (images, video) return an error.

​
SDK Quick Start

from tinyfish import TinyFish

client = TinyFish()
result = client.fetch.get_contents(
    urls=["https://www.tinyfish.ai/"],
    format="markdown",
)
for page in result.results:
    print(page.title, "→", page.text[:200])

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