Skip to main content
POST
Fetch and extract content from URLs
curl --request POST \
  --url https://api.fetch.tinyfish.ai/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "urls": [
    "https://example.com",
    "https://example.org"
  ],
  "format": "markdown",
  "links": false,
  "image_links": false
}
'
{
  "results": [
    {
      "url": "https://example.com",
      "final_url": "https://www.example.com",
      "title": "Example Domain",
      "description": "This domain is for use in illustrative examples.",
      "language": "en",
      "format": "markdown",
      "text": "<string>",
      "author": "John Doe",
      "published_date": "2024-01-15",
      "links": [
        "<string>"
      ],
      "image_links": [
        "<string>"
      ],
      "latency_ms": 1183.4
    }
  ],
  "errors": [
    {
      "url": "https://invalid.example.com",
      "error": "Failed to fetch resource"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get your key from the API Keys page.

Body

application/json

URLs to fetch and extraction options

​
urls
string<uri>[]
required

Array of URLs to fetch (1-10). All URLs are fetched in parallel. Each URL is processed independently — if one fails, others still return successfully. Errors are reported per-URL in the errors array.

Required array length: 1 - 10 elements
Example:
[
  "https://example.com",
  "https://example.org"
]
​
format
enum<string>
default:markdown

Output format for extracted content. "markdown" (default) is ideal for LLM consumption. "html" returns cleaned semantic HTML. "json" returns a structured document tree.

Available options:
markdown,
html,
json
Example:

"markdown"

​
links
boolean
default:false

Extract all outbound links () from each page. Useful for discovering related pages or navigating to specific content. Links are returned as absolute URLs in the links array of each result.

Example:

false

​
image_links
boolean
default:false

Extract all image URLs () from each page. Useful for finding visual content or media assets. Image links are returned as absolute URLs in the image_links array of each result.

Example:

false

Response

Fetch completed. Check errors[] for any per-URL failures.

Fetch response with results and errors

​
results
object[]
required

Successfully fetched URLs

​
errors
object[]
required

URLs that failed to fetch