# TinyFish Search & Fetch

Gateway provider `tinyfish` · call `https://fetchapi.co/api/gw/tinyfish/<path>` with header `x-api-key` (get a key at https://fetchapi.co/keys) · MCP: tools `search_endpoints`, `get_endpoint`, `call_endpoint` at https://fetchapi.co/api/mcp · listing: https://docs.tinyfish.ai/

2 working endpoints, each tested live through this gateway. Endpoints that returned no data in our latest test, write actions and endpoints that need the end user's own login are not listed.

## `tinyfish.fetch` — Read web pages as clean Markdown, up to 10 a call (TinyFish Fetch, free daily allowance)

`POST /fetch` · ✓ working (tested 2026-10-22) · sampled 2026-10-19, 1575 ms

Each URL's main content as Markdown (or HTML / JSON), with title, final URL, author, published date and optionally links. Free within 1,000 URLs a day. Read kalshi.com (a JavaScript app) where DeepSeek Fetch failed.

| param | required | example / default |
|---|---|---|
| `urls` | yes |  |
| `format` | no | markdown |
| `links` | no | False |

```bash
curl -X POST "https://fetchapi.co/api/gw/tinyfish/fetch" \
  -H "x-api-key: $FETCHAPI_KEY" -H "content-type: application/json" \
  -d '{"urls": ["https://en.wikipedia.org/wiki/Prediction_market"], "format": "markdown"}'
```

Real answer (trimmed):

```json
{
 "errors": [],
 "results": [
  {
   "url": "https://en.wikipedia.org/wiki/Prediction_market",
   "text": "From Wikipedia, the free encyclopedia\n\nPlatforms for betting on events\n\n\n\n|  |  |\n| --- | --- |\n|  | This article **needs more citations**. Please help improve this article by adding citations to reliable sources. Unsourced material may be challenged and removed. *Find sources:* \"Prediction market\" – news **·** newspapers **·** books **·** scholar **·** JSTOR *(June 2026)* *(Learn how and when to remove this message)* |\n\n**Prediction markets**, also known as **betting markets**, **information markets**, **decision markets**, **idea futures**, or **event derivatives**, are open markets that enable the prediction of specific outcomes using financial incentives. They are exchange-traded markets established for trading bets in the outcome of various events.[1]\nThe most common form of a predict…",
   "title": "Prediction market - Wikipedia",
   "author": "Contributors to Wikimedia projects",
   "format": "markdown",
   "language": "en",
   "final_url": "https://en.wikipedia.org/wiki/Prediction_market",
   "latency_ms": 996.9484489993192,
   "description": null,
   "published_date": "2003-08-12T03:28:20Z"
  }
 ]
}
```

## `tinyfish.search` — Search the web: ranked results with title, URL, snippet (TinyFish, free daily allowance)

`GET /search` · ✓ working (tested 2026-10-22) · sampled 2026-10-19, 1251 ms

Ranked web results (position, title, URL, snippet, date for news) about 10 a page, pages 0-10. Supports site:, domain include/exclude, date ranges and news / research-paper modes. Free within 12,000 searches a day (resets 00:00 UTC). Tested 2026-10-19: the same top results as Google for a topic query, and the brand's homepage first for a company query.

| param | required | example / default |
|---|---|---|
| `query` | yes | prediction market regulation news |
| `location` | no | US |
| `language` | no |  |
| `include_domains` | no |  |
| `exclude_domains` | no |  |
| `after_date` | no |  |
| `before_date` | no |  |
| `recency_minutes` | no |  |
| `domain_type` | no |  |
| `page` | no | 0 |

```bash
curl "https://fetchapi.co/api/gw/tinyfish/search?query=prediction market regulation news" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
{
 "page": 0,
 "query": "prediction market regulation news",
 "results": [
  {
   "url": "https://thehill.com/regulation/court-battles/6072306-prediction-markets-supreme-court-regulation/",
   "date": "Sep 7, 2026",
   "title": "Prediction markets' regulation draws closer to Supreme Court",
   "snippet": "New Jersey this past week urged the justices to settle how prediction markets should be regulated, and a split among the nation's appeals courts ...",
   "position": 1,
   "site_name": "thehill.com"
  },
  {
   "url": "https://www.cnbc.com/2026/08/14/prediction-markets-scrutiny-mounts-from-regulators-and-banks.html",
   "date": "Aug 14, 2026",
   "title": "Regulators and banks step up scrutiny of prediction markets",
   "snippet": "The CFTC is reviewing prediction betting platforms' so-called mention markets, people familiar with the matter confirmed to CNBC.",
   "position": 2,
   "site_name": "www.cnbc.com"
  },
  {
   "url": "https://www.cbsnews.com/news/prediction-markets-kalshi-polymarket-cftc-kentucky-lawsuit/",
   "date": "Jun 24, 2026",
   "title": "Some states want to regulate prediction markets. Should ...",
   "snippet": "The Commodity Futures Trading Commission has sued nine states to block them from regulating prediction markets such as Kalshi and ...",
   "position": 3,
   "site_name": "www.cbsnews.com"
  }
 ],
 "total_results": 10
}
```