> ## 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.

# Pre-built parsers

> Read a site's own data as JSON. Name one of 114 parsers in a scrape request for Reddit, YouTube, Google Maps, Amazon and more.

A parser reads one kind of page on one site and returns its data as JSON. Name it in a `json` format of [scrape](https://docs.stophy.dev/api-reference/endpoint/scrape.md). The URL must be the kind of page the parser reads, or the call fails with `invalidRequest`. 114 parsers exist. 17 work without an API key when you send no options.

```bash cURL theme={null}
curl -X POST https://api.stophy.dev/v1/scrape \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","formats":[{"type":"json","parser":"youtube-transcript"}]}'
```

```typescript TypeScript theme={null}
import { Stophy } from "stophy";

const stophy = new Stophy();

const result = await stophy.parsed(
  "youtube-transcript",
  "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
);
console.log(result);
```

```python Python theme={null}
from stophy import Stophy

stophy = Stophy()

result = stophy.parsed(
    "youtube-transcript",
    "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
)
print(result)
```

The data is in `data.json`.

```json theme={null}
{
  "success": true,
  "data": {
    "json": {
      "videoId": "dQw4w9WgXcQ",
      "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "language": "en",
      "isAutoGenerated": false,
      "durationSeconds": 213,
      "text": "[♪♪♪] ♪ We're no strangers to love ♪ ♪ You know the rules and so do I ♪ ♪ A full commitment's what I'm thinking of ♪ ♪…"
    },
    "metadata": {
      "sourceURL": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
      "statusCode": 200,
      "contentType": "application/json",
      "cacheState": "hit",
      "cachedAt": "2026-11-13T18:00:17.852Z",
      "scrapeId": "1f9bf570-b032-4f11-99f3-552b8c934ce1",
      "costUsd": 0.001
    }
  }
}
```

## Options

Send options in the `options` object of the format, like `{"type": "json", "parser": "youtube-transcript", "options": {"language": "en"}}`. A parser that reads more than one kind of page takes `view`.

| Option | Meaning |
| - | - |
| `country` | ISO 3166-1 alpha-2 country code, e.g. us. Any case is accepted. |
| `language` | BCP 47 language tag, e.g. en or pt-BR. Any case is accepted. |
| `page` | Page number, starting at 1. |
| `cursor` | The cursor from the previous response. Send it as is. |
| `currency` | ISO 4217 currency code, e.g. USD. |
| `limit` | Return at most this many apps. You pay \$0.001 for each 10 returned. |

## Parsers

Each page lists the page a parser reads, an example URL, the fields it returns and its options.

* [Search and the web](https://docs.stophy.dev/scrape/prebuilt-parsers/web.md): `google-patents`, `google-trends`, `emails`, `phone-numbers`
* [Video](https://docs.stophy.dev/scrape/prebuilt-parsers/video.md): `youtube-search`, `youtube-video`, `youtube-transcript`, `youtube-comments`, `youtube-channel`, `youtube-post`, `youtube-playlist`, `tiktok-video`, `tiktok-comments`, `tiktok-transcript`, `tiktok-profile`, `tiktok-hashtag`, `tiktok-sound`, `tiktok-search`, `tiktok-followers`, `tiktok-following`, `tiktok-trending`, `tiktok-live`, `twitch-profile`, `twitch-clips`, `instagram-transcript`
* [Social](https://docs.stophy.dev/scrape/prebuilt-parsers/social.md): `reddit-search`, `reddit-post`, `reddit-subreddit`, `reddit-user`, `reddit-subreddits`, `instagram-post`, `instagram-profile`, `instagram-comments`, `instagram-feed`, `x-profile`, `x-post`, `x-community`, `threads-profile`, `threads-post`, `pinterest-search`, `pinterest-pin`, `pinterest-board`, `pinterest-profile`, `facebook-page`, `facebook-group`, `facebook-post`, `facebook-comments`, `linkedin-company`, `linkedin-profile`, `linkedin-posts`, `bsky-profile`, `bsky-post`, `link-in-bio`
* [Places and travel](https://docs.stophy.dev/scrape/prebuilt-parsers/places-and-travel.md): `google-maps`, `google-maps-place`, `google-maps-reviews`, `google-flights`, `google-hotels`, `tripadvisor-search`, `tripadvisor-place`, `tripadvisor-reviews`, `yelp-search`, `yelp-business`, `yelp-reviews`, `booking-search`, `booking-hotel`, `booking-reviews`, `expedia-hotels`, `airbnb-search`, `airbnb-listing`, `airbnb-reviews`, `luma-events`, `luma-event`
* [Jobs](https://docs.stophy.dev/scrape/prebuilt-parsers/jobs.md): `linkedin-jobs`, `linkedin-job`, `indeed-search`, `indeed-job`, `upwork-search`, `upwork-job`, `careers-jobs`, `careers-job`, `glassdoor-company`, `glassdoor-reviews`, `glassdoor-salaries`
* [Shopping](https://docs.stophy.dev/scrape/prebuilt-parsers/shopping.md): `amazon-search`, `amazon-product`, `amazon-reviews`, `amazon-bestsellers`, `tiktok-shop`, `ebay-search`, `ebay-item`, `facebook-marketplace`, `craigslist-search`, `trustpilot-search`, `trustpilot-company`, `trustpilot-reviews`, `craigslist-listing`
* [Apps](https://docs.stophy.dev/scrape/prebuilt-parsers/apps.md): `appstore-search`, `appstore-app`, `appstore-reviews`, `appstore-top`, `google-play-search`, `google-play-app`, `google-play-reviews`
* [Real estate](https://docs.stophy.dev/scrape/prebuilt-parsers/real-estate.md): `zillow-search`, `zillow-property`, `realtor-search`, `realtor-property`
* [Ads](https://docs.stophy.dev/scrape/prebuilt-parsers/ads.md): `meta-ads`, `google-ads`, `tiktok-ads`, `linkedin-ads`
* [Companies and reviews](https://docs.stophy.dev/scrape/prebuilt-parsers/business.md): `crunchbase-company`, `g2-reviews`

## Read the list from code

`GET /v1/parsers` is free and needs no API key. Each entry has `takes`, `example`, `options`, `returns`, `price`, `keyless` and a sample `response`. It is the only place that lists each parser's price. See [Pricing](https://docs.stophy.dev/account/pricing.md) for the rest.

```bash theme={null}
curl -s https://api.stophy.dev/v1/parsers \
  | jq -r '.data.parsers[] | select(.name | startswith("youtube")) | "\(.name): \(.takes)"'
```


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