Skip to main content
GET
/
v1
/
search
Search the web
curl --request GET \
  --url https://api.search.tinyfish.ai/v1/search \
  --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
}

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

Minimum string length: 1
Example:

"web automation tools"

​
location
string

Country code for geo-targeted results

Example:

"US"

​
language
string

Language code for result language

Example:

"en"

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