usecart
Python SDK for the Cart e-commerce intelligence API.
Zero dependencies. Python 3.9+.
Install
pip install usecart
Quick Start
from usecart import Cart
cart = Cart("cart_sk_...")
# Search stores
stores = cart.stores.search(keyword="fitness", platform="shopify", min_traffic=10000)
print(stores.data)
# [{"domain": "gymshark.com", "traffic": 4200000, ...}, ...]
# Get a single store
store = cart.stores.get("gymshark.com")
# Search products
products = cart.products.search(keyword="yoga mat", min_price=20)
# Get trending
trending = cart.trending()
# Check rate limits
print(cart.rate_limit)
# RateLimitInfo(remaining=99, limit=100)
Response Shape
Every method returns an ApiResponse with three attributes:
response = cart.stores.search(keyword="fitness")
response.data # list of dicts or single dict
response.meta # ApiResponseMeta(request_id, timestamp, page, total_pages, total_results)
response.usage # ApiResponseUsage(requests_today, limit)
Resources
| Resource | Methods |
|---|---|
cart.stores |
search(), get(), get_products(), get_ads(), get_traffic(), get_tech(), compare() |
cart.products |
search(), get(), trending() |
cart.ads |
search(), get() |
cart.suppliers |
search() |
cart.niches |
get() |
| top-level | cart.trending(), cart.account() |
Error Handling
from usecart import Cart, CartAuthError, CartRateLimitError, CartApiError
cart = Cart("cart_sk_...")
try:
stores = cart.stores.search(keyword="fitness")
except CartAuthError as e:
print(f"Auth failed: {e}")
except CartRateLimitError as e:
print(f"Rate limited. Retry after {e.retry_after}s")
except CartApiError as e:
print(f"API error {e.status}: {e.message}")
Links
Metadata
Release files for usecart 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| usecart-0.1.0.tar.gz | 7.0 kB | Without provenance | Details for usecart-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| usecart-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for usecart-0.1.0-py3-none-any.whl |
Total release size: 16.6 kB
Release files / usecart-0.1.0.tar.gz
| Download URL | usecart-0.1.0.tar.gz |
|---|---|
| Size | 7.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e8a2b45045b02a99b9df5cafe66f860fbc3fd2d2991c698f264fef7cd9c962d8
|
|
BLAKE2b-256 checksum How to use checksums |
1ce366812028220427a21ee86ddb17354a6ebf63709bf4f03cd6aee11c5f71d5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / usecart-0.1.0-py3-none-any.whl
| Download URL | usecart-0.1.0-py3-none-any.whl |
|---|---|
| Size | 9.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
bf25b701b5ce332e2477768675d0cfafca45b7892ba2bb9597192ca7907a06a0
|
|
BLAKE2b-256 checksum How to use checksums |
b5b9803e51c0d7293c5ff8501b66cf93524705abd0b8aa84655180248ad0413b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Security for usecart 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.