# TikTok / Liked

Fetch liked videos for a username when that account makes likes public. Many profiles hide liked videos; those requests fail (likes are private).

```
GET /api/v1/tiktok/liked
```

Auth: `Authorization: Bearer <SOCIFY_KEY>`  
Credits: 1 credit per request

## Parameters

| Name | Required | Description | Example |
|------|----------|-------------|---------|
| `username` | yes | TikTok username without @. Account must show likes publicly. | `lilyachty` |
| `cursor` | no | Pagination cursor from a previous response. |  |

## Example

```bash
curl -s 'https://trysocify.com/api/v1/tiktok/liked?username=lilyachty' \
  -H "Authorization: Bearer $SOCIFY_KEY"
```

## Response fields

| Field | Type | Description |
|-------|------|-------------|
| `videos` | array | Liked videos for this page. |
| `videos[].id` | string | Video id. |
| `videos[].caption` | string | Caption. |
| `videos[].likes` | number | Like count. |
| `cursor` | string | Pass as cursor for the next page. |
## Sample response

Successful lookups wrap the payload in `{ ok, platform, resource, params, data, meta }`. `data` is shown below.

```json
{
  "ok": true,
  "platform": "tiktok",
  "resource": "liked",
  "params": {
    "username": "lilyachty"
  },
  "data": {
    "cursor": "1699553318000",
    "videos": [
      {
        "author": {
          "id": "999",
          "username": "someone"
        },
        "caption": "funny clip",
        "comments": 900,
        "cover": "https://p16-sign-va.tiktokcdn.com/example.jpeg",
        "created_at": 1660000000,
        "duration": 15,
        "id": "7000000000000000001",
        "likes": 150000,
        "plays": 2000000,
        "shares": 4000,
        "url": "https://www.tiktok.com/@someone/video/7000000000000000001"
      }
    ]
  },
  "meta": {
    "credits_charged": 1,
    "latency_ms": 420,
    "platform": "tiktok",
    "resource": "liked",
    "path": "/api/v1/tiktok/liked"
  }
}
```

## Links

- HTML docs: https://trysocify.com/docs/api/tiktok/liked
- SEO page: https://trysocify.com/tiktok/liked
- OpenAPI: https://trysocify.com/openapi.json
- Catalog: https://trysocify.com/catalog.json