Search the open web
tinyfish.web.searchSearch the web by keyword or meaning, with domain, language, location, and date filters.
- Price
- freeAt provider cost
- Success rate
- 87.8%Last 30 days · 747,613 calls
- Latency p50
- 1.7 sp95 4.7 s
- Last verified
- Sep 23, 2026Verified working
GEThttps://toolswitch.dev/v1/tools/tinyfish.web.search?query=TinyFish+API+documentation&domain_type=webPreviewTry onlineComing soonProvider docs ↗
- Uses platform quota
- Synchronous response
- Reads public data
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Query parameters | ||||
page | integer | Optional | ||
fetch | object | Optional | JSON object in the query string; {} attaches each result's fetched page content. A boolean is rejected (400 INVALID_INPUT). | {} |
query | string | Required | TinyFish API documentation | |
purpose | string | Optional | Describe what the results will be used for. | |
language | string | Optional | en | |
location | string | Optional | United States | |
after_date | string | Optional | YYYY-MM-DD; only results after this date. | 2024-01-01 |
before_date | string | Optional | YYYY-MM-DD; only results before this date. | 2024-12-31 |
domain_type | string | Required | web | |
exclude_domains | array[string] | Optional | ||
include_domains | array[string] | Optional | ||
recency_minutes | integer | Optional | ||
include_thumbnail | boolean | Optional | ||
- Query parameters
pageintegerOptionalfetchobjectOptionalJSON object in the query string; {} attaches each result's fetched page content. A boolean is rejected (400 INVALID_INPUT).
Example:
{}querystringRequiredExample:
TinyFish API documentationpurposestringOptionalDescribe what the results will be used for.
languagestringOptionalExample:
enlocationstringOptionalExample:
United Statesafter_datestringOptionalYYYY-MM-DD; only results after this date.
Example:
2024-01-01before_datestringOptionalYYYY-MM-DD; only results before this date.
Example:
2024-12-31domain_typestringRequiredExample:
webexclude_domainsarray[string]Optionalinclude_domainsarray[string]Optionalrecency_minutesintegerOptionalinclude_thumbnailbooleanOptional
Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
Preview
curl -X GET 'https://toolswitch.dev/v1/tools/tinyfish.web.search?query=TinyFish+API+documentation&domain_type=web' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/tinyfish.web.search?query=TinyFish+API+documentation&domain_type=web",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/tinyfish.web.search?query=TinyFish+API+documentation&domain_type=web", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at free, including the service fee.