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.1.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.1-py3-none-any.whl (205.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: getanyapi-0.9.1.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.1.tar.gz
Algorithm Hash digest
SHA256 66b7b44616180abbba4c3a77fd43ded7a2660eb9ba1c41589fc5092ab7a8df6b
MD5 493ceaf64236f9bac2b53ce7bb280be9
BLAKE2b-256 8238166638d113afd3dfb71596ad4a2317fa58d594701ad86d54ab9aa9a1b55b

See more details on using hashes here.

Provenance

The following attestation bundles were made for getanyapi-0.9.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: getanyapi-0.9.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 d153af04925e8227a72dab8628189a6a2f0eb29e185caef095a90b347949982d
MD5 af018c87aef1ee4c9951b6eb9370c168
BLAKE2b-256 871020e773c168a2262bc8425d706936a9a4ae998394dea31c7a66cf4d135084

See more details on using hashes here.

Provenance

The following attestation bundles were made for getanyapi-0.9.1-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

0.9.2

2 files

This release

0.9.1 This release

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