Live cam data API
MyFreeCams data over a simple REST API: model profiles with CamScore, rank and weekly schedules, live 853x480 broadcast snapshots stored permanently on our CDN, snapshot history, a searchable model catalog and search by face photo.
Overview
Endpoints
Display name, numeric user id, gender, age, country and city, bio (body type, hair, eyes, height, weight, about me, interests and favourites), tags, CamScore and rank, followers, content counts, weekly schedule, the day of the last broadcast and live status with viewers and room topic.
/profile/{username}
Captures the current broadcast frame (853x480 JPEG) and returns a permanent CDN link. Only a public show produces a frame: offline and away models and private, group or club 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 MyFreeCams model catalog. Page size and extended fields (tags, new-model flag, viewers, avatar, headline, rank, continent and registration date) depend on your plan.
/catalog/{page}/{order}
Full-text search over the catalog by username, country, city, tags and profile headline. Page size depends on your plan.
/catalog/search/{page}/{order}
Upload a face photo and find the MyFreeCams 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/myfreecams-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: myfreecams-api.p.rapidapi.com" \
"https://myfreecams-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 MyFreeCams 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 MyFreeCams 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 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.