Skip to main content
GET
Search the web
curl --request GET \
  --url https://api.search.tinyfish.ai/ \
  --header 'X-API-Key: <api-key>'
{
  "query": "web automation tools",
  "results": [
    {
      "position": 1,
      "site_name": "example.com",
      "snippet": "Top web automation tools for 2026...",
      "title": "Best Web Automation Tools",
      "url": "https://example.com/web-automation-tools"
    }
  ],
  "total_results": 10
}

Documentation Index

Fetch the complete documentation index at: https://docs.tinyfish.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

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

Query Parameters

​
query
string
required

Search query

Required string length: 1 - 2000
Example:

"web automation tools"

​
location
string

Country code for geo-targeted results

Example:

"US"

​
language
string

Language code for result language

Example:

"en"

​
page
integer | null

Page number for pagination, starting from 0 (max 10)

Required range: 0 <= x <= 10
Example:

2

​
include_thumbnail
enum<string>

When "true", each result includes a thumbnail_url when available. Defaults to false.

Available options:
true,
false
Example:

"true"

​
fetch
string

JSON-encoded fetch configuration object.

Maximum string length: 256
Example:

"{}"

Response

Search completed successfully.

Search response with results

​
query
string
required

The search query that was executed

Example:

"web automation tools"

​
results
object[]
required

Array of search results

​
total_results
integer
required

Total number of results

Example:

10

​
page
integer
required

The current page number, starting from 0

Example:

0