ScrapeBadger CLI
Command-line access to ScrapeBadger APIs, including Etsy, AliExpress, Target, ASOS, Best Buy, search engines, social media and general web scraping.
Install
pip install scrapebadger-cli
# or: uv tool install scrapebadger-cli
The installed command is scrapebadger. To run without installing:
uvx --from scrapebadger-cli scrapebadger --help
Quick Start
scrapebadger auth --api-key sb_live_...
scrapebadger twitter user elonmusk
scrapebadger twitter search "AI agents" --output table
scrapebadger vinted search "nike shoes" --market de
scrapebadger web scrape https://example.com --js
Vinted mobile data (0.14.0+)
scrapebadger vinted mobile-operations
scrapebadger vinted mobile sold-comparables --market fr --params '{"catalog_id":"1242","brand_id":"53","status_id":"2"}'
scrapebadger vinted search "nike" --sizes 206 --materials 43
The catalog lists 76 public read operations with parameter types and examples. Each mobile read costs 1 credit; discovery is free. Sold comparables are a Vinted-selected sample, not a complete sales history or guaranteed final sale prices.
Vinted image search
scrapebadger vinted search-by-image --image photo.jpg --market nl --price-to 50
scrapebadger vinted search-by-image --image-url https://example.com/photo.webp --brand-ids 53
Provide exactly one of --image, --image-url or --image-base64. JPEG, PNG and
WebP up to 5 MiB are supported. Returns active listings in visual ranking order;
10 credits per successful request. Filter with --catalog-ids, --brand-ids,
--status-ids, --color-ids, --size-ids, --material-ids and price bounds.
Resend the same image and --time from pagination when requesting --page 2.
Dedicated ecommerce APIs
scrapebadger etsy search "ceramic mug" --currency USD --country US
scrapebadger aliexpress search "keyboard"
scrapebadger target search "laptop" --zip-code 55403 --store-id 1375
scrapebadger asos search "shoes" --market uk
scrapebadger bestbuy search "laptop"
Run scrapebadger <api> --help to list product, review, store, availability and
reference commands for that API. Each command supports --help for its exact
parameters. Requests use your API key's existing permissions and credit balance.
1 maintainer
Metadata
1 maintainer
Release files for scrapebadger-cli 0.22.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 | |
|---|---|---|---|
| scrapebadger_cli-0.22.0.tar.gz | 83.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| scrapebadger_cli-0.22.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 173.0 kB
Release files / scrapebadger_cli-0.22.0.tar.gz
| Download URL | scrapebadger_cli-0.22.0.tar.gz |
|---|---|
| Size | 83.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9fa2b1130c6ff79570312bdcd30f138af7bcc84b904f1e413627d7f777faa516
|
|
BLAKE2b-256 checksum How to use checksums |
0660043e0a9c0c5b5bb3605deaf535182b5fbf2ab145b2f59a894a5daff7f142
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / scrapebadger_cli-0.22.0-py3-none-any.whl
| Download URL | scrapebadger_cli-0.22.0-py3-none-any.whl |
|---|---|
| Size | 89.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
52bdd351b55c4f14e95adb0446f0e3482bb390f2e957663ed955e44fad477c6e
|
|
BLAKE2b-256 checksum How to use checksums |
50d28854593f51675505162db353ac3e58ea46b250902d249fdda3156d776a6d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency log
