How netkaruma/search1688api works
This library exposes synchronous and asynchronous 1688 product-search sessions. Users submit an image or text query; the session initializes cookies and signing state, performs the relevant 1688 requests, and returns parsed product dictionaries. The documented workflow and sampled code support the major stages below; some shared public-method wiring is in omitted source excerpts, so uncertain internal call links are left out.
Main entry points: sync_session.py Sync session · async_session.py Async session · base.py Shared session logic · utils.py HTML fallback parsing
Components 14
Session interfaces
- Sync session
search1688api/sync_session.py - Async session
search1688api/async_session.py
Shared search logic
- Shared session logic
search1688api/base.py - Request signing
search1688api/base.py - API response parsing
search1688api/base.py - Cookie and token setup
search1688api/sync_session.py - Text product search
search1688api/sync_session.py
Image search
- Image encoding
search1688api/utils.py - Image upload request
search1688api/sync_session.py - Search-page cookies
search1688api/sync_session.py - Image product search
search1688api/sync_session.py - HTML fallback parsing
search1688api/utils.py
1688 services
- 1688 APIs and pages
Other components
- Python caller
Connections 27
- Python caller → Sync session: submits query
- Python caller → Async session: submits query
- Sync session → Shared session logic: uses shared logic
- Async session → Shared session logic: uses shared logic
- Shared session logic → Request signing: computes signatures
- Shared session logic → API response parsing: parses responses
- Sync session → Image encoding: encodes image
- Async session → Image encoding: encodes image
- Sync session → Image upload request: uploads image
- Async session → Image upload request: uploads image
- Sync session → Cookie and token setup: initializes session
- Async session → Cookie and token setup: initializes session
- Sync session → Search-page cookies: collects search cookies
- Async session → Search-page cookies: collects search cookies
- Sync session → Image product search: requests image results
- Async session → Image product search: requests image results
- Sync session → Text product search: requests text results
- Async session → Text product search: requests text results
- Image upload request → 1688 APIs and pages: sends image data
- Cookie and token setup → 1688 APIs and pages: requests session cookies
- Search-page cookies → 1688 APIs and pages: requests search pages
- Image product search → 1688 APIs and pages: requests image products
- Text product search → 1688 APIs and pages: requests text products
- Image product search → HTML fallback parsing: parses fallback HTML
- HTML fallback parsing → 1688 APIs and pages: fetches fallback page
- Python caller → Sync session: receives product list
- Python caller → Async session: receives product list