# Odysee Posts by user API (odysee.user_posts)

- Canonical page: [https://everyinfra.com/en/odysee-api/user_posts](https://everyinfra.com/en/odysee-api/user_posts?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "odysee", "action": "user_posts", "params": {...}}
- Price: $0.032 per call ($32 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

Odysee Posts by user lists the uploads of one channel, named by `username`, with each item's title, description, link, thumbnail, length, views, likes, publish time, media type, languages and tags, plus the channel's name, ID and link. Use it to follow a creator who publishes on Odysee, archive or audit a channel's output, or compare what a channel posts there with its output elsewhere.

`username` takes the channel name with or without the @, or a channel link that contains @name. Set `sort` to `newest` for publish order or `popular` for a ranking tied to the support amounts behind each item. `duration_seconds` is null for items that are not video or audio, and a null `view_count` or `like_count` is an undisclosed figure, to be kept apart from a real zero.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=odysee&action=user_posts

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| username | not declared | yes | not declared | Specifies the channel identifier for the user_posts action. Accepts a channel name, @name, or a full Odysee channel URL. Anything after a colon (the claim ID) is dropped, so check the result when channel names overlap. |
| sort | enum: newest / popular | no | not declared | Sorts content for the user_posts and tag actions. Allowed values are newest (sorts by publish date) and popular (sorts by support amount metrics). Note that popular does not measure total view count or like count. |
| limit | integer (1–200) | no | 20 | The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| description | Summary or description, usually shorter than text. |
| channel_name | platform-native meaning |
| channel_id | platform-native meaning |
| channel_url | platform-native meaning |
| url | Link to the record on the platform. |
| thumbnail_url | Thumbnail link, lower resolution than image_url. |
| duration_seconds | Duration in seconds. null for content that is not video or audio. |
| duration_sec | platform-native meaning |
| view_count | Views or plays. null means not disclosed, not 0. |
| like_count | Likes. null means the platform or this capability does not disclose it; it is not 0. |
| published_at | platform-native meaning |
| media_type | platform-native meaning |
| languages | platform-native meaning |
| tags | Array of tags. An empty array, not null, when there are none. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "odysee",
  "action": "user_posts",
  "params": {
    "username": "@lbry"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "odysee",
        "action": "user_posts",
        "params": {
            "username": "@lbry",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "odysee",
  "action": "user_posts",
  "results": [
    {
      "id": "7aa2220e2d1d5942b90240dec25e925b11a8ea04",
      "title": "Odysee LBRY Usage Agreement",
      "channel_name": "@lbry",
      "channel_url": "https://odysee.com/@•••",
      "url": "https://odysee.com/@lbry/odyseelbryagreement",
      "thumbnail_url": "https://thumbs.odycdn.com/b18ae7090861d94d6c7081969e970348.webp",
      "published_at": "2023-10-19T20:01:10+00:00",
      "media_type": "application/pdf",
      "languages": [
        "en"
      ],
      "platform": "odysee"
    },
    {
      "id": "d434ed74a2a4874358eca22702dd25289d8fc1cd",
      "title": "The End of LBRY Inc.",
      "channel_name": "@lbry",
      "channel_url": "https://odysee.com/@•••",
      "url": "https://odysee.com/@lbry/theendoflbryinc",
      "thumbnail_url": "https://thumbs.odycdn.com/e9740b8e51f33735964d1cccbc53b70d.webp",
      "published_at": "2023-10-19T16:44:47+00:00",
      "media_type": "text/markdown",
      "languages": [
        "en"
      ],
      "tags": [
        "lbry"
      ],
      "platform": "odysee"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### What can I pass as `username`?

The channel name in any of three forms: name, @name, or an Odysee channel link that contains @name. For example, lbry and @lbry read the same channel. Pass one channel per call and keep `channel_id` from the results as the key for what you store.

### Does `popular` mean most viewed?

No. `popular` ranks items by a measure tied to the support amounts they received on Odysee, not by views or likes. To rank by audience, fetch with `newest` and order the rows by `view_count` or `like_count` yourself.

### How do I keep only items in one language?

Filter on `languages`, which lists each item's content languages, and on `media_type` to keep videos apart from other formats. `tags` is an empty array rather than null when an item has none, so it is safe to filter on as well.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=odysee
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
