# Pramaan > Provider-neutral capabilities behind one API: search, enrichment, social data, email, payments and more. ## Documentation ### Get started - [Pramaan](https://docs.pramaan.dev/index.md): Provider-neutral capabilities behind one API. - [Quickstart](https://docs.pramaan.dev/quickstart.md): From an API key to your first capability call in three commands. ### Guides - [Jobs](https://docs.pramaan.dev/guides/jobs.md): Run long capabilities asynchronously and wait for the result. - [Prices and limits](https://docs.pramaan.dev/guides/pricing.md): See what a request will cost before it runs, cap its price, and ask for a second opinion. - [Files](https://docs.pramaan.dev/guides/files.md): Upload a file to use as input, and download the files capabilities make. - [Connections](https://docs.pramaan.dev/guides/connections.md): Run email, payments, auth, database and deploy capabilities on your own accounts, and connect social accounts through Pramaan. - [Enterprise sign-in](https://docs.pramaan.dev/guides/enterprise-sign-in.md): Let a customer's staff sign in through their company's own identity provider. - [Use your own provider key](https://docs.pramaan.dev/guides/own-keys.md): Run calls to a service on your own account with it: Pramaan charges nothing for them. - [Numbers and US registration](https://docs.pramaan.dev/guides/numbers.md): Phone numbers for texting are provisioned for you and rented by the month. Texting US numbers needs a one-time business registration. - [References](https://docs.pramaan.dev/guides/references.md): Act on something an earlier call created: send an email, then check its status. - [Webhooks](https://docs.pramaan.dev/guides/webhooks.md): Receive signed events when jobs finish and connected accounts change. - [Voice tools on your own endpoint](https://docs.pramaan.dev/guides/voice-tools.md): Let a voice agent call your HTTPS endpoint in the middle of a call, with a signed request. - [Errors](https://docs.pramaan.dev/guides/errors.md): Error codes, HTTP statuses and what to do about each. - [Idempotency](https://docs.pramaan.dev/guides/idempotency.md): Retry safely: the same Idempotency-Key never runs a call twice. - [Streaming](https://docs.pramaan.dev/guides/streaming.md): Show a chat reply as it is generated. - [Approvals](https://docs.pramaan.dev/guides/approvals.md): Which capabilities need a person's yes before they run, and how agents ask for it. ### Tools - [TypeScript SDK](https://docs.pramaan.dev/tools/sdk.md): Typed calls for every capability, jobs, retries and webhook verification. - [MCP server](https://docs.pramaan.dev/tools/mcp.md): Give an AI agent every capability through the Model Context Protocol. - [Superpowers (3574 pages)](https://docs.pramaan.dev/_llms/superpowers.txt): Documentation for Superpowers. - [Missions (876 pages)](https://docs.pramaan.dev/_llms/missions.txt): Documentation for Missions. ## Platform API ### platform - [Start a direct file upload (link valid 15 minutes)](https://docs.pramaan.dev/platform/platform/start-a-direct-file-upload-link-valid-15-minutes.md) - [Check an uploaded file and make it ready](https://docs.pramaan.dev/platform/platform/check-an-uploaded-file-and-make-it-ready.md) - [List your files, newest first](https://docs.pramaan.dev/platform/platform/list-your-files-newest-first.md) - [Upload a file to pass to a capability as `fileId`](https://docs.pramaan.dev/platform/platform/upload-a-file-to-pass-to-a-capability-as-`fileid`.md): Send the file as the request body, with its media type in `Content-Type`. - [One file's facts and a fresh link](https://docs.pramaan.dev/platform/platform/one-files-facts-and-a-fresh-link.md) - [Delete a file now; its links stop working at once](https://docs.pramaan.dev/platform/platform/delete-a-file-now;-its-links-stop-working-at-once.md) - [List capabilities](https://docs.pramaan.dev/platform/platform/list-capabilities.md) - [Describe one capability, with its request and result JSON Schema](https://docs.pramaan.dev/platform/platform/describe-one-capability-with-its-request-and-result-json-schema.md) - [What a request would cost at most, without running it](https://docs.pramaan.dev/platform/platform/what-a-request-would-cost-at-most-without-running-it.md): Send the same body (and the same Pramaan-Max-Price-Micro and Pramaan-Second-Opinion headers) you would send to the capability. Nothing runs, nothing is charged or set aside, and no Idempotency-Key is used. price_typical_micro is a cached cross-caller median, not the hold. Bounds follow the validated… - [Job status: running, done (with result) or failed (with error)](https://docs.pramaan.dev/platform/platform/job-status:-running-done-with-result-or-failed-with-error.md) - [Cancel a running job](https://docs.pramaan.dev/platform/platform/cancel-a-running-job.md): A job you cancel is charged for the work already done, never more than the estimate set aside when it started. A job that fails or times out is free. - [Calls and spend per capability per day](https://docs.pramaan.dev/platform/platform/calls-and-spend-per-capability-per-day.md) - [Credit balance, credit set aside for running requests, and today's spend](https://docs.pramaan.dev/platform/platform/credit-balance-credit-set-aside-for-running-requests-and-todays-spend.md) - [Workspace addendum acceptances](https://docs.pramaan.dev/platform/platform/workspace-addendum-acceptances.md) - [Accept the current background-checks addendum](https://docs.pramaan.dev/platform/platform/accept-the-current-background-checks-addendum.md): Requires an owner or admin acting key. An organisation key must send Pramaan-Member. Repeated acceptance preserves the original member and date. Wrong versions are refused with the current version in the error message. - [The people in your organisation, with their roles](https://docs.pramaan.dev/platform/platform/the-people-in-your-organisation-with-their-roles.md): A client that acts for people (a chat app) maps its users to these members. - [Your connected accounts: the ids routing rules and Pramaan-Account name](https://docs.pramaan.dev/platform/platform/your-connected-accounts:-the-ids-routing-rules-and-pramaan-account-name.md) - [Your routing rules for this environment](https://docs.pramaan.dev/platform/platform/your-routing-rules-for-this-environment.md) - [Replace your routing rules](https://docs.pramaan.dev/platform/platform/replace-your-routing-rules.md): First match wins, top to bottom. `only` lets nothing else run; `prefer` tries these accounts first, primary then fallbacks. Rules never move a follow-up off the account that made what it acts on. Send If-Match with the version you read (0 for the first save); a newer save refuses this one with `conf… - [Close your workspace](https://docs.pramaan.dev/platform/platform/close-your-workspace.md): Owner only. Confirm the exact workspace name. Revokes keys, releases rentals and forfeits remaining credit. With releases disabled, returns a dry run without changes. - [Your organisation and its display name](https://docs.pramaan.dev/platform/platform/your-organisation-and-its-display-name.md): The organisation of the key that asks. The display name is what a person outside the platform is shown as who is contacting them (a candidate's invitation, for example). Until you set one, `name` is null and a neutral label is shown instead. - [Set your organisation's display name](https://docs.pramaan.dev/platform/platform/set-your-organisations-display-name.md): Only an owner or an admin may set it: a call acting as a member or a viewer is refused with 403 `forbidden`. A key that acts as no member acts as the organisation and may. - [Move an end user off the account a sticky rule bound them to](https://docs.pramaan.dev/platform/platform/move-an-end-user-off-the-account-a-sticky-rule-bound-them-to.md) ### outcomes - [List outcomes: a fixed sequence of capability steps under one business name](https://docs.pramaan.dev/platform/outcomes/list-outcomes:-a-fixed-sequence-of-capability-steps-under-one-business-name.md) - [Describe one outcome: its schemas and the capability steps it may run](https://docs.pramaan.dev/platform/outcomes/describe-one-outcome:-its-schemas-and-the-capability-steps-it-may-run.md) - [The plan for one input, without running it](https://docs.pramaan.dev/platform/outcomes/the-plan-for-one-input-without-running-it.md): Send the body you would send to the run. Nothing runs, nothing is charged or set aside. Show a person the steps and your input, then send `plan` back in Pramaan-Plan when you run. ## OpenAPI Specs - [data](/specs/superpowers/data.json) - [social-media](/specs/superpowers/social-media.json) - [ai-search-and-seo](/specs/superpowers/ai-search-and-seo.json) - [advertising](/specs/superpowers/advertising.json) - [news](/specs/superpowers/news.json) - [research](/specs/superpowers/research.json) - [legal](/specs/superpowers/legal.json) - [web-tools](/specs/superpowers/web-tools.json) - [e-commerce](/specs/superpowers/e-commerce.json) - [travel-and-places](/specs/superpowers/travel-and-places.json) - [finance](/specs/superpowers/finance.json) - [crypto-and-defi](/specs/superpowers/crypto-and-defi.json) - [gen-ai](/specs/superpowers/gen-ai.json) - [email-and-calendar](/specs/superpowers/email-and-calendar.json) - [phone-and-messaging](/specs/superpowers/phone-and-messaging.json) - [hiring-and-assessments](/specs/superpowers/hiring-and-assessments.json) - [identity-and-security](/specs/superpowers/identity-and-security.json) - [developer-tools](/specs/superpowers/developer-tools.json) - [other](/specs/superpowers/other.json) - [data](/specs/missions/data.json) - [social-media](/specs/missions/social-media.json) - [ai-search-and-seo](/specs/missions/ai-search-and-seo.json) - [advertising](/specs/missions/advertising.json) - [news](/specs/missions/news.json) - [research](/specs/missions/research.json) - [legal](/specs/missions/legal.json) - [web-tools](/specs/missions/web-tools.json) - [e-commerce](/specs/missions/e-commerce.json) - [travel-and-places](/specs/missions/travel-and-places.json) - [finance](/specs/missions/finance.json) - [crypto-and-defi](/specs/missions/crypto-and-defi.json) - [gen-ai](/specs/missions/gen-ai.json) - [email-and-calendar](/specs/missions/email-and-calendar.json) - [phone-and-messaging](/specs/missions/phone-and-messaging.json) - [hiring-and-assessments](/specs/missions/hiring-and-assessments.json) - [identity-and-security](/specs/missions/identity-and-security.json) - [developer-tools](/specs/missions/developer-tools.json) - [platform](/specs/platform.json) - [openapi](/openapi.json) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [Superpowers (3574 pages)](https://docs.pramaan.dev/_llms/superpowers.txt): Documentation for Superpowers. - [Superpowers / Data (305 pages)](https://docs.pramaan.dev/_llms/superpowers/data.txt): Companies, people and contacts: research, lead lists, work emails and company signals. - [Superpowers / Social media (565 pages)](https://docs.pramaan.dev/_llms/superpowers/social-media.txt): Posts, profiles, comments and trends on every network, and posting from your accounts. - [Superpowers / Social media / Social posting (30 pages)](https://docs.pramaan.dev/_llms/superpowers/social-media/social-posting.txt): Documentation for Superpowers / Social media / Social posting. - [Superpowers / Social media / Connect social accounts (33 pages)](https://docs.pramaan.dev/_llms/superpowers/social-media/connect-social-accounts.txt): Documentation for Superpowers / Social media / Connect social accounts. - [Superpowers / Social media / TikTok (48 pages)](https://docs.pramaan.dev/_llms/superpowers/social-media/tik-tok.txt): Documentation for Superpowers / Social media / TikTok. - [Superpowers / AI search and SEO (185 pages)](https://docs.pramaan.dev/_llms/superpowers/ai-search-and-seo.txt): Rankings, keywords, backlinks, and how AI answer engines see your brand. - [Superpowers / Advertising (96 pages)](https://docs.pramaan.dev/_llms/superpowers/advertising.txt): Your ad accounts, competitors' ads, audiences and creator deals. - [Superpowers / Web tools (138 pages)](https://docs.pramaan.dev/_llms/superpowers/web-tools.txt): Read, scrape and watch any website, or drive a real browser. - [Superpowers / E-commerce (134 pages)](https://docs.pramaan.dev/_llms/superpowers/e-commerce.txt): Products, prices, reviews and marketplaces, through to shipping and tracking. - [Superpowers / Travel & places (189 pages)](https://docs.pramaan.dev/_llms/superpowers/travel-and-places.txt): Maps, places, addresses, property, routes, weather and travel. - [Superpowers / Finance (356 pages)](https://docs.pramaan.dev/_llms/superpowers/finance.txt): Take payments, run billing, move money, handle tax and read the markets. - [Superpowers / Crypto & DeFi (142 pages)](https://docs.pramaan.dev/_llms/superpowers/crypto-and-de-fi.txt): Tokens, wallets, chains, DeFi yields and on-chain data. - [Superpowers / Gen AI (309 pages)](https://docs.pramaan.dev/_llms/superpowers/gen-ai.txt): Make images, video, voice and music, and call language models. - [Superpowers / Email & calendar (109 pages)](https://docs.pramaan.dev/_llms/superpowers/email-and-calendar.txt): Send and read email, and book, run and sum up meetings. - [Superpowers / Phone & messaging (283 pages)](https://docs.pramaan.dev/_llms/superpowers/phone-and-messaging.txt): Calls, AI phone agents, SMS, WhatsApp, chat and one-time codes. - [Superpowers / Identity & security (158 pages)](https://docs.pramaan.dev/_llms/superpowers/identity-and-security.txt): Verify people, stop fraud, run sign-in and check for threats. - [Superpowers / Developer tools (356 pages)](https://docs.pramaan.dev/_llms/superpowers/developer-tools.txt): Code, deploys, storage, databases, workflows and documents. - [Missions (876 pages)](https://docs.pramaan.dev/_llms/missions.txt): Documentation for Missions. - [Missions / Data (98 pages)](https://docs.pramaan.dev/_llms/missions/data.txt): Companies, people and contacts: research, lead lists, work emails and company signals. - [Missions / Social media (81 pages)](https://docs.pramaan.dev/_llms/missions/social-media.txt): Posts, profiles, comments and trends on every network, and posting from your accounts. - [Missions / AI search and SEO (63 pages)](https://docs.pramaan.dev/_llms/missions/ai-search-and-seo.txt): Rankings, keywords, backlinks, and how AI answer engines see your brand. - [Missions / Finance (104 pages)](https://docs.pramaan.dev/_llms/missions/finance.txt): Take payments, run billing, move money, handle tax and read the markets. - [Missions / Gen AI (80 pages)](https://docs.pramaan.dev/_llms/missions/gen-ai.txt): Make images, video, voice and music, and call language models. - [Missions / Developer tools (65 pages)](https://docs.pramaan.dev/_llms/missions/developer-tools.txt): Code, deploys, storage, databases, workflows and documents. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.