Docs
The scraping layer your agent can keep reaching for.
29 tools across social, jobs, ads, reviews, and trend research — all behind onePOST /api/tools/{tool} with x402 or MPP settlement. No keys. No SDKs. Pay only for 2xx responses.
Quickstart
Three commands to start buying
Any agent with AgentCash installed can discover, try, and persist hirescrape in one session. Copy-paste these into your terminal.
Sets up the AgentCash wallet and routes you through starter credits if needed.
$ npx agentcash onboardDiscovers the origin and walks the first live call path.
$ npx agentcash try https://hirescrape.comKeeps hirescrape available in your agent's persistent context across sessions.
$ npx agentcash add https://hirescrape.comPayment
Two protocols, one 402
Every 402 advertises both. Your agent picks whichever its wallet supports.
On-chain USDC settlement per call. EIP-3009 transferWithAuthorization signature routed through the CDP facilitator. Supports Base mainnet and Solana mainnet on this site.
- Header
- WWW-Authenticate / X-PAYMENT
- Networks
- Base, Solana
- Settles
- on-chain
Off-chain signed credentials with Tempo L1 settlement. Sub-second confirmations, stablecoin-native gas. Ideal for high-frequency calls.
- Header
- WWW-Authenticate: Payment
- Networks
- Tempo
- Settles
- off-chain → Tempo
28 endpoints
Every platform, one catalog
Full input/output schemas at /openapi.json. Agent-ready context at /llms.txt.
Scrape Reddit posts, comments, AI Answers, subreddits, and search. TLS fingerprinting, no API key.
/api/tools/reddit$0.02–$0.52Scrape jobs from LinkedIn, Indeed, Glassdoor, Google Jobs, ZipRecruiter, Bayt, BDJobs, and Naukri in one call.
/api/tools/jobs$0.05–$1.65Videos, profiles, comments, likes, live rooms, trending across all three platforms.
/api/tools/tiktok$0.02–$1.02Research a topic across Reddit, TikTok, YouTube, Instagram, HN, Polymarket. Ranked + clustered.
/api/tools/trend-intel$0.15–$0.35Instagram profiles, posts, reels, comments, highlights, transcripts, reel search.
/api/tools/instagram$0.05–$2.00YouTube channels, videos, shorts, transcripts, comments, keyword + hashtag search, playlists, community posts.
/api/tools/youtube$0.05–$2.00LinkedIn person profiles, company pages, paginated company posts, individual post details.
/api/tools/linkedin$0.05–$2.00Facebook profiles, posts, photos, reels, group posts, comments, transcripts.
/api/tools/facebook$0.05–$2.00X (Twitter) profiles, user tweets, tweet details + transcripts, community metadata and tweets.
/api/tools/twitter$0.05–$2.00Meta Threads profiles, user posts, post details, keyword + user search (with date filters).
/api/tools/threads$0.05–$2.00Bluesky profiles, user posts, individual post details.
/api/tools/bluesky$0.05–$2.00Pinterest keyword search, pin details, user boards, full board contents.
/api/tools/pinterest$0.05–$2.00Truth Social profiles, user posts, individual post details.
/api/tools/truth-social$0.05–$2.00Twitch streamer profiles and clip details.
/api/tools/twitch$0.05–$2.00Kick.com clip details.
/api/tools/kick$0.05–$2.00Snapchat public user profiles.
/api/tools/snapchat$0.05–$2.00TikTok Shop keyword search, shop product lists, product details + reviews, creator showcases.
/api/tools/tiktok-shop$0.05–$2.00Meta Ad Library: search ads by keyword or company, get single-ad details, filter by country, status, media type, date range.
/api/tools/fb-ad-library$0.05–$2.00Google's Ads Transparency Center: advertiser search, full company ad history (with topic/region/date filters), single-ad details.
/api/tools/google-ad-library$0.05–$2.00LinkedIn ads search by company name / ID / keyword with country + date filters, plus single-ad details.
/api/tools/linkedin-ad-library$0.05–$2.00Plain Google search: organic results for a keyword with region, freshness, and pagination.
/api/tools/google-search$0.05–$2.00Amazon storefront / shop page extraction: products, prices, metadata.
/api/tools/amazon-shop$0.05–$2.00Estimate age bucket + gender from a social profile's avatar.
/api/tools/age-gender$0.05–$2.00Extract all links + metadata from a Linktree profile.
/api/tools/linktree$0.05–$2.00Extract creator link-in-bio data from Komi pages.
/api/tools/komi$0.05–$2.00Extract creator link-in-bio data from Pillar pages.
/api/tools/pillar$0.05–$2.00Extract creator link-in-bio data from lnk.bio pages.
/api/tools/linkbio$0.05–$2.00Extract creator link-in-bio data from link.me pages.
/api/tools/linkme$0.05–$2.00Why pay-per-call
Subscriptions were built for humans
Human-managed
- 1Sign up for 29 APIs — separate accounts, dashboards, billing
- 2Buy credits upfront — minimums, unused credits expire
- 3Rotate API keys — security overhead, credential sprawl
- 4Monitor 29 bills — reconcile usage across providers monthly
- 5Agent asks permission — "which tool should I use for this?"
Autonomous execution
- 1One endpoint — all 29 tools, one interface
- 2Pay per request — pennies when used, $0 when idle
- 3No credentials — payment is authentication
- 4One ledger — every tx on-chain, real-time
- 5Agent decides — within budget, autonomous
Examples
Copy-paste integrations
AgentCash MCP — recommended
// In Claude Code / Cursor / Codex / Windsurf:
await mcp__agentcash__fetch({
url: "https://hirescrape.com/api/tools/reddit",
method: "POST",
body: { action: "search_posts", query: "ai agents", limit: 20 }
});
// → data + { protocol: "mpp" | "x402", amount, currency }curl (raw x402 flow)
# 1. First call → 402 with payment challenge
curl -i -X POST https://hirescrape.com/api/tools/reddit \
-H "Content-Type: application/json" \
-d '{"action":"search_posts","query":"ai","limit":20}'
# 2. Sign the challenge with your wallet, retry with X-PAYMENT:
curl -X POST https://hirescrape.com/api/tools/reddit \
-H "Content-Type: application/json" \
-H "X-PAYMENT: ${SIGNED_BASE64}" \
-d '{"action":"search_posts","query":"ai","limit":20}'TypeScript (viem + x402-fetch)
import { x402Fetch } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";
const account = privateKeyToAccount(process.env.PRIVATE_KEY!);
const fetch402 = x402Fetch({ account, chain: "base" });
const res = await fetch402("https://hirescrape.com/api/tools/reddit", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ action: "search_posts", query: "ai", limit: 20 })
});
const { items } = await res.json();Python (x402-py)
from x402 import Client
from eth_account import Account
client = Client(account=Account.from_key(PRIVATE_KEY), chain="base")
r = client.post(
"https://hirescrape.com/api/tools/google-maps",
json={"query": "coffee shops in Austin TX", "maxResults": 50},
)
print(len(r.json()["items"]))Errors
What to expect when things fail
payment_required
No payment header present. Sign the challenge and retry.
payment_verification_failed
Signature was present but invalid, expired, or underpriced. Check the facilitator response in the body.
unknown_tool
The tool ID in the path isn't in our registry. Check /openapi.json.
rate_limited
Per-visitor rate limits hit. Body includes retryAfterMs. Back off and retry.
run_failed
Upstream scraper failed AFTER payment settled. Contact support with the runId for a manual refund.
upstream_error
Backend provider returned an error. Payment was NOT settled. Retry with different parameters.
timeout
Scrape exceeded 5 minutes. Payment was already settled. Retry the same input.
Discovery
Where agents find us
Agents using AgentCash-funded wallets (Claude Code, Cursor, Codex, Windsurf) auto-discover hirescrape through the shared OpenAPI manifest. No API key exchange required.