ScrapeBadger CLI
Google Light Search uses the dedicated /v1/google/light/search endpoint:
scrapebadger google light-search "vinted api" --gl us --hl en
Light returns organic results and related searches for 10 credits per successful
uncached request. Regular scrapebadger google search costs 20 credits and
returns the full SERP. Cache hits and failed requests are free.
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.23.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 | |
|---|---|---|---|---|
| scrapebadger_cli-0.23.0.tar.gz | 83.7 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| scrapebadger_cli-0.23.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 173.7 kB
Release files / scrapebadger_cli-0.23.0.tar.gz
| Download URL | scrapebadger_cli-0.23.0.tar.gz |
|---|---|
| Size | 83.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
49f03ccec68d6869e0d09f38d3cefbc2b014cebc684f39cc072c3f78fe53a9b6
|
|
BLAKE2b-256 checksum How to use checksums |
aef100f9f10040a9bd3587040a21b99de4015f7c9e8dc9c2c93cd5f12c2a6428
|
| 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 20, 2026.
Transparency logRelease files / scrapebadger_cli-0.23.0-py3-none-any.whl
| Download URL | scrapebadger_cli-0.23.0-py3-none-any.whl |
|---|---|
| Size | 90.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3e0c08b412fea76104d677a19cd3a3f7cc5307dd1e496ea52f1a304cff61f5f7
|
|
BLAKE2b-256 checksum How to use checksums |
8b4cdfa3bbc37de90cbfb476151683e9477ecc45dbfd5dcb81fce37977a42ac5
|
| 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 20, 2026.
Transparency logSecurity for scrapebadger-cli 0.23.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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for scrapebadger_cli-0.23.0.tar.gz
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 20, 2026.
Transparency logA 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.
