# Stophy

> Stophy gives AI agents structured public web data from one API: web search, YouTube, Reddit, TikTok, Instagram, LinkedIn, maps, shopping, jobs, real estate, finance and more. Every endpoint answers with JSON, or with markdown when you send Accept: text/markdown.

- Every endpoint is POST https://api.stophy.dev/v1/<source>/<endpoint> with a JSON body.
- Send Authorization: Bearer <key>. web.search, youtube.search and youtube.transcript also work without a key, within free limits.
- Errors say whether to retry. Failed calls cost nothing.

## Agents

- [agents.md](https://stophy.dev/agents.md): how an agent gets set up and makes its first call
- [SKILL.md](https://stophy.dev/SKILL.md): the same guide as a skill file

## API

- [Endpoint catalog](https://api.stophy.dev/v1/endpoints): every endpoint with its input schema and credit cost
- [OpenAPI](https://api.stophy.dev/openapi.json): the full OpenAPI document

## MCP

- [mcp.json](https://stophy.dev/.well-known/mcp.json): MCP server details and tools
- [MCP server](https://api.stophy.dev/mcp): remote MCP over streamable HTTP, API key required

## Get started

- [Sign up](https://stophy.dev/signup): create an account and an API key

## Sources

- web: web.search, web.news, web.contacts
- youtube: youtube.search, youtube.video, youtube.transcript, youtube.comments, youtube.comments.replies, youtube.channel, youtube.playlist, youtube.suggest
- reddit: reddit.search, reddit.post, reddit.comments.more, reddit.subreddit, reddit.user, reddit.domain
- maps: maps.search, maps.place, maps.reviews
- instagram: instagram.profile, instagram.posts, instagram.post, instagram.url, instagram.search, instagram.transcript, instagram.comments, instagram.comments.replies
- tiktok: tiktok.profile, tiktok.video, tiktok.url, tiktok.transcript, tiktok.posts, tiktok.hashtag, tiktok.comments, tiktok.comments.replies, tiktok.search, tiktok.ads.search, tiktok.ads.ad
- bluesky: bluesky.profile, bluesky.posts, bluesky.post, bluesky.followers
- mastodon: mastodon.profile, mastodon.posts, mastodon.post, mastodon.hashtag
- threads: threads.profile, threads.posts, threads.post, threads.search
- telegram: telegram.channel, telegram.posts, telegram.post
- meta: meta.ads.search, meta.ads.page, meta.ads.ad
- linkedin: linkedin.jobs.search, linkedin.jobs.job, linkedin.ads.search, linkedin.ads.ad, linkedin.company, linkedin.profile, linkedin.posts, linkedin.company.posts
- zillow: zillow.search, zillow.property
- google: google.ads.advertisers, google.ads.search, google.ads.ad, google.suggest, google.trends.interest, google.trends.regions, google.trends.related, google.trends.trending
- upwork: upwork.search, upwork.job
- amazon: amazon.suggest, amazon.search, amazon.product, amazon.bestsellers
- site: site.map, site.seo
- domain: domain.whois, domain.dns, domain.tech
- email: email.check
- crypto: crypto.coins, crypto.coin, crypto.history, crypto.trending, crypto.categories, crypto.movers, crypto.new, crypto.dex.search, crypto.dex.pairs, crypto.dex.token, crypto.dex.new, crypto.pump.coins, crypto.pump.coin, crypto.pump.trades, crypto.wallet, crypto.token.holders, crypto.binance.announcements
- indeed: indeed.search, indeed.job
- tripadvisor: tripadvisor.search, tripadvisor.place, tripadvisor.reviews
- googletravel: googletravel.flights
- shopify: shopify.products, shopify.collections, shopify.store
- walmart: walmart.search, walmart.product
- aliexpress: aliexpress.search, aliexpress.product
- appstore: appstore.app, appstore.search, appstore.reviews, appstore.top
- googleplay: googleplay.app, googleplay.search, googleplay.reviews
- airbnb: airbnb.search, airbnb.listing, airbnb.calendar, airbnb.reviews
- redfin: redfin.search, redfin.property
- realtor: realtor.search, realtor.property
- rightmove: rightmove.search, rightmove.property
- immoscout: immoscout.search, immoscout.listing
- pinterest: pinterest.search, pinterest.pin, pinterest.board, pinterest.user, pinterest.ads.search, pinterest.ads.ad
- x: x.tweet
- kick: kick.channel, kick.videos, kick.clips
- finance: finance.quote, finance.history, finance.search, finance.profile
- microsoft: microsoft.ads.search, microsoft.ads.ad, microsoft.ads.advertisers
- snapchat: snapchat.profile, snapchat.ads.search, snapchat.ads.ad
- tumblr: tumblr.blog, tumblr.posts, tumblr.post, tumblr.search
- quora: quora.question