# upAPI

> An API marketplace and gateway. One API key and one pooled quota call every
> operation in the catalog — social media, search, maps, finance, developer
> tools, file and browser operations — over a single uniform HTTP contract, so
> integrating the tenth API costs no more than the first.

## Calling an API

Every operation is one POST, authenticated with one header:

    POST https://api.upapi.io/{slug}
    X-Api-Key: <your key>
    Content-Type: application/json

    { ...operation input... }

- `{slug}` is the operation id from the catalog, e.g. `ip-geolocation.get`.
- The request body is the operation's input schema; the response body is its
  output schema. Both are published per operation (see Catalog below).
- Errors share one envelope — `{"error":{"code":"...","message":"..."}}` — with
  the HTTP status matching the code. `RATE_LIMITED` is the per-minute burst
  gate and is safe to retry after `Retry-After`; `QUOTA_EXCEEDED` is the
  monthly plan quota and is not.
- Usage is metered in weighted units: operations cost what they cost to run, so
  a cheap lookup and a browser-backed screenshot do not bill the same.

## Documentation

- [Docs](https://upapi.io/docs): the platform guide — authentication, the
  universal request contract, errors, quotas, the SDK and the MCP server.
- [Full docs corpus](https://upapi.io/docs/llms-full.txt): every documentation
  page concatenated as Markdown, for loading into context in one fetch.
- [Docs index](https://upapi.io/docs/llms.txt): the page tree alone, if you want
  to fetch pages selectively. Any docs page also has a `.md` twin at its own
  URL plus `.md`.

## Catalog

- [Marketplace](https://upapi.io/marketplace): browse and search every public
  operation, with its schema and copy-paste snippets.
- [All APIs by category](https://upapi.io/apis): the crawlable directory.
- [Catalog JSON](https://app.upapi.io/api/catalog): every public operation with
  its input and output schema, machine-readable.
- [OpenAPI](https://app.upapi.io/api/openapi.json): the same surface as an
  OpenAPI document, including each operation's unit weight. `/openapi.json`
  on this host redirects there.
- [API catalog](https://upapi.io/.well-known/api-catalog): RFC 9727 linkset of
  the gateway, the MCP server and every public operation.
- [MCP server card](https://upapi.io/.well-known/mcp/server-card.json): the
  hosted MCP server's name, version, endpoint and OAuth metadata.
- Markdown: the home page, `/pricing` and every page under `/apis` and `/tools` have a
  Markdown twin at their own URL plus `.md` (the home page's is
  `/index.md`), also served to a request that sends `Accept: text/markdown`.

## Popular APIs

Task-shaped pages: what the operation returns, a request and response example,
its unit price and an FAQ.

- [Google Maps Scraper API](https://upapi.io/apis/maps/google-maps-scraper): Search Google Maps by text or coordinates, look up one place, or read its reviews — JSON endpoints behind one API key, no browser and no CAPTCHA-solving.
- [Instagram User ID & Info API](https://upapi.io/apis/social-media/instagram-profile-scraper): Instagram API to get a user ID from a username, get user info by username or ID, and get posts by user — no login, no session cookie. One upAPI key.
- [Instagram Post Scraper API](https://upapi.io/apis/social-media/instagram-post-scraper): Read a user’s recent posts, one post’s metadata, its commenters, or a location’s post feed on Instagram — public-read operations, no login required.
- [TikTok Scraper API](https://upapi.io/apis/social-media/tiktok-scraper-api): TikTok operations behind one key: profiles, video metadata, comments and replies, comment-thread user discovery and account-health checks — no login.
- [LinkedIn Jobs Scraper API](https://upapi.io/apis/social-media/linkedin-jobs-scraper): Search LinkedIn job postings by keyword and location, then fetch one posting’s full detail — over LinkedIn’s public guest surface, no login.
- [Upwork Jobs Scraper API](https://upapi.io/apis/social-media/upwork-jobs-scraper): Search Upwork job postings by keyword, then fetch one posting’s full detail including client stats — over Upwork’s public visitor surface.
- [Screenshot API](https://upapi.io/apis/tools/screenshot-api): Screenshot API: capture any public URL as a PNG or JPEG in headless Chromium — full page, custom viewport, ad blocking — as JSON behind one upAPI key.
- [HTML to PDF API](https://upapi.io/apis/tools/html-to-pdf-api): HTML to PDF API: render a public URL or a raw HTML string to a print-quality PDF in headless Chromium — paper size, margins, page ranges. One upAPI key.
- [URL to Markdown API](https://upapi.io/apis/tools/url-to-markdown-api): URL to Markdown API: fetch a web page and get clean, LLM-ready Markdown with title, byline and links — article extraction or full page. One upAPI key.
- [Open Graph Scraper API](https://upapi.io/apis/seo-tools/open-graph-scraper-api): Open Graph scraper API: read any URL’s og:title, og:image, Twitter card, canonical and favicon as JSON for link previews and SEO audits. One upAPI key.
- [Crypto Price API](https://upapi.io/apis/finance/crypto-price-api): Crypto price API: current price, market cap and 24-hour change for any CoinGecko coin id, quoted in USD, EUR, BTC or other currencies. JSON, one upAPI key.
- [Google Autocomplete API](https://upapi.io/apis/search/google-autocomplete-api): Google autocomplete and suggest scraper API: suggestions for any query by language and country, with a–z expansion for long-tail keywords. One upAPI key.
- [Sitemap Parser API](https://upapi.io/apis/seo-tools/sitemap-parser-api): Sitemap parser API: fetch an XML sitemap, index or plain-text URL list and get each URL with lastmod, changefreq and priority as JSON. One upAPI key.
- [LinkedIn Profile Search API](https://upapi.io/apis/search/linkedin-profile-search-api): LinkedIn search API: find LinkedIn profiles by job title and location as JSON, with name, headline and profile URL. No LinkedIn login. One upAPI key.

## Free tools

No account and no key: each IP address gets 30 runs a minute and 300 a day across all of these tools. Index as JSON: https://app.upapi.io/api/tools ·
OpenAPI: https://app.upapi.io/api/tools/openapi.json · hub: https://upapi.io/tools

- [Open Graph checker](https://upapi.io/tools/open-graph-checker): Free Open Graph checker: see the og:title, og:description, og:image, Twitter Card tags, canonical URL and favicon any page serves to link previews. No sign-up. No key: `GET https://app.upapi.io/api/tools/open-graph-checker?url=https%3A%2F%2Fgithub.com`
- [Sitemap URL extractor](https://upapi.io/apis/seo-tools/sitemap-parse): Free sitemap URL extractor: paste a sitemap.xml, sitemap index or plain-text URL list and get every URL with its lastmod, changefreq and priority. No sign-up. No key: `GET https://app.upapi.io/api/tools/sitemap-url-extractor?url=https%3A%2F%2Fupapi.io%2Fsitemap.xml`
- [Google Autocomplete explorer](https://upapi.io/apis/search/google-autocomplete): Free Google Autocomplete tool: type a seed keyword and get the suggestions Google shows for it, by language and country. Useful for keyword research. No sign-up. No key: `GET https://app.upapi.io/api/tools/google-autocomplete?query=api%20for`
- [Crypto price checker](https://upapi.io/apis/finance/crypto-price): Free crypto price checker: current price, market cap and 24-hour change for any CoinGecko-listed coin, in USD, EUR or any other currency. No sign-up. No key: `GET https://app.upapi.io/api/tools/crypto-price?coins=bitcoin%2Cethereum`
- [JSON formatter and validator](https://upapi.io/tools/json-formatter): Free JSON formatter and validator: pretty-print with 2 or 4 spaces or tabs, minify, sort keys, and see the exact line and column of a syntax error. Runs in your browser.
- [JWT decoder](https://upapi.io/tools/jwt-decoder): Free JWT decoder: paste a JSON Web Token to read its header and payload, with exp, iat and nbf shown as dates and whether it has expired. Runs in your browser.
- [HTTP status codes reference](https://upapi.io/tools/http-status-codes): Every HTTP status code in the IANA registry, from 100 Continue to 511 Network Authentication Required, with its reason phrase, its RFC and what it means.
- [DNS provider detector](https://dodomain.io/tools/provider-detector) (DoDomain): Which DNS host serves a domain, read from its authoritative nameservers, and whether one-click setup is available there.
- [DNS propagation checker](https://dodomain.io/tools/dns-lookup) (DoDomain): One record read from the authoritative nameservers and three public resolvers side by side.
- [SPF record checker](https://dodomain.io/tools/spf-checker) (DoDomain): Parses an SPF record, walks every include and redirect, and counts DNS lookups against the limit of ten.
- [Uptime / SLA calculator](https://getuptimely.com/tools/uptime-calculator) (Uptimely): How much downtime an availability target such as 99.9% or 99.99% allows.
- [SSL certificate checker](https://getuptimely.com/tools/ssl-certificate-checker) (Uptimely): Expiry date, days left, issuer, covered hostnames and chain trust for any public host.
- [Status badge builder](https://getuptimely.com/tools/status-badge) (Uptimely): An embeddable live status badge for a public status page.
- [ElevenLabs credit calculator](https://voicelabs.now/tools/elevenlabs-credit-calculator) (VoiceLabs): ElevenLabs credits converted to minutes of speech and transcription, plan by plan.
- [Browser text-to-speech tester](https://voicelabs.now/tools/browser-text-to-speech) (VoiceLabs): Hear a sample from every text-to-speech voice your browser has, and see which are remote.
- [Marketplace seller fees in Canada](https://joinmarka.com/en/fees) (Marka): What eBay, Etsy, Amazon.ca and Facebook Marketplace keep of a sale in Canada, side by side.
- [Online file converter](https://aishorty.com/file-converter) (Shorty): Audio, video, image and PDF conversions such as MP4 to MP3, HEIC to JPG and PDF to JPG, with no sign-up.
- [YouTube video summarizer](https://aishorty.com/youtube-video-summarizer) (Shorty): Timestamped key points from a YouTube video, with no login.

## Tooling

- `@upapi/sdk` on npm: a typed, zero-runtime-dependency client generated from
  the catalog.
- `@upapi/mcp` on npm: the operations as MCP tools, over stdio or the hosted
  endpoint at https://app.upapi.io/api/mcp. Setup per client is documented at
  https://upapi.io/docs/mcp-clients.

## Agent setup

- [Add to Claude](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=upAPI&connectorUrl=https%3A%2F%2Fapp.upapi.io%2Fapi%2Fmcp): one click for a human: opens Claude's Add custom connector dialog with the hosted upAPI MCP server (https://app.upapi.io/api/mcp) filled in; the user clicks Add and signs in, and the connector syncs to Claude Desktop and mobile.
- [prompt.md](https://upapi.io/docs/agent-setup/prompt.md): instructions an AI coding agent fetches and executes to set itself up for upAPI (MCP server, SDK, API key, verification).
- [Agent setup guides](https://upapi.io/docs/agent-setup): the same steps for Claude Code,
  Codex, Cursor, OpenCode and VS Code, written for a human.
- [FAQ](https://upapi.io/docs/faq): guests, key scope, quotas, hosted versus local MCP, what a
  failed call costs, and caching.

## Pricing

- [Pricing](https://upapi.io/pricing): the four plans, what 1,000 weighted units
  cost on each, what the free tier buys in concrete terms, and an FAQ.
- [Alternatives](https://upapi.io/alternatives): honest per-vendor comparisons
  against Apify, Bright Data, ScraperAPI, Serper, ApyHub, RapidAPI, ScrapingBee,
  Firecrawl and ScreenshotOne, each written from that vendor's own published
  pages and each stating where they win.
- [API marketplaces for AI agents (2026)](https://upapi.io/compare/api-marketplaces-for-ai-agents):
  RapidAPI, Apify, ApyHub, Zyla API Hub and upAPI on MCP support, one key,
  pricing model, free tier, who runs the APIs and agent-facing docs, each cell
  sourced and dated.

## Account

- [Dashboard](https://app.upapi.io): keys, usage, billing, and hosted functions.
- [Status](https://app.upapi.io/status): live platform status.
- [Support](https://app.upapi.io/support)
- [Terms](https://upapi.io/terms) · [Privacy](https://upapi.io/privacy)

## Frequently asked questions

### What is upAPI?

upAPI is an API marketplace where one API key and one request shape call every public API in the catalog, from search and social data to developer tools and finance. Each API runs on upAPI’s own workers, so there is one maintainer and one price list, and every call spends from a single pooled monthly quota.

### How do I call an API on upAPI?

Send a POST request with a JSON body to api.upapi.io, naming the API in the path and passing your key in the X-Api-Key header. The same request shape works for every API in the catalog, so there is no per-provider account, base URL or key. An official SDK, @upapi/sdk, is on npm, and every API page has a copy-ready snippet.

### How does upAPI billing work?

A call costs its operation’s weight in units: 1 for a plain read, up to 20 for the heaviest, such as a headless browser rendering a page. One monthly quota covers every public API, pooled across all keys in your organization. You only pay for calls we ran: a rejected request, a throttled call, a replayed retry and a cached response cost zero. When the quota runs out, calls return 429 instead of billing an overage.

### Is there a free tier or a free trial?

Both. The Free tier is 1,000 units a month, permanently, with no card. Each paid tier offers a 14-day trial that includes 10% of that tier’s monthly units, once per organization; a trial goes through checkout, so it needs a card. You can also explore the marketplace and run operations as a guest before you sign up.

### Can I use upAPI from an AI agent or an MCP client?

Yes. Operations are exposed as MCP tools. The hosted server signs you in over OAuth 2.1 with PKCE, so no key is written to a config file, and serves every public operation; the published @upapi/mcp stdio server runs on your own machine with your own key and catches up in its next release. Tool calls are metered on the same quota as an HTTP request.

### How is upAPI different from RapidAPI?

RapidAPI is a hub where independent providers list thousands of APIs, each with its own pricing plan. upAPI is one maintained catalog: every public operation runs on upAPI’s own workers and draws on one pooled quota, so you hold one key and get one bill. The trade-off is breadth. If the API you need is niche, look on RapidAPI first.

### Are proxies charged separately?

No. Datacenter and residential egress are included in the unit price of the operations that need them, so there is no bandwidth meter and no per-GB line. If you need the same exit IP across a chain of requests, you can supply your own per call.