> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stophy.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> What changed in the Stophy API, SDKs, CLI and MCP server, newest first: new endpoints and parsers, option changes, prices, limits and removals.

Each entry covers one week and is named for the Monday it starts. The linked pages describe current behavior. Endpoint names from before November 5, 2026, such as `google.search`, belong to the per-site API that API v1 replaced.

**Week of November 16, 2026**

Lower prices, costUsd on webhooks, a tool for each product on MCP, and GitHub search and Google Scholar removed

**New**

* Job webhooks (crawl, batch, agent and extract) and `monitor.check.completed` now carry `costUsd`, the exact dollars charged. `creditsUsed` and `actualCredits` stay as older fields, rounded up to whole \$0.002 steps. See [Webhooks](https://docs.stophy.dev/webhooks.md) and [Monitor webhooks](https://docs.stophy.dev/monitors/webhooks.md).

**Changed**

* **Lower prices, from November 18.** The list prices dropped. Per 1,000 unless noted, before and after:

  * A page read in scrape, crawl, batch scrape, search page text and monitor checks, and most parser calls: $2 to $1.
  * Map: $2 to $0.50.
  * Search, for each 10 results from each source: $0.004 to $0.001.
  * `json` with a schema or a prompt, `summary`, `highlights`, `question`, `product`, `menu`, `changeTracking` in `json` mode and each agent step: $8 to $3 more.
  * Crawl preview: $8 to $3.
  * `checkPromptInjection`: $8 to $2.50 more.
  * Extract: $10 to $5 for most pages, so one page costs $0.005 instead of $0.01.
  * Parse and PDF text from a text layer: $2 to $0.50. Text read from a picture: $2 to $2.50.
  * Parsers that charge for each 10 results (reviews, apps, listings, videos): $0.002 to $0.001. Reddit comments, for each 200: $0.002 to $0.001.
  * Monitors: `json` comparison $8 to $3 more, a judged change $2 to $1 more.
  * These did not change: browser sessions and tasks, session traffic at \$5 per GB, Instagram and TikTok audio transcripts, `zeroDataRetention`, and `zillow-search`.

  See [Pricing](https://docs.stophy.dev/account/pricing.md).
* The MCP server lists a tool for each product. Without an API key it lists `stophy_search`, `stophy_scrape`, `stophy_map`, `stophy_parse` and `stophy_signup`. With one it adds tools for crawl, extract, agent, browsers, developer and paper search, and monitors, such as `stophy_crawl_status` and `stophy_monitor_create`. `?toolsets=` adds tools for more endpoints of a source. See [Install MCP](https://docs.stophy.dev/install-mcp#what-your-agent-sees).

**Removed**

* The MCP tools `stophy_search_endpoints`, `stophy_describe_endpoint` and `stophy_call` are gone. Use the tool for the product, or `stophy_scrape` with a parser in `formats` for a site's data.
* GitHub search is gone. `GET` and `POST /v1/search/research/github` answer `410`. Search READMEs, issues, pull requests and releases with [developer search](https://docs.stophy.dev/search/developer.md).
* The `google-scholar` parser is gone. Read papers with `categories: ["research"]` on [search](https://docs.stophy.dev/search/papers.md), or `POST /v1/search/research/papers`.

**Improved**

* A scrape with `maxAge` whose page has no stored copy reads the page at once. Before, it waited several seconds first. A `minAge` call with no stored copy answers `notFound` at once. See [Freshness and caching](https://docs.stophy.dev/scrape/freshness-and-caching.md).

**Fixed**

* With an API key, pages on some government, bank and payment sites that failed with `sourceUnavailable` now read.

**Week of November 9, 2026**

Dollar billing, browser sessions and new limits

**New**

* **Billing is in dollars.** On November 15, balances, usage, history and logs switched to dollars. Every response carries `costUsd` and an `x-cost-usd` header, `GET /v1/usage` returns `balanceUsd`, and a top-up adds exactly the dollars paid. Prices did not change. `creditsUsed` stays and counts the same cost in steps of \$0.002. See [Pricing](https://docs.stophy.dev/account/pricing.md).
* Save allow and block rules by domain with `POST /v1/browser/network-policies`, then open a session with `networkPolicyId`. A change to the policy reaches running sessions within seconds. See [Network policies](https://docs.stophy.dev/browser/network-policies.md).
* Upload a Chrome extension with `POST /v1/browser/extensions` and load up to 3 in a session with `extensionIds`. See [Extensions](https://docs.stophy.dev/browser/extensions.md).
* Send `recording: true` to record a session as an MP4, then read it with `GET /v1/browser/{session_id}/recording`. Videos are kept 7 days. See [Recordings and replay](https://docs.stophy.dev/browser/recordings-and-replay.md).
* Change how an open session reaches the web, with its tabs and logins kept, using `PATCH /v1/browser/{session_id}/proxy`. Traffic costs $5 per GB by default and $0.20 per GB with `proxy: "direct"`. See [Network location](https://docs.stophy.dev/browser/network-location.md).
* Put a file in a session with `POST /v1/browser/{session_id}/uploads`, and list what a session downloaded with `GET /v1/browser/{session_id}/downloads`. See [Files](https://docs.stophy.dev/browser/files.md).
* Sessions take `screen`, `metadata`, `location`, `captureConsole` and `solveCaptchas`, and `ttl` goes up to 6 hours. Free accounts keep 3 sessions open, paid accounts 10. See [Browser sessions](https://docs.stophy.dev/browser/overview).
* The MCP server opens, drives and closes a browser session with `browserOpen`, `browserRun` and `browserClose`. See [Install MCP](https://docs.stophy.dev/install-mcp).
* Scrape takes `query` to return the passages of a long page that match it, and `offset` with `nextOffset` to read on past `maxChars`. See [Content filtering](https://docs.stophy.dev/scrape/content-filtering.md).
* Search takes `sbd:1` in `tbs` to sort newest first, and `imagesize:WIDTHxHEIGHT` in `query` to keep images of one size. See [Search filters](https://docs.stophy.dev/search/filters.md).
* Free calls list your crawls and batches, page their results, delete a finished batch's results, and read webhook deliveries with their attempts and a retry. See [Webhooks](https://docs.stophy.dev/webhooks.md).

**Changed**

* New accounts start with $2, down from $10. Sign-in is with Google or GitHub only. Existing balances stay.
* Each endpoint has its own limit: 100 calls a minute until your first top-up, then 600. Job starts, calls at once, waiting jobs and open sessions have limits by tier too, and `GET /v1/limits` shows yours. See [Rate limits](https://docs.stophy.dev/production/rate-limits.md).
* An answer from a stored copy costs the same as a live read, and a stored copy older than `maxAge` is never returned, even when the site fails. See [Freshness and caching](https://docs.stophy.dev/scrape/freshness-and-caching.md).
* A scrape keeps trying for 60 seconds by default, and `timeout` takes 1 second to 5 minutes. See [Timeouts](https://docs.stophy.dev/production/timeouts.md).
* A web result's `description` is the result's search snippet. Send `highlights: true` to get the passages that best match your query instead. See [Search page content](https://docs.stophy.dev/search/page-content.md).

**Fixed**

* A call whose caller hangs up before the answer is refunded.
* A browser task runs only the whole minutes its `maxCost` buys.
* A crawl keeps reading until it reaches its `limit`. A large crawl could end early and report `completed`.
* A refused browser session sends `Retry-After`.
* A URL with a username or password is refused with `invalidRequest`.

**Removed**

* The `qdr:h` past-hour value in `tbs` is refused. The smallest window is `qdr:d`.
* The `companies` and `people` search categories, `/v1/search/companies`, `/v1/search/people` and the `company` parser are gone.
* `/v1/search/gov` is gone.

**Week of November 2, 2026**

API v1

**New**

* **API v1.** On November 5, Stophy became `scrape`, `search`, `map`, `crawl`, `batch/scrape`, `extract` and `parse`, with `agent`, `monitor` and `browser` beside them. Every answer is `{ success, data }` with a `requestId`, and every error is flat. See the [Introduction](https://docs.stophy.dev/introduction.md).
* **Parsers.** Each site is a parser. Send its page address to scrape with `{ "type": "json", "parser": "reddit-search" }`, and `GET /v1/parsers` lists about 100 with their input and an example answer. See [Pre-built parsers](https://docs.stophy.dev/scrape/prebuilt-parsers).
* Scrape formats: `summary`, `question`, `product`, `menu`, `branding`, `rawBase64`, `audio` and `video` for YouTube links, `json` with a `schema`, a `prompt` or CSS `rules`, and `attributes`. See [Scrape](https://docs.stophy.dev/scrape/overview).
* Scrape options: `actions` up to 50 steps, `profile`, `lockdown`, `checkPromptInjection`, `redactPII`, `onlyCleanContent` and `zeroDataRetention`. `GET /v1/scrape/{id}` reads a scrape again for 24 hours, and `POST /v1/scrape/{id}/interact` keeps working on the page. See [Browser actions](https://docs.stophy.dev/scrape/browser-actions.md) and [Interact](https://docs.stophy.dev/scrape/interact.md).
* `POST /v1/crawl` and `POST /v1/batch/scrape` return any scrape format, report failed pages at `/errors`, and take a `webhook`. A batch takes `appendToId` to add pages while it runs, and `GET /v1/crawl/active` lists running crawls. A job over your running limit waits in line. See [Crawl](https://docs.stophy.dev/crawl/overview) and [Batches](https://docs.stophy.dev/batches/overview).
* `POST /v1/extract` fills the fields you name from up to 25 pages, each checked against the page, for \$10 per 1,000 pages. A call that finds none of them is free. `POST /v1/agent` searches, reads pages and fills your fields with a source for each. See [Extract](https://docs.stophy.dev/extract/overview) and [Agent](https://docs.stophy.dev/agent/overview).
* `POST /v1/monitor` watches pages on a schedule and reports what changed. Webhooks are signed with `Stophy-Signature`, and `POST /v1/webhook/secret` reads or replaces the secret. See [Monitors](https://docs.stophy.dev/monitors/overview).
* `POST /v1/parse` turns a PDF, Word, Excel, PowerPoint or HTML file, or a picture of text, into Markdown. Scanned PDF pages are read, `POST /v1/parse/upload-url` takes large files, and `GET /v1/parse/formats` lists the types. See [Parse documents](https://docs.stophy.dev/parse/overview).
* Search takes `categories` of `research`, `pdf` and `videos`, and has `POST /v1/search/research/papers` and `POST /v1/search/developer`. It also had company, people and government search, which were removed on November 14. See [Search](https://docs.stophy.dev/search/overview).
* Browser sessions: `POST /v1/browser` opens one for \$0.06 per hour, `POST /v1/browser/{session_id}/execute` runs code or a prompt in it, and profiles keep logins. `POST /v1/browser/task` clicks through a public site toward a goal. See [Browser sessions](https://docs.stophy.dev/browser/overview) and [Browser tasks](https://docs.stophy.dev/browser/tasks.md).
* An agent signs up with `POST /v1/signup`, a person approves, and `POST /v1/signup/poll` returns the key once. See [API keys](https://docs.stophy.dev/account/api-keys.md).
* `GET /v1/limits` shows your tier, balance, rate limit and key expiry. `GET /v1/status` shows which sources passed their last checks. `POST /v1/feedback` rates a call, and a bad rating refunds what it cost, up to a daily cap.
* A repeated `POST` with the same `Idempotency-Key` returns the first answer for 24 hours.
* Search, scrape, map and parse work without an API key, up to 10 calls a minute and 50 calls a day per IP address. See [Rate limits](https://docs.stophy.dev/production/rate-limits.md).

**Changed**

* On November 5, new accounts start with $10 of free credit, up from $5.

**Improved**

* Every error says what to do next. Errors carry `error`, `code`, `retryable` and `requestId`. A wrong method is `405 methodNotAllowed`, and a key that does not work is `401 unauthorized`. See [Errors](https://docs.stophy.dev/api-reference/errors.md).

**Removed**

* The per-site endpoints, such as `/v1/google/search` and `/v1/youtube/transcript`, are replaced by parsers, and the old paths answer `404`. The AI search, keyword suggestion and AI answer endpoints are removed.
* Scrape takes one `url`. A call with `urls`, added on October 27, is refused and names `POST /v1/batch/scrape`.

**SDKs, CLI, MCP and skills**

* The TypeScript and Python SDKs, both `stophy` 1.3.0, call API v1. The site methods are gone. Read a site with `parsed(parser, url, options)`. See [SDKs](https://docs.stophy.dev/sdks).
* The CLI, `@stophy/cli` 1.3.0 and 1.4.0, works with API v1. In an agent or a pipe it prints one line of JSON, and without an API key it starts a signup for a person to approve. See [Install the CLI](https://docs.stophy.dev/install-cli.md).
* The hosted MCP server, `@stophy/mcp` 1.3.1, has `stophy_search`, `stophy_scrape`, `stophy_map`, `stophy_crawl`, `stophy_extract` and `stophy_signup`. A site's data comes from `stophy_scrape` with a parser in `formats`.
* The agent skills call API v1, one skill per task. See [Install skills](https://docs.stophy.dev/install-skill.md).

**Week of October 26, 2026**

More sites, multi-page scrape and search filters

**New**

* Craigslist search and listings, Luma events, Realtor.com search and properties, and Expedia hotels. Today they are the `craigslist-search`, `craigslist-listing`, `luma-events`, `luma-event`, `realtor-search`, `realtor-property` and `expedia-hotels` [parsers](https://docs.stophy.dev/scrape/prebuilt-parsers).
* `web.scrape` takes `urls`, 2 to 10 pages in one call, and returns `results` in the order you sent. API v1 replaced this with `POST /v1/batch/scrape`.
* `web.search` ranks fresher, cleaner results first and filters by language and date. Today those are `lang` and `tbs` on [search](https://docs.stophy.dev/search/filters.md).
* Google Flights takes a currency and returns the link to its search page. See the [`google-flights` parser](https://docs.stophy.dev/scrape/prebuilt-parsers/places-and-travel/google-flights).
* A scrape says when it left out network calls or cropped a screenshot, in `networkDropped` and `screenshotCropped`. See [Network](https://docs.stophy.dev/scrape/network.md).

**Improved**

* Search with `includeDomains` returns the on-site results, also with `safe`.

**Fixed**

* Reddit search, posts and user pages read again after a change on the site.
* A page that never finishes loading, or that is only a loading notice, costs nothing.

**Week of October 19, 2026**

Scrape formats and cleaner content

**New**

* The `highlights` format returns the passages of a page that best match a `query`, each with its section heading. See [Highlights](https://docs.stophy.dev/scrape/highlights.md).
* The `changeTracking` format says what changed since your key last read a page. See [Change tracking](https://docs.stophy.dev/scrape/change-tracking.md).
* The `network` format returns the JSON a page loaded while it rendered. See [Network](https://docs.stophy.dev/scrape/network.md).
* `linkStyle` writes links `inline`, `numbered` or `none`. See [Content filtering](https://docs.stophy.dev/scrape/content-filtering.md).
* A `screenshot` comes back as a link instead of image data. See [Screenshot](https://docs.stophy.dev/scrape/screenshot.md).
* A crawl with a `prompt` follows link text, not only addresses. See [Crawl scope](https://docs.stophy.dev/crawl/scope.md).

**Improved**

* Main content leaves out blocks that are mostly links and blocks a site repeats on every page.
* A page that only says it needs JavaScript now comes back with its content.
* `web.map` returns its pages in the same order on every call.

**Fixed**

* A call that fails halfway gives its charge back, and a refunded or disputed top-up takes its balance back.
* A field of the wrong type fails the call with `invalidRequest` instead of going `null`.

**Week of October 12, 2026**

Scrape, map, crawl and batch go live

**New**

* Scrape, map, parse, crawl and batch are live. Today they are [`POST /v1/scrape`](https://docs.stophy.dev/scrape/overview), `/v1/map`, `/v1/parse`, `/v1/crawl` and `/v1/batch/scrape`.
* Web, news and image search work without an API key, within the free limit. See [Rate limits](https://docs.stophy.dev/production/rate-limits.md).
* X profile posts, newest first or X's popular set. Today that is the `x-profile` parser.
* Amazon reviews, newest first, by star rating and verified purchases only. Today that is the `amazon-reviews` parser.
* `web.contacts` reads a site's emails, phone numbers and social links. Today the `emails` and `phone-numbers` parsers read emails and phone numbers.

**Changed**

* Pinterest pins no longer carry counts that Pinterest stopped sending.

**Removed**

* `google.jobs` and `google.aiMode` on October 13, and `google.shopping` on October 16.

**Week of October 5, 2026**

Public launch

**New**

* Airbnb, Booking.com, company career pages, Threads, Trustpilot and eBay. Today they are [parsers](https://docs.stophy.dev/scrape/prebuilt-parsers), such as `airbnb-search`, `booking-search`, `careers-jobs`, `threads-post`, `trustpilot-company` and `ebay-search`.
* Facebook pages, posts, comments and Marketplace, Yelp search, businesses and reviews, and Glassdoor company reviews and salaries. Today they are parsers such as `facebook-page`, `yelp-search` and `glassdoor-reviews`.
* Nine more endpoints work without an API key, within the free limit.

**Improved**

* Request fields use the same names as the fields in the response, each endpoint takes the filters its site has, and one rule sets the price of every call.
* Long text comes back whole. Add `?maxTextLength=<characters>` to the URL to cut it.

**Fixed**

* Pages of results stop repeating rows, and a cursor Stophy did not issue is refused before any call.
* A search with nothing relevant answers "no results" at once.
* Amazon best sellers fill all 50 ranks.

**Removed**

* 11 rarely used endpoints: YouTube charts, related videos, hashtags and channel search, Google videos, Reddit domain, Microsoft ads search, ad and advertisers, and Pinterest ads search and ad.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.