# AgentAPIGate.ai — The OpenRouter for Real-Time AI Agent Data APIs > One API key (`aag_live_*` / scoped `aag_agent_*`), one non-expiring USD balance, Remote Streamable HTTP MCP (`https://mcp.agentapigate.ai/mcp`), Coinbase x402 v2 (Base USDC `0x4E55506145578bE737a8Edb7b983D2014bfb617c` + Solana USDC `696xsBPQetb8h6e5c1ueuZPQRoCCvEMrVTcbpCyrJ3Lo`), and Tempo MPP across 70 canonical real-time data endpoints. ## Agent-Native Capabilities - **Token Economy Output**: Append `?format=compact` or `?format=md` to shrink raw JSON payloads by 56-94% before LLM context injection. Every response includes `X-AAG-Tokens-Est`. - **Deterministic Money Controls**: `X-AAG-Cost-USD`, `X-AAG-Balance-USD`, `?dry_run=1` ($0 pre-flight price quote), `X-AAG-Max-Cost` ceiling, and `Idempotency-Key` anti-double-billing. Empty results & 4xx/5xx upstream errors cost `$0.00`. - **Autonomous Key Vending**: `POST https://api.agentapigate.ai/v1/x402/buy-credits` ($1 / $5 / $25 / $99 USDC -> instant `aag_live_*` API key). - **Remote MCP Hub**: Connect `https://mcp.agentapigate.ai/mcp` (`ai.agentapigate/hub` — 4 discovery/execution tools + 6 workflow prompts in <800 tokens) or any of our 8 focused vertical packs (`https://mcp.agentapigate.ai/mcp/`). ## Machine-Readable Specs - Full LLM Reference: https://agentapigate.ai/llms-full.txt - Agent Skill File: https://agentapigate.ai/SKILL.md - OpenAPI 3.1 Spec (with x-payment-info & x-guidance): https://api.agentapigate.ai/openapi.json - x402 Resource Index: https://api.agentapigate.ai/.well-known/x402 - ERC-8004 Agent Card: https://agentapigate.ai/.well-known/agent-card.json - MCP Manifest: https://agentapigate.ai/.well-known/mcp.json - Live Status: https://status.agentapigate.ai ## Multi-Step Research Workflow Recipes (Bounded & Cost-Disclosed) Machine-readable index: `GET https://api.agentapigate.ai/v1/recipes` · Exact pre-run quote: `GET https://api.agentapigate.ai/v1/recipes/{id}/quote?n=20`. All recipes below are descriptive reference patterns with explicit cost estimates, stopping criteria, and 1–3 call `lite` paths: ### Local Business Lead List & Website Verification (`local-lead-list`) - **Summary**: Seeds candidate businesses from Google Maps search, inspects place details for phone/website metadata, and extracts clean Markdown from verified business homepages. - **Pipeline**: `maps.google.search` -> `maps.google.place_details` -> `web.extract.markdown` - **Full Path**: `12–45 calls` · est. `$0.0425` · default budget cap `$0.120` - **Lite Path (1–2 calls, ~$0.0035)**: Single maps.google.search call followed by one maps.google.place_details lookup on the top match. - **Stopping Criteria**: Halts candidate enrichment once target qualified lead count is reached, when the last 5 inspected listings yield fewer than 1 active website, or when cumulative X-AAG-Cost-USD reaches budget_usd. ### Company KYB, Filing, Hiring & Domain Due Diligence (`company-due-diligence`) - **Summary**: Combines legal entity LEI/VAT verification, domain RDAP/TLS posture, SEC EDGAR filings (for public issuers), live ATS hiring velocity, and recent news coverage. - **Pipeline**: `kyb.company.lei_vat` -> `intel.domain.whois_rdap_dns_ssl` -> `sec.company.filings` -> `jobs.company.velocity` -> `search.google.news` - **Full Path**: `4–8 calls` · est. `$0.0060` · default budget cap `$0.025` - **Lite Path (2–2 calls, ~$0.0020)**: Two-call verification covering legal entity LEI/VAT registration and domain RDAP/TLS status. - **Stopping Criteria**: Skips sec.company.filings when the entity has no public US ticker/CIK, and stops news expansion once primary corporate domain and registration status are corroborated. ### Cross-Platform Creator Engagement & Content Vetting (`creator-influencer-vetting`) - **Summary**: Evaluates creator authenticity across YouTube, TikTok, and X by comparing follower baselines against recent post engagement and spoken transcript themes. - **Pipeline**: `tiktok.user.profile` -> `tiktok.user.posts` -> `x.user.info` -> `youtube.video.transcript` - **Full Path**: `5–18 calls` · est. `$0.0110` · default budget cap `$0.040` - **Lite Path (2–2 calls, ~$0.0020)**: Two-call profile and recent post engagement snapshot for a single creator handle. - **Stopping Criteria**: Stops per-video transcript sampling after 3 representative recent uploads or if engagement ratio falls below target campaign thresholds. ### Multi-Channel Brand & Product Mention Monitoring (`brand-mention-monitoring`) - **Summary**: Aggregates fresh brand, product, or competitor mentions across X search, Reddit communities, Hacker News discussions, and Google News. - **Pipeline**: `x.tweet.search` -> `reddit.search.posts` -> `hn.search.stories` -> `reddit.post.comments` - **Full Path**: `4–10 calls` · est. `$0.0090` · default budget cap `$0.030` - **Lite Path (2–2 calls, ~$0.0025)**: Two-call community scan across Reddit and Hacker News in compact Markdown. - **Stopping Criteria**: Expands comment threads only on posts exceeding engagement thresholds (e.g. >10 replies) and stops at budget_usd. ### E-Commerce & SaaS Competitor Price & Demand Watch (`competitor-price-watch`) - **Summary**: Tracks competitor storefront product catalogs, marketplace pricing, historical pricing-page diffs, and search demand volume. - **Pipeline**: `shopify.store.products` -> `amazon.products.search` -> `web.wayback.diff` -> `seo.keywords.overview` - **Full Path**: `3–10 calls` · est. `$0.0350` · default budget cap `$0.080` - **Lite Path (2–2 calls, ~$0.0020)**: Two-call storefront SKU catalog and historical pricing-page diff check. - **Stopping Criteria**: Queries seo.keywords.overview in a single batch call (up to 50 keywords at once) rather than per-keyword calls, and stops once target SKUs are matched. ### External Domain, IP RDAP/TLS & Vulnerability Posture Review (`domain-security-posture`) - **Summary**: Assesses external infrastructure hygiene using passive RDAP WHOIS, DNS/MX/TXT records, TLS certificate SANs, IP network RDAP/PTR ownership, and NVD/OSV/EPSS CVE lookups. - **Pipeline**: `intel.domain.whois_rdap_dns_ssl` -> `intel.ip.network_rdap_ptr` -> `security.cve.search` - **Full Path**: `3–8 calls` · est. `$0.0030` · default budget cap `$0.015` - **Lite Path (2–2 calls, ~$0.0015)**: Two-call passive domain RDAP/DNS/TLS and primary IP network posture check. - **Stopping Criteria**: Inspects only unique public IPv4 addresses returned in domain A records (capped at 4 IPs) and queries security.cve.search only when software product banners or dependencies are identified. ## Canonical Endpoints (70 Live across 8 Packs) ### X (Twitter) Real-Time Suite (`/mcp/x` · 16 endpoints) - `GET https://api.agentapigate.ai/v1/x/tweet/search` (`x.tweet.search`, $0.002/call, paid_usd/x402) — Search real-time or historical X (Twitter) posts with full search operators (Latest or Top). - `GET https://api.agentapigate.ai/v1/x/tweet/detail` (`x.tweet.detail`, $0.002/call, paid_usd/x402) — Fetch full normalized post text, author metadata, and engagement metrics for one or more tweet IDs. - `GET https://api.agentapigate.ai/v1/x/tweet/replies` (`x.tweet.replies`, $0.002/call, paid_usd/x402) — Retrieve replies to a specific X post with author metrics and pagination cursor. - `GET https://api.agentapigate.ai/v1/x/tweet/quotes` (`x.tweet.quotes`, $0.002/call, paid_usd/x402) — Fetch quote posts referencing a target tweet ID. - `GET https://api.agentapigate.ai/v1/x/tweet/retweeters` (`x.tweet.retweeters`, $0.002/call, paid_usd/x402) — List accounts that reposted a specific X tweet. - `GET https://api.agentapigate.ai/v1/x/tweet/thread` (`x.tweet.thread`, $0.002/call, paid_usd/x402) — Reconstruct the full parent/author conversation thread surrounding a tweet ID. - `GET https://api.agentapigate.ai/v1/x/user/info` (`x.user.info`, $0.002/call, paid_usd/x402) — Fetch complete profile metadata, bio, follower count, and verification badge by X handle. - `GET https://api.agentapigate.ai/v1/x/user/about` (`x.user.about`, $0.002/call, paid_usd/x402) — Inspect account creation region, handle history metadata, and verification details for an X user. - `GET https://api.agentapigate.ai/v1/x/user/tweets` (`x.user.tweets`, $0.002/call, paid_usd/x402) — Fetch the latest timeline posts authored by an X handle. - `GET https://api.agentapigate.ai/v1/x/user/followers` (`x.user.followers`, $0.002/call, paid_usd/x402) — List followers of a target X account with bio and follower counts. - `GET https://api.agentapigate.ai/v1/x/user/followings` (`x.user.followings`, $0.002/call, paid_usd/x402) — List accounts followed by a target X user. - `GET https://api.agentapigate.ai/v1/x/user/mentions` (`x.user.mentions`, $0.002/call, paid_usd/x402) — Retrieve recent public posts mentioning a specific X username. - `GET https://api.agentapigate.ai/v1/x/user/search` (`x.user.search`, $0.002/call, paid_usd/x402) — Search X profiles by name, role, company, or bio keyword. - `GET https://api.agentapigate.ai/v1/x/list/tweets` (`x.list.tweets`, $0.002/call, paid_usd/x402) — Fetch latest tweets from any public X List by listId. - `GET https://api.agentapigate.ai/v1/x/community/tweets` (`x.community.tweets`, $0.002/call, paid_usd/x402) — Fetch posts from any public X Community by community_id. - `GET https://api.agentapigate.ai/v1/x/trends/place` (`x.trends.place`, $0.002/call, paid_usd/x402) — Fetch live trending topics and tweet volumes on X by geographic WOEID (1 = Worldwide, 23424977 = US). ### Web Search, SEO Keywords & Markdown Reader (`/mcp/search` · 10 endpoints) - `GET https://api.agentapigate.ai/v1/search/google/web` (`search.google.web`, $0.0025/call) — Real-time Google organic search results with ranked URLs, titles, snippets, and knowledge metadata. - `GET https://api.agentapigate.ai/v1/search/google/news` (`search.google.news`, $0.001/call) — Search breaking news articles and publisher headlines across Google News. - `GET https://api.agentapigate.ai/v1/search/google/images` (`search.google.images`, $0.003/call) — Search high-resolution web images with source page URLs, dimensions, and alt titles. - `GET https://api.agentapigate.ai/v1/search/google/autocomplete` (`search.google.autocomplete`, $0.0005/call) — Sub-100ms Google Suggest autocomplete queries for intent discovery and agent query expansion. - `GET https://api.agentapigate.ai/v1/search/google/trends_realtime` (`search.google.trends_realtime`, $0.001/call) — Fetch surging Google Search topics and approximate search traffic volume by country. - `GET https://api.agentapigate.ai/v1/search/google/trends_interest` (`search.google.trends_interest`, $0.003/call) — Compare search interest over time across up to 5 keywords using Google Trends data. - `GET https://api.agentapigate.ai/v1/seo/keywords/overview` (`seo.keywords.overview`, $0.03/call) — Batch lookup monthly Google search volume, CPC (USD), competition index, and 12-month trend for up to 50 keywords. - `GET https://api.agentapigate.ai/v1/seo/keywords/ideas` (`seo.keywords.ideas`, $0.03/call) — Expand a seed keyword into high-intent long-tail Google keyword suggestions with monthly volume, CPC, and difficulty. - `GET https://api.agentapigate.ai/v1/web/extract/markdown` (`web.extract.markdown`, $0.001/call) — Fetch any public webpage (SSRF-guarded) and convert main content into clean, prompt-ready Markdown with metadata and links. - `GET https://api.agentapigate.ai/v1/web/wayback/diff` (`web.wayback.diff`, $0.001/call) — Inspect Internet Archive CDX historical captures, status codes, and digest changes for any public URL. ### Short Video, YouTube Transcripts & Communities (`/mcp/social` · 15 endpoints) - `GET https://api.agentapigate.ai/v1/tiktok/user/profile` (`tiktok.user.profile`, $0.001/call) — Fetch TikTok account profile bio, verification badge, follower count, heart count, and video count. - `GET https://api.agentapigate.ai/v1/tiktok/user/posts` (`tiktok.user.posts`, $0.001/call) — List recent short videos posted by a TikTok creator with view, like, comment, and share counts. - `GET https://api.agentapigate.ai/v1/tiktok/video/detail` (`tiktok.video.detail`, $0.001/call) — Fetch full metadata, audio track, author details, and engagement metrics for a TikTok video URL or ID. - `GET https://api.agentapigate.ai/v1/tiktok/video/comments` (`tiktok.video.comments`, $0.001/call) — Fetch top comments on a TikTok video URL or ID with author handles and like counts. - `GET https://api.agentapigate.ai/v1/tiktok/search/videos` (`tiktok.search.videos`, $0.001/call) — Search TikTok short videos by keyword with view, like, and creator statistics. - `GET https://api.agentapigate.ai/v1/tiktok/trending/feed` (`tiktok.trending.feed`, $0.001/call) — Fetch currently trending viral TikTok videos in a target country code. - `GET https://api.agentapigate.ai/v1/youtube/video/detail` (`youtube.video.detail`, $0.001/call) — Retrieve YouTube video title, channel info, view count, duration, keywords, and description by video ID or URL. - `GET https://api.agentapigate.ai/v1/youtube/video/transcript` (`youtube.video.transcript`, $0.001/call) — Extract full clean text transcript and timestamped caption segments from any captioned YouTube video (#1 LLM RAG workflow). - `GET https://api.agentapigate.ai/v1/youtube/search/videos` (`youtube.search.videos`, $0.001/call) — Search YouTube videos with video IDs, titles, channel names, view counts, and publish times. - `GET https://api.agentapigate.ai/v1/youtube/channel/videos` (`youtube.channel.videos`, $0.001/call) — Fetch latest uploaded videos for a YouTube channel ID (`UC...`). - `GET https://api.agentapigate.ai/v1/reddit/subreddit/posts` (`reddit.subreddit.posts`, $0.001/call) — Fetch hot, new, or top posts from any Reddit subreddit with scores, comment counts, and selftext. - `GET https://api.agentapigate.ai/v1/reddit/post/comments` (`reddit.post.comments`, $0.001/call) — Fetch top-level or nested comments on a Reddit post by post URL or post ID + subreddit. - `GET https://api.agentapigate.ai/v1/reddit/search/posts` (`reddit.search.posts`, $0.001/call) — Search Reddit discussions and threads across all subreddits by keyword. - `GET https://api.agentapigate.ai/v1/hn/search/stories` (`hn.search.stories`, $0.0005/call) — Search Hacker News front-page stories and Show HN launches via Algolia with points and comment counts. - `GET https://api.agentapigate.ai/v1/hn/story/comments` (`hn.story.comments`, $0.0005/call) — Fetch full Hacker News story metadata and top-level technical comments by story ID. ### Global E-Commerce & Storefront Intelligence (`/mcp/commerce` · 5 endpoints) - `GET https://api.agentapigate.ai/v1/shopify/store/products` (`shopify.store.products`, $0.0005/call) — Extract structured product SKUs, variants, live pricing, stock availability, and images from any public Shopify store. - `GET https://api.agentapigate.ai/v1/woocommerce/store/products` (`woocommerce.store.products`, $0.0005/call) — Query public WooCommerce Store API v1 product listings, prices, currencies, and stock status (SSRF-guarded). - `GET https://api.agentapigate.ai/v1/amazon/products/search` (`amazon.products.search`, $0.003/call) — Search Amazon and major online retail listings for live prices, ratings, review counts, and merchant URLs. - `GET https://api.agentapigate.ai/v1/walmart/products/search` (`walmart.products.search`, $0.01/call, paid_usd/x402) — Search Walmart US product catalog with live retail pricing, ratings, and item URLs. - `GET https://api.agentapigate.ai/v1/tiktokshop/product/detail` (`tiktokshop.product.detail`, $0.01/call, paid_usd/x402) — Inspect TikTok Shop product listings, pricing, seller storefront details, and social commerce metadata. ### Company KYB & Live 5-ATS Job Feeds (`/mcp/b2b` · 5 endpoints) - `GET https://api.agentapigate.ai/v1/jobs/ats/search` (`jobs.ats.search`, $0.001/call) — Search live remote and tech job postings across ATS boards (Greenhouse, Ashby, Lever, Remotive, Arbeitnow) by role or skill. - `GET https://api.agentapigate.ai/v1/jobs/company/openings` (`jobs.company.openings`, $0.001/call) — Fetch live open roles directly from a company board across Greenhouse, Ashby, Lever, or SmartRecruiters. - `GET https://api.agentapigate.ai/v1/jobs/company/velocity` (`jobs.company.velocity`, $0.0005/call) — Compute real-time headcount expansion signals, department distribution, and remote ratio from a company ATS board. - `GET https://api.agentapigate.ai/v1/kyb/company/lei_vat` (`kyb.company.lei_vat`, $0.001/call) — Verify legal corporate entities, Legal Entity Identifiers (LEI), registered headquarters, and entity status via GLEIF. - `GET https://api.agentapigate.ai/v1/b2b/people/search` (`b2b.people.search`, $0.002/call) — Discover public professional profiles, titles, and company affiliations by name, role, and company. ### SEC EDGAR, DeFi On-Chain & Prediction Markets (`/mcp/finance` · 9 endpoints) - `GET https://api.agentapigate.ai/v1/sec/company/filings` (`sec.company.filings`, $0.001/call) — Fetch official SEC EDGAR regulatory filings by stock ticker or CIK with direct document URLs. - `GET https://api.agentapigate.ai/v1/sec/insider/transactions` (`sec.insider.transactions`, $0.001/call) — Retrieve recent SEC Form 4 insider stock purchases, sales, and awards for any public company ticker. - `GET https://api.agentapigate.ai/v1/sec/company/facts_xbrl` (`sec.company.facts_xbrl`, $0.001/call) — Query audited US-GAAP XBRL revenue, net income, cash, assets, and EPS history directly from SEC EDGAR. - `GET https://api.agentapigate.ai/v1/crypto/dexscreener/search` (`crypto.dexscreener.search`, $0.0005/call) — Search live DEX liquidity pools across Solana, Base, Ethereum, Arbitrum, and BSC with real-time price, FDV, and 24h volume. - `GET https://api.agentapigate.ai/v1/crypto/dexscreener/token_pairs` (`crypto.dexscreener.token_pairs`, $0.0005/call) — Fetch all active DEX liquidity pools for a specific chain and token contract address. - `GET https://api.agentapigate.ai/v1/crypto/geckoterminal/trending_pools` (`crypto.geckoterminal.trending_pools`, $0.0005/call) — Track surging trending liquidity pools on Base, Solana, Ethereum, or Arbitrum via GeckoTerminal. - `GET https://api.agentapigate.ai/v1/crypto/defillama/protocols_tvl` (`crypto.defillama.protocols_tvl`, $0.0005/call) — Query Total Value Locked (TVL), 1d/7d TVL change, chains, and categories across 4,000+ DeFi protocols. - `GET https://api.agentapigate.ai/v1/macro/fx/rates` (`macro.fx.rates`, $0.0005/call) — Fetch official European Central Bank (ECB) daily reference FX exchange rates for global currencies. - `GET https://api.agentapigate.ai/v1/prediction/polymarket/markets` (`prediction.polymarket.markets`, $0.001/call) — Query active Polymarket prediction markets with live Yes/No implied probabilities, 24h volume, and liquidity. ### Maps Places & Consumer / App Reviews (`/mcp/local` · 4 endpoints) - `GET https://api.agentapigate.ai/v1/maps/google/search` (`maps.google.search`, $0.003/call) — Search Google Maps places and local businesses with ratings, review counts, addresses, phones, and websites. - `GET https://api.agentapigate.ai/v1/maps/google/place_details` (`maps.google.place_details`, $0.003/call) — Inspect detailed place profile, operating hours, contact links, and coordinates for a business name and city. - `GET https://api.agentapigate.ai/v1/reviews/appstore/reviews` (`reviews.appstore.reviews`, $0.0005/call) — Fetch recent customer ratings, review titles, app versions, and review text from the Apple iOS App Store. - `GET https://api.agentapigate.ai/v1/reviews/trustpilot/company` (`reviews.trustpilot.company`, $0.0025/call, paid_usd/x402) — Inspect company TrustScore rating, review count, and recent verified customer reviews on Trustpilot. ### Domain/DNS/SSL Security & Research Papers (`/mcp/intel` · 6 endpoints) - `GET https://api.agentapigate.ai/v1/intel/domain/whois_rdap_dns_ssl` (`intel.domain.whois_rdap_dns_ssl`, $0.001/call) — All-in-one domain intelligence combining RDAP registrar/expiry data, Cloudflare DoH A/MX/TXT/NS records, and live TLS SAN certificate inspection. - `GET https://api.agentapigate.ai/v1/intel/ip/network_rdap_ptr` (`intel.ip.network_rdap_ptr`, $0.0005/call) — Use when you need commercial-grade passive IP reconnaissance: RIR RDAP CIDR/organization/abuse contacts, Cloudflare DoH reverse PTR hostnames, and port-443 TLS SAN inspection. - `GET https://api.agentapigate.ai/v1/intel/ip/geolocation` (`intel.ip.geolocation`, $0.0005/call) — Resolve country, city, coordinates, timezone, ASN, and ISP organization for any public IP address. - `GET https://api.agentapigate.ai/v1/security/cve/search` (`security.cve.search`, $0.0005/call) — Use when you need Common Vulnerabilities and Exposures (CVEs) from NIST NVD 2.0 and OSV.dev enriched with FIRST.org EPSS 30-day exploitation probability. - `GET https://api.agentapigate.ai/v1/research/papers/search` (`research.papers.search`, $0.0005/call) — Search 250M+ peer-reviewed and preprint research papers across OpenAlex and arXiv with citation counts, DOIs, and abstracts. - `GET https://api.agentapigate.ai/v1/biomed/clinical_trials/search` (`biomed.clinical_trials.search`, $0.0005/call) — Query recruiting and completed clinical trials by condition, drug intervention, sponsor, and phase from ClinicalTrials.gov v2.