How bstoilov/py3-pinterest works
py3-pinterest is an unofficial Python client that mimics Pinterest’s browser-facing internal endpoints. A caller creates a Pinterest client, logs in to obtain reusable cookies, then invokes operations for pins, boards, social actions, search, or messaging; the client builds requests and exchanges them with Pinterest, returning response data. The README documents additional capabilities such as video uploads, sections, and recommendations. The excerpts show selected request, upload, bookmark, and credential paths; links for unsampled feature internals are therefore limited to documented client operations.
Main entry points: Pinterest.py Pinterest client · Registry.py Cookie registry · RequestBuilder.py Request builder · BookmarkManager.py Bookmark manager
Components 15
Client and Requests
- Pinterest client
py3pin/Pinterest.py - Request builder
py3pin/RequestBuilder.py - Browser login
py3pin/Pinterest.py
Pin Operations
- Pin management
py3pin/Pinterest.py - Image and video upload
py3pin/Pinterest.py
Boards and Discovery
- Board and sections
py3pin/Pinterest.py - Search and recommendations
py3pin/Pinterest.py
Social and Messaging
- Follow actions
py3pin/Pinterest.py - Comments
py3pin/Pinterest.py - Conversations
py3pin/Pinterest.py
Session State
- Cookie registry
py3pin/Registry.py - Bookmark manager
py3pin/BookmarkManager.py
Other components
- Python caller
- Pinterest endpoints
- S3 upload service
Connections 22
- Python caller → Pinterest client: invokes
- Pinterest client → Browser login: logs in
- Browser login → Cookie registry: persists cookies
- Pinterest client → Request builder: builds requests
- Pinterest client → Pin management: dispatches
- Pinterest client → Image and video upload: dispatches
- Pinterest client → Board and sections: dispatches
- Pinterest client → Search and recommendations: dispatches
- Pinterest client → Follow actions: dispatches
- Pinterest client → Comments: dispatches
- Pinterest client → Conversations: dispatches
- Pin management → Pinterest endpoints: HTTP requests
- Board and sections → Pinterest endpoints: HTTP requests
- Search and recommendations → Pinterest endpoints: HTTP requests
- Follow actions → Pinterest endpoints: HTTP requests
- Comments → Pinterest endpoints: HTTP requests
- Conversations → Pinterest endpoints: HTTP requests
- Image and video upload → Pinterest endpoints: registers upload
- Image and video upload → S3 upload service: uploads media
- Image and video upload → Pinterest endpoints: polls status
- Pinterest client → Bookmark manager: tracks pagination
- Pinterest client → Cookie registry: loads cookies