Developers

A free, read-only JSON feed of rooms live right now on GirlsUnlocked, plus an embeddable widget you can drop into any site with one iframe tag. No API key, no signup. Data refreshes roughly once a minute.

Adult content notice (18+): the feed and widget reference live adult webcam rooms. Only use them on sites intended for adults aged 18 or over (21+ where applicable).

Live rooms feed

Endpoint (GET only, no auth):

https://girlsunlocked.com/api/cam-aggregator/feed?limit=24

Param	Description
`limit`	Number of rooms, default 24, max 100
`tag`	Filter by a tag, e.g. `tag=milf`
`category`	Filter by a GirlsUnlocked category alias
`gender`	`female`, `male`, `couple` or `transgender`

Response shape:

{
  "attribution": { "source": "GirlsUnlocked", "url": "https://girlsunlocked.com" },
  "count": 24,
  "rooms": [
    {
      "username": "examplemodel",
      "displayName": "examplemodel",
      "age": 24,
      "tags": ["18", "new", "teen"],
      "viewers": 4890,
      "thumb": "https://…/examplemodel.jpg",
      "link": "https://girlsunlocked.com/room/examplemodel"
    }
  ]
}

Example:

fetch('https://girlsunlocked.com/api/cam-aggregator/feed?limit=12&gender=female')
  .then((r) => r.json())
  .then(({ rooms }) => {
    rooms.forEach((room) => console.log(room.username, room.viewers, room.link));
  });

CORS is open (Access-Control-Allow-Origin: *) so you can call it straight from the browser. Responses are cached for about 60 seconds — please don't poll more often than that. Viewer counts and thumbnails come from the live streaming networks and change constantly.

Embeddable widget

A responsive grid of live rooms. Copy-paste this iframe:

<iframe
  src="https://girlsunlocked.com/widget?rows=2&theme=dark"
  width="100%" height="420" frameborder="0"
  title="Live cams by GirlsUnlocked"
  loading="lazy"></iframe>

Param	Description
`rows`	Rows of thumbnails (1–6, default 2)
`tag`	Only rooms with this tag
`theme`	`dark` (default) or `light`

Live preview:

Attribution

The feed and widget are free to use. In return, keep the attribution link intact: any page using the feed data must include a visible link to girlsunlocked.com. The widget includes this automatically — don't hide or crop it.

Fair use

Read-only, GET requests only. No guarantees of uptime or field stability yet — this is a young, free API. If you build something on it, or need higher limits or extra fields, reach out via the contact page — happy to help.