Live cam data API
Cam4 data over a simple REST API: model profiles with public wall posts, live broadcast snapshots stored permanently on our CDN, snapshot history, a searchable model catalog and search by face photo.
Overview
Endpoints
Age, gender, sexual orientation, country, spoken languages, follower count, avatar and banner, last broadcast time, live status and the model's public wall posts.
/profile/{username}
Captures the current broadcast frame and returns a permanent CDN link. The frame is the platform's ready-made image closest to 640x360, never resized: usually 400x225 (400x711 for vertical broadcasts). Offline models 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 Cam4 model catalog. Page size and extended fields (orientation, broadcast type, tags, viewers, avatar and last broadcast time) depend on your plan.
/catalog/{page}/{order}
Full-text search over the catalog by username, country code, language codes, sexual orientation and tags. Page size depends on your plan.
/catalog/search/{page}/{order}
Upload a face photo and find the Cam4 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/cam4-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: cam4-api.p.rapidapi.com" \
"https://cam4-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 Cam4 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 Cam4 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 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 show prices and fan clubs, live 1024x576 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.