Skip to content

services: add Surf Twitter, Reddit, and Web data APIs#407

Open
tenequm wants to merge 2 commits intotempoxyz:mainfrom
cascade-protocol:feat/surf-data-apis
Open

services: add Surf Twitter, Reddit, and Web data APIs#407
tenequm wants to merge 2 commits intotempoxyz:mainfrom
cascade-protocol:feat/surf-data-apis

Conversation

@tenequm
Copy link

@tenequm tenequm commented Mar 21, 2026

Services: Surf Data APIs

Three first-party data APIs with native MPP integration, accepting Tempo USDC.

Surf Twitter

URL: https://twitter.surf.cascade.fyi
Endpoints: 26 (tweets, users, lists, communities, spaces, trends)
Pricing: $0.001 - $0.005 per request

Full Twitter/X data access: search tweets, look up users and tweets, browse lists, communities, spaces, and trending topics. Supports pagination, batch lookups, and relationship checks.

Surf Reddit

URL: https://reddit.surf.cascade.fyi
Endpoints: 7 (search, subreddits, posts, comments, users)
Pricing: $0.001 - $0.005 per request

Reddit data: search posts, browse subreddits, read threads with full comment trees, and look up user profiles with post/comment history.

Surf Web

URL: https://web.surf.cascade.fyi
Endpoints: 2 (crawl, search)
Pricing: $0.005 - $0.01 per request

Web crawling (any URL to clean markdown/HTML) and AI-powered web search.

Why these are novel

  • First-party MPP: Payment handling built directly into each service, not proxied.
  • Comprehensive Twitter coverage: 26 endpoints covering the full Twitter/X data surface (tweets, users, lists, communities, spaces, trends). No existing service in the directory covers Twitter/X.
  • Also support MCP (Model Context Protocol) for direct AI agent tool calls alongside REST.

Checklist

  • All services are live and accepting MPP payments
  • schemas/services.ts updated
  • node scripts/generate-discovery.ts run, schemas/discovery.json committed
  • node scripts/gen-icons.cjs run, icons committed
  • pnpm check:types passes
  • pnpm build succeeds

Verify they're live

# Twitter - 402 challenge
curl -s https://twitter.surf.cascade.fyi/users/CoinbaseDev -o /dev/null -w "%{http_code}"
# Returns: 402

# Reddit - 402 challenge
curl -s https://reddit.surf.cascade.fyi/r/programming -o /dev/null -w "%{http_code}"
# Returns: 402

# Web - 402 challenge
curl -s https://web.surf.cascade.fyi/v1/crawl \
  -X POST -H "Content-Type: application/json" \
  -d '{"url":"https://mpp.dev","format":"markdown"}' \
  -o /dev/null -w "%{http_code}"
# Returns: 402

@vercel
Copy link

vercel bot commented Mar 21, 2026

@tenequm is attempting to deploy a commit to the Tempo Team on Vercel.

A member of the Team first needs to authorize it.

First-party MPP data APIs accepting Tempo USDC payments natively.

- Surf Twitter: 26 endpoints for tweets, users, lists, communities, spaces, trends
- Surf Reddit: 7 endpoints for posts, subreddits, comments, user profiles
- Surf Web: 2 endpoints for web crawling (markdown/HTML) and AI-powered search

All services also support MCP (Model Context Protocol) for AI agent tool calls.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant