EveryData platform API
Odysee API
Odysee video discovery, trending items, channel uploads, and tag feeds are the Odysee objects documented here; 4 actions including `search`, `trending`, `user_posts` keep Odysee selectors and outputs separate.
On Odysee, `search` handles matching public results through `keyword`, while `trending` handles the current trending sample through no required business input; neither Odysee action receives undeclared filters.
- Endpoint
- POST /api/v1/social
- Capabilities
- 4
- Per 1,000
- $1.389
Available capabilities
Compare the Odysee actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on Odysee. Accepts these parameters: | keyword | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · view_count · like_count · published_at · media_type · languages · tags · platform |
trendingTrending Retrieve current trends from Odysee. Requires no parameters. Returns these fields: | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · view_count · like_count · published_at · media_type · languages · tags · platform | |
user_postsPosts by user Retrieve public posts from Odysee. Accepts these parameters: | username | sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · view_count · like_count · published_at · media_type · languages · tags · platform |
tagTag Retrieve a public tag feed from Odysee. Accepts these parameters: | tag | sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · title · description · channel_name · channel_id · channel_url · url · thumbnail_url · duration_seconds · view_count · like_count · published_at · media_type · languages · tags · platform |
What does each Odysee action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Odysee search parameters mean?
Search public results on Odysee. Accepts these parameters: keyword. Returns these fields: like_count, thumbnail_url, channel_id, and published_at.
keywordRequired- Specifies the video search query string for the search action. The trending action does not take a keyword parameter. The main search endpoint does not support sorting options available for channel lists.Odysee: Display Titles Are Distinct from Content URLsOdysee explicitly distinguishes the Title, URL, and Description of uploaded content, as each serves a different purpose. Search results should preserve original links and titles rather than constructing addresses from titles, and description text does not constitute a full video transcript.Checked
What do the Odysee trending parameters mean?
Retrieve current trends from Odysee. Requires no parameters. Returns these fields: description, media_type, like_count, and channel_id.
This action has no business parameters. Send only the platform and action identifiers.
What do the Odysee user_posts parameters mean?
Retrieve public posts from Odysee. Accepts these parameters: username and sort. Returns these fields: description, media_type, view_count, and duration_seconds.
usernameRequired- Specifies the channel identifier for the user_posts action. Accepts a channel name, @name, or a full Odysee channel URL. The parser strips claim identifiers after a colon from the name; verify output objects if target channel names overlap.Odysee: Distinction Between Channel Names and Claim IdentifiersOdysee's naming documentation notes that the portion of a URL following a colon relates to the Claim of a specific channel or content item, requiring full identifiers to distinguish same-name addresses. When extracting channel names, this interface removes that portion; citing this documentation does not imply support for precise Claim queries.Checked
sortOptional- 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.Allowed values:
newestpopular
What do the Odysee tag parameters mean?
Retrieve a public tag feed from Odysee. Accepts these parameters: sort and tag. Returns these fields: tags, channel_name, channel_url, and duration_seconds.
tagRequired- Specifies the content tag for the tag action, provided with or without a leading hash sign (#). This filters items matched to a structured tag and does not perform general full-text keyword searches.Odysee: Content Tags, Control Tags, and Language SettingsOdysee separates topic tags from interaction control tags, and lists content language and copyright licensing as distinct settings. The tags and languages returned by this interface describe only the actual information retrieved; they do not grant uploading, interaction control, translation, or content syndication permissions.Checked
sortOptional- 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.Allowed values:
newestpopular
How to use the Odysee API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"odysee","action":"search","params":{"keyword":"<keyword>"}}'
Odysee API questions
What can I retrieve with the Odysee API?
Set platform to odysee. The current catalog lists search, trending, posts by user, and tag. These action names identify different Odysee objects or views; they are not interchangeable search modes.
Which input starts a Odysee `search` request?
Specifies the video search query string for the search action. The trending action does not take a keyword parameter. The main search endpoint does not support sorting options available for channel lists. Send it as keyword inside params.
Which fields can Odysee `search` return?
Its declared schema includes title, description, channel_name, and channel_id. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Odysee action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.