API Reference

API Reference

Profile Downloader (port 8001)

Method	Endpoint	Description
POST	/profile	Profile info (name, bio, pfp, counts)
POST	/crawl/following	Following list with pagination
POST	/crawl/followers	Followers list with pagination
POST	/crawl/comments	Posts + comments for a user
POST	/crawl/comments-raw	Raw comments for a single post
POST	/crawl/child-comments	Child comments (easycomment only)
POST	/media/posts	Post feed
POST	/media/stories	Active stories
POST	/media/reels	Reels feed
POST	/media/highlights	Highlights list
POST	/media/highlight	Single highlight detail
POST	/download/all	Download all media types to disk
POST	/download/posts	Download posts only
POST	/download/stories	Download stories only
POST	/download/highlights	Download highlights only
GET	/api/quota	RapidAPI daily quota remaining
POST	/token	Update easycomment auth token
GET	/token/status	Current token status

Backend is selected via API_BACKEND env var (rapidapi or easycomment).

Gender Detection (port 8000)

Method	Endpoint	Description
POST	/classify	Classify gender (username + display_name + pfp_base64 + optional bio)
GET	/status/{username}	Classification result for a username
GET	/results	All resolved classifications

Signals: clip_pfp — CLIP ViT-H/14 image classification (75% weight), clip_text — CLIP name+bio text classification (25% weight). All classifications resolve immediately.

Analysis Server (port 8002)

Method	Endpoint	Description
POST	/match	Upload base64 image, get cosine similarity rankings
GET	/health	Embedding count + status