> ## 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
> Use the Stophy REST API: one base URL, bearer key authentication, a JSON body for every endpoint, and one response shape for every call.
**For AI agents:** use [llms.txt](https://docs.stophy.dev/llms.txt) for a full index of these docs.
Every Stophy endpoint uses the same base URL and bearer key. Data endpoints take a JSON body and return a consistent response.
## Features
Web and news search, site maps, SEO, domains and emails.YouTube, TikTok and Kick videos, transcripts and comments.Posts, profiles and comments from Reddit, Instagram, X and more.Google Maps places and reviews, flights, Tripadvisor and Airbnb.Products and prices from Amazon, Walmart, AliExpress and Shopify.App Store and Google Play apps, charts and reviews.Job listings from LinkedIn, Indeed and Upwork.Homes from Zillow, Redfin, Realtor.com, Rightmove and ImmoScout24.Ad libraries from Meta, Google, TikTok, LinkedIn and more.Stock quotes and history, crypto prices, DEX pairs and wallets.
See every endpoint in the sidebar, grouped the same way.
## Base URL
```text theme={null}
https://api.stophy.dev
```
Data endpoints use `POST /v1//` with a JSON object body. Unknown input fields return `400`.
## Authentication
Create a key in the [dashboard](https://stophy.dev/signup). Send it with every request:
```text theme={null}
Authorization: Bearer
```
```bash cURL icon="terminal" theme={null}
curl -X POST https://api.stophy.dev/v1/reddit/search \
-H "Authorization: Bearer $STOPHY_API_KEY" \
-H "content-type: application/json" \
-d '{"query":"bun runtime"}'
```
```ts TypeScript icon="https://mintcdn.com/sirathic/7E4w9-IC4ysabjfc/images/icons/typescript.svg?fit=max&auto=format&n=7E4w9-IC4ysabjfc&q=85&s=d8272a85e64145620f1fbbfcf7932986" theme={null}
const response = await fetch("https://api.stophy.dev/v1/reddit/search", {
method: "POST",
headers: {
authorization: "Bearer " + process.env.STOPHY_API_KEY,
"content-type": "application/json",
},
body: JSON.stringify({ query: "bun runtime" }),
});
```
```python Python icon="python" theme={null}
import os
import requests
response = requests.post(
"https://api.stophy.dev/v1/reddit/search",
headers={"Authorization": f"Bearer {os.environ['STOPHY_API_KEY']}"},
json={"query": "bun runtime"},
timeout=30,
)
```
An invalid or missing key returns `401` with code `unauthorized`.
## Response envelope
A successful call returns `success`, `data`, `creditsUsed`, and `requestId`:
```json theme={null}
{
"success": true,
"data": {},
"creditsUsed": 1,
"requestId": "7db121ac-d8e6-479a-b17c-59e3fe5fabd8"
}
```
The shape of `data` depends on the endpoint. A failed call returns an error status and `{ "success": false, "error": { ... } }`. See [Errors](/api-reference/errors).
## Markdown output
Send `Accept: text/markdown` with your key to get readable text instead of JSON. Errors remain JSON. See the [advanced guide](/advanced-guide#markdown-output).