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

# Introduction

> Stophy is a web scraping API for AI agents. One API to search the web, read what people say, and look up products, places, jobs and homes.

Stophy is a web scraping API for AI agents. One API to search the web, read what people say, and look up products, places, jobs and homes. Pay only for answers.

## Try it now

No account, no key. Run this.

```bash theme={null}
curl -X POST https://api.stophy.dev/v1/google/search \
  -H "content-type: application/json" \
  -d '{"query":"bun runtime"}'
```

<Accordion title="Response">
  ```json theme={null}
  {
    "success": true,
    "data": {
      "results": [
        {
          "type": "web",
          "url": "https://bun.com/",
          "title": "Bun — A fast all-in-one JavaScript runtime",
          "description": "Bun is a fast JavaScript runtime & toolkit. All in one. Runtime, package manager, test runner and bundler in a single binary.",
          "position": 1
        }
      ]
    },
    "creditsUsed": 0,
    "requestId": "5d8fa22c-6ed4-4690-b20f-5b6b92b160a6"
  }
  ```
</Accordion>

You get Google results with `creditsUsed: 0`. A key lifts the free limit, and a failed call costs nothing.

## Connect your agent

<CodeGroup>
  ```bash Claude Code theme={null}
  claude mcp add --transport http stophy https://api.stophy.dev/mcp
  ```

  ```bash Codex theme={null}
  codex mcp add stophy --url https://api.stophy.dev/mcp
  ```
</CodeGroup>

Your agent can use the free endpoints right away. To use every endpoint, sign in with your browser at `https://mcp.stophy.dev/mcp`. Every other client has its own page in [MCP server](/mcp-server).

## What your agent can get

<CardGroup cols={3}>
  <Card title="Search and AI answers" icon="magnifying-glass" href="/sources/web">
    Google results, news, Scholar papers and AI Mode answers.
  </Card>

  <Card title="Video" icon="video" href="/sources/video">
    YouTube and TikTok videos, comments and transcripts.
  </Card>

  <Card title="Social" icon="users" href="/sources/social">
    Reddit threads, X posts, and Instagram, Facebook, LinkedIn and Threads pages.
  </Card>

  <Card title="Places and travel" icon="map-location-dot" href="/sources/places-and-travel">
    Google Maps reviews, hotels, flights, Airbnb and Booking.com.
  </Card>

  <Card title="Jobs" icon="briefcase" href="/sources/jobs">
    LinkedIn, Indeed, Upwork, Google Jobs and company careers pages.
  </Card>

  <Card title="Shopping" icon="cart-shopping" href="/sources/shopping">
    Amazon, eBay and Google Shopping prices, and Trustpilot reviews.
  </Card>

  <Card title="Apps" icon="mobile-screen" href="/sources/apps">
    App Store and Google Play apps and their reviews.
  </Card>

  <Card title="Real estate" icon="house" href="/sources/real-estate">
    Zillow homes for sale, for rent and sold.
  </Card>

  <Card title="Ads" icon="bullhorn" href="/sources/ads">
    The Meta, Google, TikTok and LinkedIn ad libraries.
  </Card>
</CardGroup>

## Search, then read

Find posts with `reddit.search`, then open one with `reddit.post` to read its comments. Most sites work this way. Each call returns one page, and the response tells you how to get the next. `reddit.search` is free to try, and `reddit.post` needs a key. See [Page through results](/guides/paging).

## What it costs

* Most calls cost 1 credit.
* New accounts get 1,000 free credits.
* A call that fails or finds nothing costs nothing.

See [Credits and billing](/billing) for the few that cost more.

## Next

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get a key and call Stophy from TypeScript, Python or the CLI.
  </Card>

  <Card title="Find an endpoint" icon="compass" href="/guides/find-endpoint">
    Pick the right endpoint for what you need.
  </Card>

  <Card title="API reference" icon="code" href="/api-reference/introduction">
    Every endpoint, with its inputs, outputs and price.
  </Card>

  <Card title="llms.txt" icon="robot" href="https://docs.stophy.dev/llms.txt">
    These docs as one index your agent can read.
  </Card>
</CardGroup>


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