Ateve Python SDK
Official typed client for POST /v1/search. Requires Python 3.11+.
Install
pip install ateve
Synchronous
from ateve import Ateve, ContentOptions, Topic
with Ateve() as client: # reads ATEVE_API_KEY
response = client.search(
query="quantum computing",
date_range="week",
topic=Topic.NEWS,
content=ContentOptions(summary=True, highlights=True),
)
print(response.results[0].title, response.usage.credits)
Asynchronous
from ateve import AsyncAteve
async with AsyncAteve() as client:
response = await client.search("quantum computing", limit=10)
Ateve owns and closes its default httpx.Client; AsyncAteve does the same
for its default httpx.AsyncClient. An injected http_client is borrowed and
never closed by the SDK. Reuse one Ateve client for its connection pool instead
of constructing one per request.
Each search call sends exactly one HTTP request. The SDK never retries,
backs off, or switches endpoints. This is intentional: a timeout/reset can
happen after the billable search already ran. ApiConnectionError exposes
request_may_have_been_sent; only DNS/connect/connect-timeout/pool-timeout
failures are classified as definitely not sent.
The built-in path defaults to a 60-second request timeout, 5-second connect
timeout, a 32 MiB response cap, and no redirects. Use
max_concurrent_requests for an optional fail-fast bulkhead.
Typed errors include AuthenticationError, PaymentRequiredError,
RateLimitError, InvalidRequestError, ServerError,
ApiConnectionError, ApiResponseError, and ConcurrencyLimitError.
RateLimitError preserves retry_after_seconds and limit_scope; retry
decisions remain caller-owned.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ateve-0.0.1.tar.gz.
File metadata
- Download URL: ateve-0.0.1.tar.gz
- Upload date:
- Size: 10.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
66ee71d06b2b7c2aa4ecca674a16471f2ca58c461b5175f48d81f02e7a6d0a5d
|
|
| MD5 |
8684fba716b75ec6547af552aa35e602
|
|
| BLAKE2b-256 |
e6e2a0ffed4cf5e3f66ea8ad2c52273daaec3cad98d20b9c43ebb3a50e8877f9
|
Provenance
The following attestation bundles were made for ateve-0.0.1.tar.gz:
Publisher:
release-python.yml on ateve-inc/ateve-sdks
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ateve-0.0.1.tar.gz -
Subject digest:
66ee71d06b2b7c2aa4ecca674a16471f2ca58c461b5175f48d81f02e7a6d0a5d - Sigstore transparency entry: 2299971112
- Sigstore integration time:
-
Permalink:
ateve-inc/ateve-sdks@91fab9a1169a4a854e7f48c2d3dbc4c1b41a79fd -
Branch / Tag:
refs/heads/main - Owner: https://github.com/ateve-inc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-python.yml@91fab9a1169a4a854e7f48c2d3dbc4c1b41a79fd -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file ateve-0.0.1-py3-none-any.whl.
File metadata
- Download URL: ateve-0.0.1-py3-none-any.whl
- Upload date:
- Size: 10.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
55951f2834274d274d3deb2bfe27b9cf984be3dabbdfb46e2e1f810ef9db813b
|
|
| MD5 |
b946e842887ff0368fb8d45079c1557e
|
|
| BLAKE2b-256 |
5249f6ff716ba217903ad3708b7a82670f2f0e269b75f98bdde828dc605024ed
|
Provenance
The following attestation bundles were made for ateve-0.0.1-py3-none-any.whl:
Publisher:
release-python.yml on ateve-inc/ateve-sdks
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ateve-0.0.1-py3-none-any.whl -
Subject digest:
55951f2834274d274d3deb2bfe27b9cf984be3dabbdfb46e2e1f810ef9db813b - Sigstore transparency entry: 2299971153
- Sigstore integration time:
-
Permalink:
ateve-inc/ateve-sdks@91fab9a1169a4a854e7f48c2d3dbc4c1b41a79fd -
Branch / Tag:
refs/heads/main - Owner: https://github.com/ateve-inc
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release-python.yml@91fab9a1169a4a854e7f48c2d3dbc4c1b41a79fd -
Trigger Event:
workflow_dispatch
-
Statement type:
