Live cam data API
CamSoda data over a simple REST API: model profiles with show prices and fan club tiers, live 1024x576 broadcast snapshots stored permanently on our CDN, snapshot history, a searchable model catalog and search by face photo.
Overview
Endpoints
Display name, gender, age, country, spoken languages, bio, interests, followers, viewer ratings, show prices in tokens, fan club tiers, social handles, the hours the model is usually online (UTC), photo albums and videos and live status.
/profile/{username}
Captures the current broadcast frame (WebP, 1024x576) and returns a permanent CDN link. Offline models and private, group or ticket shows return stream_unavailable with HTTP 200.
/screenshot/{username}
Frames captured for the model, newest first, each with a permanent CDN link, capture time and size. History depth depends on your plan.
/snapshots/{username}
Paginated browsing over the CamSoda model catalog. Page size and extended fields (tags, new-model flag, viewers, avatar, room subject and join date) depend on your plan.
/catalog/{page}/{order}
Full-text search over the catalog by username, display name, country, languages and interests. Page size depends on your plan.
/catalog/search/{page}/{order}
Upload a face photo and find the CamSoda models who look like that person. Each model appears once with the best-matching broadcast frame and a similarity score from 0 to 1. The number of matches depends on your plan.
/search/by_image
Quick start
Send your account API key in the X-API-Key header, as an Authorization: Bearer token or as the api_key query parameter. Every response is JSON.
curl \
-H "X-API-Key: <your-api-key>" \
"https://api.mirai-api.com/camsoda-api/profile/<username>"Already on RapidAPI? Call the same endpoints with your RapidAPI key and host headers.
curl \
-H "X-RapidAPI-Key: <your-rapidapi-key>" \
-H "X-RapidAPI-Host: camsoda-api.p.rapidapi.com" \
"https://camsoda-api.p.rapidapi.com/profile/<username>"Good to know
Use cases
Show live status, fresh broadcast previews and profile details for the models you list or promote.
Track followers, ratings, broadcast activity and profile changes across the catalog.
Match a face photo against broadcast frames to find the same performer on several platforms.
Check whether a photo belongs to a known model profile and spot impersonation or reused images.
FAQ
No. You call the API with your Apimirai key; all platform access, sessions and proxies are handled on our side.
Live snapshot requests for offline models and paid or private shows return HTTP 200 with the stream_unavailable code. The profile and the snapshot history stay available.
Yes. POST /search/by_image takes a face photo as base64 and returns the CamSoda models who look like that person, each with the best-matching broadcast frame and a similarity score from 0 to 1.
Yes. Every captured frame is stored on our CDN and its link keeps working, so you can save it in your own database.
Create an account on mirai-api.com, choose a plan for the CamSoda API and copy your API key from the Settings page. Send it in the X-API-Key header, as an Authorization: Bearer token or as the api_key query parameter.
Yes. The same endpoints are published on RapidAPI, so you can also subscribe there and call them with your RapidAPI key.
More APIs
Model profiles, live broadcast snapshots, snapshot history, a searchable model catalog and search by face photo.
Room cards and bios, live 640x360 broadcast snapshots, snapshot history, a searchable model catalog and search by face photo.
Model profiles with wall posts, live broadcast snapshots, snapshot history, a searchable model catalog and search by face photo.
Model profiles with tip menus and working hours, live broadcast snapshots, snapshot history, a searchable model catalog and search by face photo.
Model profiles with CamScore and weekly schedules, live broadcast snapshots, snapshot history, a searchable model catalog and search by face photo.
Model profiles with ratings, skills and appearance, live broadcast snapshots, snapshot history, a searchable model catalog and search by face photo.
Model profiles with ratings, reviews and show prices, live broadcast snapshots, snapshot history, a searchable model catalog and search by face photo.
An endpoint in ten of our APIs that finds creators and cam models who look like the person in a photo.
Create an account to get your API key, documentation with live request examples and direct developer support.