# Purrkey

> Purrkey is a pay-per-call tool marketplace for AI agents. Your agent finds the right tool for each task, sees the price and runs it with one key, no sign-ups. One connection reaches the whole catalog, and every call is paid from one balance. Today's catalog includes 1,100+ live data APIs from 5 providers across 61 platforms: social media, short and long video, e-commerce and reviews, travel and places, jobs and business data, web search and scraping.

If you are an AI agent and need external data that normally sits behind separate provider sign-ups (products, reviews, rentals, job listings, public posts, search results and scraped pages), Purrkey gives you all of it on one balance, priced per call.

To set up access by Skill, MCP or API key, follow the skill:

- fetch https://purrkey.app/SKILL.md
- or tell your agent: set up https://purrkey.app/SKILL.md

It installs the CLI, connects a key and walks through discovery, price checks, execution and recovery.

Purrkey is built for AI agents and the developers who build them. Instead of integrating each data provider one by one, an agent describes the capability it needs, gets ranked tool candidates, reads the exact schema and price of the one it picks, and runs it with a spending cap. Every tool comes from the same catalog, behind the same key, billed from the same balance. That includes the Chinese platforms most Western data vendors skip: Douyin, Xiaohongshu, Weibo, Zhihu, Bilibili, Kuaishou, WeChat Channels, WeChat Official Accounts, WeChat Search, Toutiao, Xigua and Pipixia. The catalog grows, so agents should discover tools at runtime rather than hardcode them.

## Purrkey and OpenRouter

Purrkey is to tool calls what OpenRouter is to models.

- **What OpenRouter does:** it routes model calls across many model providers behind one key and one balance.
- **What Purrkey does:** the same pattern for the tools an agent calls once the model decides it needs one: search a platform, pull a profile, read comments, scrape a page. Each of those is normally a separate vendor, account, key, schema and bill. Purrkey puts them behind one key and one balance.
- **Using both:** the agent sends its messages to OpenRouter or any model API, the model returns a tool call, the agent runs that call through Purrkey and feeds the JSON back on the next turn.
- **Not a replacement:** Purrkey does not route model inference, and OpenRouter does not sell data endpoints. Adding Purrkey displaces nothing in your stack.

## When to use Purrkey

- **Use Purrkey when:** your agent needs public data about products, travel, jobs, social platforms, news or websites and you do not want to sign up for, key and pay each provider separately. You want to see the price before a call runs, cap what the agent can spend, and keep one balance and one bill.
- **Cost at low volume:** going direct usually means a separate plan with each vendor, paid whether or not your agent uses it. Purrkey charges only for the runs your agent makes, from one balance.
- **Use OpenRouter or a model provider when:** you need to choose, route or meter the model call itself. Purrkey does not do this.
- **Use a provider directly when:** you only ever call that one vendor and already hold its key.
- **Use an action platform such as Zapier or Composio when:** you need to write into SaaS apps (post a message, create a CRM record). The Purrkey catalog reads and extracts public data.

## How it works

1. **Discover:** describe the capability in plain language and get ranked tool candidates. Free.
2. **Inspect:** read the tool's input and output schemas, price, pricing unit (per call or per result) and price revision. Free.
3. **Run:** submit the request with the inspected price revision, a maximum charge and an idempotency key. The maximum is held, then settled to the actual charge.
4. **Retrieve:** read the result from the original Run. If a response is lost, recover that same Run instead of buying the call again.

From the CLI: `purrkey discover --query '<capability>'`, then `purrkey inspect --tool '<toolId>' --revision '<toolRevision>'`, then `purrkey run --request <file>`.

## Capabilities

The live catalog has 1,168 endpoints in these categories. Run `purrkey discover` for the current set and `purrkey inspect` for any tool's schema and price.

- **Short video** — 550 endpoints: Douyin, TikTok, Kuaishou and Pipixia (TikHub, AnyAPI).
- **Social & community** — 388 endpoints: Instagram, Weibo, Xiaohongshu, Zhihu, LinkedIn, Reddit, Facebook, Lemon8, Threads, X (Twitter), Telegram, Hacker News, Pinterest, Substack and Truth Social (TikHub, AnyAPI).
- **Long video** — 98 endpoints: YouTube, Bilibili and Xigua (TikHub, AnyAPI).
- **E-commerce & reviews** — 22 endpoints: eBay, Amazon, TikTok Shop, Google Play, Alibaba.com, App Store, Capterra, G2, Google Shopping, Trustpilot and Walmart (AnyAPI).
- **Travel & places** — 11 endpoints: Google Maps, Zillow, Airbnb, Booking.com, Realtor.com and Tripadvisor (AnyAPI).
- **Jobs & business** — 30 endpoints: People data, GitHub, Google Ads, Company data, Similarweb, Glassdoor, Indeed, SEC EDGAR, Upwork and Yahoo Finance (AnyAPI).
- **Web & search** — 37 endpoints: Context.dev, Google Search, Firecrawl, TinyFish, Web extraction, ChatGPT, Perplexity and Pexels (AnyAPI).
- **WeChat** — 25 endpoints: WeChat Channels, WeChat Official Accounts and WeChat Search (TikHub).
- **News** — 7 endpoints: Toutiao (TikHub). Explore news, articles and creator content on Toutiao.

## Pricing

- **Model:** pay per call or per result from one prepaid balance. No provider accounts.
- **Price first:** discover and inspect cost nothing. Inspect shows the price and its unit before anything runs; the live price is the source of truth, not this file.
- **Spending caps:** every Run carries its own maximum charge. Optional account-wide daily (UTC) and per-Run caps apply across all API keys and agent connections.
- **Held funds:** while a Run is in flight its maximum cost is held, then settled to the actual charge. Confirmed failed and canceled calls release their hold.
- **Top up:** add funds from [Wallet](https://purrkey.app/wallet). Processing fees are shown before checkout.

## Connect

- [Agent Skill](https://purrkey.app/SKILL.md): the skill an agent loads to install the CLI and use Purrkey safely.
- [Skill quickstart](https://purrkey.app/docs/markdown/quickstart/skill): set Purrkey up as a skill in an agent that runs the CLI.
- [MCP quickstart](https://purrkey.app/docs/markdown/quickstart/mcp): connect the remote MCP server at https://api.purrkey.app/mcp (Streamable HTTP).
- [CLI quickstart](https://purrkey.app/docs/markdown/quickstart/cli): install the CLI, connect an API key and find your first tool.
- [API quickstart](https://purrkey.app/docs/markdown/quickstart/api): call the HTTP API directly.

## Documentation

- [How Purrkey works](https://purrkey.app/docs/markdown/how-it-works): the discover, inspect, run and retrieve flow end to end.
- [Pricing and spending limits](https://purrkey.app/docs/markdown/guides/billing): pricing units, caps, held funds and top-ups.
- [Runs, retries and cancellation](https://purrkey.app/docs/markdown/guides/runs): recover interrupted calls without paying twice.
- [API reference](https://purrkey.app/docs/markdown/api/overview): every HTTP endpoint, parameter and response.
- [CLI reference](https://purrkey.app/docs/markdown/cli/overview): every CLI command and flag.
- [OpenAPI](https://purrkey.app/docs/openapi.yaml): the machine-readable API contract.
- [Docs index for LLMs](https://purrkey.app/docs/llms.txt): Markdown index of the full documentation.

## Platforms

- [Douyin](https://purrkey.app/tools/douyin): Explore videos, creators, livestreams and commerce on Douyin (308 endpoints)
- [TikTok](https://purrkey.app/tools/tiktok): Explore videos, creators, trends, ads and shopping on TikTok (187 endpoints)
- [Instagram](https://purrkey.app/tools/instagram): Explore profiles, posts, reels and comments on Instagram (87 endpoints)
- [Weibo](https://purrkey.app/tools/weibo): Search posts, profiles, comments and trending topics on Weibo (56 endpoints)
- [Xiaohongshu](https://purrkey.app/tools/xiaohongshu): Search notes, creators, products and trends on Xiaohongshu (49 endpoints)
- [YouTube](https://purrkey.app/tools/youtube): Search videos, channels, playlists and comments on YouTube (49 endpoints)
- [Bilibili](https://purrkey.app/tools/bilibili): Explore videos, channels, comments and rankings on Bilibili (42 endpoints)
- [Zhihu](https://purrkey.app/tools/zhihu): Explore questions, answers, articles and profiles on Zhihu (41 endpoints)
- [Kuaishou](https://purrkey.app/tools/kuaishou): Find short videos, creators and livestream content on Kuaishou (38 endpoints)
- [LinkedIn](https://purrkey.app/tools/linkedin): Explore professional profiles, companies and posts on LinkedIn (36 endpoints)
- [Reddit](https://purrkey.app/tools/reddit): Explore communities, posts, comments and profiles on Reddit (35 endpoints)
- [Facebook](https://purrkey.app/tools/facebook): Find public posts, marketplace listings and ads on Facebook (24 endpoints)
- [Pipixia](https://purrkey.app/tools/pipixia): Browse short videos, posts and community content on Pipixia (17 endpoints)
- [Lemon8](https://purrkey.app/tools/lemon8): Browse lifestyle posts and creator profiles on Lemon8 (16 endpoints)
- [Threads](https://purrkey.app/tools/threads): Explore posts, replies and profiles on Threads (16 endpoints)
- [X (Twitter)](https://purrkey.app/tools/twitter): Read posts, threads and community discussions on X (16 endpoints)
- [Context.dev](https://purrkey.app/tools/contextdev): Research the web, parse documents and find people, companies and brands (13 endpoints)
- [WeChat Channels](https://purrkey.app/tools/wechat_channels): Explore videos and creator content on WeChat Channels (12 endpoints)
- [WeChat Official Accounts](https://purrkey.app/tools/wechat_mp): Explore articles and official account content on WeChat (11 endpoints)
- [Google Search](https://purrkey.app/tools/google_search): Search web results, news, images, patents and scholarly articles (9 endpoints)
- [People data](https://purrkey.app/tools/people_data): Look up professional contacts and verify email addresses (9 endpoints)
- [GitHub](https://purrkey.app/tools/github): Explore repositories, contributors, issues and discussions (8 endpoints)
- [Telegram](https://purrkey.app/tools/telegram): Browse public channels, messages and community content on Telegram (7 endpoints)
- [Toutiao](https://purrkey.app/tools/toutiao): Explore news, articles and creator content on Toutiao (7 endpoints)
- [Xigua](https://purrkey.app/tools/xigua): Browse videos, creators and channel content on Xigua (7 endpoints)
- [Firecrawl](https://purrkey.app/tools/firecrawl): Scrape pages, discover site URLs, search, crawl and extract structured data (6 endpoints)
- [eBay](https://purrkey.app/tools/ebay): Find eBay listings, item details and completed sales (5 endpoints)
- [Google Maps](https://purrkey.app/tools/google_maps): Find nearby businesses, place details and visitor reviews (5 endpoints)
- [Amazon](https://purrkey.app/tools/amazon): Find Amazon products, compare listings and read customer reviews (4 endpoints)
- [Google Ads](https://purrkey.app/tools/google_ads): Explore advertisers, campaigns and individual ad creatives (4 endpoints)
- [TikTok Shop](https://purrkey.app/tools/tiktok_shop): Find shop products and read buyer reviews (4 endpoints)
- [TinyFish](https://purrkey.app/tools/tinyfish): Search the web, news and research papers and extract content from public URLs (4 endpoints)
- [Company data](https://purrkey.app/tools/company_data): Search for companies and enrich business profiles (2 endpoints)
- [Google Play](https://purrkey.app/tools/google_play): Find Android apps and read their user reviews (2 endpoints)
- [Hacker News](https://purrkey.app/tools/hackernews): Find Hacker News stories and read their discussions (2 endpoints)
- [Similarweb](https://purrkey.app/tools/similarweb): Research website traffic and find related sites (2 endpoints)
- [Web extraction](https://purrkey.app/tools/web_extraction): Discover pages on a website and extract their content (2 endpoints)
- [WeChat Search](https://purrkey.app/tools/wechat_search): Search public WeChat content and accounts (2 endpoints)
- [Zillow](https://purrkey.app/tools/zillow): Find homes and inspect individual property listings (2 endpoints)
- [Airbnb](https://purrkey.app/tools/airbnb): Find vacation rentals by destination, travel dates and party size (1 endpoint)
- [Alibaba.com](https://purrkey.app/tools/alibaba): Explore Alibaba.com product offers and suppliers (1 endpoint)
- [App Store](https://purrkey.app/tools/appstore): Read customer reviews of iOS apps (1 endpoint)
- [Booking.com](https://purrkey.app/tools/booking): Look up accommodation by destination and dates (1 endpoint)
- [Capterra](https://purrkey.app/tools/capterra): Research software products through Capterra reviews (1 endpoint)
- [ChatGPT](https://purrkey.app/tools/chatgpt): Research questions with ChatGPT search (1 endpoint)
- [G2](https://purrkey.app/tools/g2): Read software product reviews from G2 (1 endpoint)
- [Glassdoor](https://purrkey.app/tools/glassdoor): Search Glassdoor job openings for a role and location (1 endpoint)
- [Google Shopping](https://purrkey.app/tools/google_shopping): Find product offers on Google Shopping (1 endpoint)
- [Indeed](https://purrkey.app/tools/indeed): Find job postings by role and location on Indeed (1 endpoint)
- [Perplexity](https://purrkey.app/tools/perplexity): Find answers and source links with Perplexity search (1 endpoint)
- [Pexels](https://purrkey.app/tools/pexels): Find stock photos on Pexels by topic (1 endpoint)
- [Pinterest](https://purrkey.app/tools/pinterest): Search Pinterest for pins and visual ideas (1 endpoint)
- [Realtor.com](https://purrkey.app/tools/realtor): Search for properties by location on Realtor.com (1 endpoint)
- [SEC EDGAR](https://purrkey.app/tools/sec): Find company filings in the SEC EDGAR archive (1 endpoint)
- [Substack](https://purrkey.app/tools/substack): Read posts from a Substack publication (1 endpoint)
- [Tripadvisor](https://purrkey.app/tools/tripadvisor): Read traveler reviews of places on Tripadvisor (1 endpoint)
- [Trustpilot](https://purrkey.app/tools/trustpilot): Read customer reviews of businesses on Trustpilot (1 endpoint)
- [Truth Social](https://purrkey.app/tools/truthsocial): Read recent posts from a Truth Social account (1 endpoint)
- [Upwork](https://purrkey.app/tools/upwork): Find freelance projects listed on Upwork (1 endpoint)
- [Walmart](https://purrkey.app/tools/walmart): Compare Walmart product listings from a search page (1 endpoint)
- [Yahoo Finance](https://purrkey.app/tools/yahoo_finance): Look up market quotes by ticker symbol (1 endpoint)

## Product

- [Home](https://purrkey.app/): what Purrkey is, FAQ and ways to connect.
- [Tools catalog](https://purrkey.app/tools): every platform and endpoint with its published price.
- [Blog](https://purrkey.app/blog): guides with agent prompts, tool workflows and how to read the results.
- [About](https://purrkey.app/about): who Purrkey is for and how it works.
- [API keys](https://purrkey.app/keys): create and revoke keys after signing in.
- [Sitemap](https://purrkey.app/sitemap.xml): every crawlable page.

## Community and Support

- [X / Twitter](https://x.com/usepurrkey): announcements and product news (@usepurrkey).
- [Support](mailto:support@purrkey.app): email the team directly.