findcheap
The Findcheap API in Python: where the product on a page is sold for less. Standard library only, Python 3.9+.
pip install findcheap
export FINDCHEAP_API_KEY=fc_live_... # from https://findcheap.ai/signin?next=/dashboard/keys
from findcheap import Findcheap, FindcheapApiError
fc = Findcheap() # reads FINDCHEAP_API_KEY; or Findcheap(api_key="fc_live_...")
answer = fc.search("https://www.jlab.com/products/jbuds-lux-anc-headphones", max_results=3)
print(answer["product"]["title"], "read in", answer["search"]["market"])
for card in answer["same_product"]:
print(card["price"], card["currency"], card["retailer"], card["url"] or card["resolve_id"])
page = fc.extract("https://www.jlab.com/products/jbuds-lux-anc-headphones")
if page["is_product_page"]:
print(page["title"], page["price"], page["currency"])
link = fc.resolve(answer["similar_products"][0]["resolve_id"]) # for a card whose url is None
Every answer opens with request_id and closes with credits_used. A failed call raises FindcheapApiError with .status, .type, .message, .credits_used, .request_id and .retry_after (seconds, on a 429); a call that never reached the API raises FindcheapConnectionError. Both subclass FindcheapError.
Timeouts sit above the API's own ceilings (a search answers within 90 seconds, a read within 30): 100, 40 and 20 seconds for search, extract and resolve, or one timeout= for all three.
The reference, with every field: https://findcheap.ai/developers/docs.md.
Metadata
Release files for findcheap 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 |
|---|---|---|---|---|
| findcheap-0.1.0.tar.gz | 7.7 kB | Without provenance | Details for findcheap-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| findcheap-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for findcheap-0.1.0-py3-none-any.whl |
Total release size: 14.0 kB
Release files / findcheap-0.1.0.tar.gz
| Download URL | findcheap-0.1.0.tar.gz |
|---|---|
| Size | 7.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
746241f7f3255db1b4b69973cd38409ea0cdae91e68678fa897c26e302765d74
|
|
BLAKE2b-256 checksum How to use checksums |
e7dbecef87396781a55340ab4f744350404054b2eeb88716af626a9557604945
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / findcheap-0.1.0-py3-none-any.whl
| Download URL | findcheap-0.1.0-py3-none-any.whl |
|---|---|
| Size | 6.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f6f01cbaaa34b6fbf53f8e84fd82f10812280c22f3b38de17d676683ca322d96
|
|
BLAKE2b-256 checksum How to use checksums |
b782f08cd8c553c44db2bb219c03687548390224b35ef0516f4cebda0dd9639e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Security for findcheap 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.