getanyapi

Official typed Python SDK for AnyAPI: any API, one wallet, USD, no subscriptions. Reach hundreds of scraping and data APIs through one interface and one key; pay per request in real US dollars. httpx + pydantic v2, Python 3.10+, sync and async clients.

pip install getanyapi

Quickstart

from getanyapi import AnyAPI

client = AnyAPI()  # reads ANYAPI_API_KEY from the environment
res = client.reddit.search(query="mechanical keyboard")
if res.output.found:
    for post in res.output.data.posts:
        print(post.title, post.score)
print("charged", res.cost_usd, "USD")

Async:

from getanyapi import AsyncAnyAPI

async with AsyncAnyAPI() as client:
    res = await client.google.search(query="best coffee maker")

Inputs vs outputs (naming asymmetry)

Input keyword arguments mirror the wire API verbatim (camelCase where the API uses it), because they are sent as-is. Output models are Pythonic: attributes are snake_case with a wire alias (item.reviews_count reads the wire reviewsCount), and model_dump(by_alias=True) reproduces the wire shape. Open provider records round-trip unknown fields via .model_extra.

Not found vs error

A successful call always returns. For most SKUs the payload is wrapped in a found flag: res.output.found is False when the upstream had no matching entity (not an error). Use unwrap to get the data or raise ResultNotFoundError when empty:

from getanyapi import unwrap, ResultNotFoundError

res = client.amazon.reviews(product="B07FZ8S74R")
try:
    data = unwrap(res)  # the typed data payload, or raises
except ResultNotFoundError:
    ...  # empty result (found: False), not an HTTP failure

ResultNotFoundError subclasses NotFoundError, so except NotFoundError catches both an HTTP 404 and an empty result; catch ResultNotFoundError to handle only empty results. If a future committed schema uses a bare output, generated typing returns its data object directly rather than relying on a hard-coded SKU list.

Discovery

apis = client.catalog(category="search")
matches = client.search(query="web search", platform="google", limit=10)
api = client.describe(matches.results[0].slug)
print(api.pricing.from_offer, api.pricing.failover_max_usd, api.input_schema)

Sync and async clients expose the same category-only catalog, dedicated ranked search, and schema-bearing describe methods. Prices are nested USD flat/linear offers, lanes are anonymous, and provider is always "AnyAPI".

Pagination

Paginated SKUs expose an iter_* method that yields validated item models across pages and follows the cursor for you. Call .pages() on it to walk whole results (each has its own cost_usd).

for post in client.reddit.iter_search(query="coffee", options={"max_items": 100}):
    print(post.title)  # a validated model, not a dict

for page in client.reddit.iter_search(query="coffee").pages():
    print(page.cost_usd)

Request options (context-cost savers)

Pass options= to shape the response. These trim what comes back but do NOT change the price:

res = client.google.search(
    query="coffee",
    options={"fields": ["title", "link"], "max_items": 5, "summary": True},
)

options also carries per-call timeout and max_retries overrides.

Errors and retries

Class HTTP Meaning
BadRequestError 400 Input failed validation
AuthenticationError 401 Missing or invalid API key
InsufficientBalanceError 402 Wallet balance or per-key cap exceeded
NotFoundError 404 Slug or resource does not exist
ResultNotFoundError - unwrap on an empty found-data result
RateLimitedError 429 Too many requests (retried automatically)
UpstreamError 502 An upstream backend failed
ConnectionError 0 Network or transport failure (retried)
TimeoutError 0 Request exceeded its timeout (not retried)

All extend AnyAPIError (with .status and .request_id). Retries cover only 429 and network failures, with jittered exponential backoff honoring Retry-After. Default max_retries is 2 (up to 3 attempts); set it on the client (AnyAPI(max_retries=...)) or per request via options. Timeouts are never retried.

Agent signup

Bootstrap a key with no account (for autonomous agents):

from getanyapi import agent_signup, AnyAPI

result = agent_signup(label="my-agent")
client = AnyAPI(api_key=result.secret)

The key ships with a small starter balance and a per-key spend cap; a human funds it by claiming it at result.claim_url.

Docs

Full API reference and catalog: getanyapi.com/docs.

License

MIT

Project links

Data verified by PyPI on Jul 25, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.37.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for kevinwang-anyapi from gravatar.com kevinwang-anyapi

Credits

Author: AnyAPI

GitHub Statistics

Data verified by PyPI on Jul 25, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

dev

Tags

anyapi api getanyapi scraping sdk

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

getanyapi-0.9.2.tar.gz (154.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

getanyapi-0.9.2-py3-none-any.whl (205.1 kB view details)

Uploaded Python 3

File details

Details for the file getanyapi-0.9.2.tar.gz.

File metadata

  • Download URL: getanyapi-0.9.2.tar.gz
  • Upload date:
  • Size: 154.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for getanyapi-0.9.2.tar.gz
Algorithm Hash digest
SHA256 3e9a2f6bf2ebc54840d061a0f1a35b942dcbee60a05f8d2a235aecb66c7b3da7
MD5 6a2950644f6a810cdfd566a3ff63aaf4
BLAKE2b-256 b7e6678530365809383ab8d169c7973e7df3499346ef94e9529f1fe62ea35546

See more details on using hashes here.

Provenance

The following attestation bundles were made for getanyapi-0.9.2.tar.gz:

Publisher: release.yml on getanyapi-com/sdks

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file getanyapi-0.9.2-py3-none-any.whl.

File metadata

  • Download URL: getanyapi-0.9.2-py3-none-any.whl
  • Upload date:
  • Size: 205.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for getanyapi-0.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 030aaf621a601c76f017baa8d1f1744681ba114bc6a1b76bdf68735bca35af68
MD5 6cff44e89aa52fc27453c2a2c05554fc
BLAKE2b-256 b27295b327f674a38c16da472a515b833d7ee316ab63ead9c69037541b1af191

See more details on using hashes here.

Provenance

The following attestation bundles were made for getanyapi-0.9.2-py3-none-any.whl:

Publisher: release.yml on getanyapi-com/sdks

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.37.0

2 files

0.36.0

2 files

0.35.3

2 files

0.35.2

2 files

0.35.1

2 files

0.35.0

2 files

0.34.4

2 files

0.34.3

2 files

0.34.2

2 files

0.34.1

2 files

0.34.0

2 files

0.33.0

2 files

0.32.1

2 files

0.32.0

2 files

0.31.0

2 files

0.30.0

2 files

0.29.1

2 files

0.29.0

2 files

0.28.0

2 files

0.27.1

2 files

0.27.0

2 files

0.26.0

2 files

0.25.0

2 files

0.24.0

2 files

0.23.0

2 files

0.22.0

2 files

0.21.1

2 files

0.21.0

2 files

0.20.0

2 files

0.19.0

2 files

0.18.1

2 files

0.18.0

2 files

0.17.1

2 files

0.16.1

2 files

0.16.0

2 files

0.15.2

2 files

0.15.1

2 files

0.15.0

2 files

0.14.0

2 files

0.13.3

2 files

0.13.2

2 files

0.13.1

2 files

0.13.0

2 files

0.12.5

2 files

0.12.4

2 files

0.12.3

2 files

0.12.2

2 files

0.12.1

2 files

0.12.0

2 files

0.11.1

2 files

0.11.0

2 files

0.10.0

2 files

0.9.11

2 files

0.9.10

2 files

0.9.9

2 files

0.9.8

2 files

0.9.7

2 files

0.9.6

2 files

0.9.5

2 files

This release

0.9.2 This release

2 files

0.9.1

2 files

0.9.0

2 files

0.8.0

2 files

0.7.1

2 files

0.7.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page