# Send Virlo Short-Form Video Training Data to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "virlo-short-form-video-training-data",
    "name": "Virlo Short-Form Video Training Data",
    "source": "tencent",
    "type": "skill",
    "category": "数据分析",
    "sourceUrl": "https://clawhub.ai/VirloGit/virlo-short-form-video-training-data",
    "canonicalUrl": "https://clawhub.ai/VirloGit/virlo-short-form-video-training-data",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/virlo-short-form-video-training-data",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=virlo-short-form-video-training-data",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/virlo-short-form-video-training-data"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/virlo-short-form-video-training-data",
    "downloadUrl": "https://openagent3.xyz/downloads/virlo-short-form-video-training-data",
    "agentUrl": "https://openagent3.xyz/skills/virlo-short-form-video-training-data/agent",
    "manifestUrl": "https://openagent3.xyz/skills/virlo-short-form-video-training-data/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/virlo-short-form-video-training-data/agent.md"
  }
}
```
## Documentation

### Virlo

Social media intelligence for short-form video — Bloomberg for viral content.

Homepage: https://dev.virlo.ai
Source: https://github.com/CalciferFriend/virlo-skill
Full API docs: https://dev.virlo.ai/docs | Playground: https://dev.virlo.ai/docs/playground

### Config

Set VIRLO_API_KEY environment variable. Your API key has the format virlo_tkn_<your_key> and can be obtained from the Virlo dashboard.

### Context

The Virlo API provides cross-platform analytics across YouTube, TikTok, and Instagram. Key capabilities:

Hashtags — 500K+ hashtags ranked by usage count and total views
Trends — Daily curated trending topics updated at 1am UTC
Videos — 2M+ viral video performance data (views, likes, shares, comments)
Orbit — Keyword-based social listening with async analysis jobs
Comet — Automated niche monitoring with scheduled scraping

### API Access

All endpoints use base URL https://api.virlo.ai/v1, snake_case naming, and return data in a { "data": ... } envelope.

### Making Requests

Use curl directly with the VIRLO_API_KEY environment variable:

# GET request
curl -s -X GET "https://api.virlo.ai<endpoint>" \\
  -H "Authorization: Bearer ${VIRLO_API_KEY}" \\
  -H "Content-Type: application/json"

# POST request with JSON body
curl -s -X POST "https://api.virlo.ai<endpoint>" \\
  -H "Authorization: Bearer ${VIRLO_API_KEY}" \\
  -H "Content-Type: application/json" \\
  -d '<json-body>'

### Examples

# List top hashtags
curl -s -X GET "https://api.virlo.ai/v1/hashtags" \\
  -H "Authorization: Bearer ${VIRLO_API_KEY}" \\
  -H "Content-Type: application/json"

# Top 10 viral videos
curl -s -X GET "https://api.virlo.ai/v1/videos?limit=10" \\
  -H "Authorization: Bearer ${VIRLO_API_KEY}" \\
  -H "Content-Type: application/json"

# Daily trend digest
curl -s -X GET "https://api.virlo.ai/v1/trends" \\
  -H "Authorization: Bearer ${VIRLO_API_KEY}" \\
  -H "Content-Type: application/json"

# Create an Orbit search
curl -s -X POST "https://api.virlo.ai/v1/orbit" \\
  -H "Authorization: Bearer ${VIRLO_API_KEY}" \\
  -H "Content-Type: application/json" \\
  -d '{"name":"AI research","keywords":["artificial intelligence","AI tools"]}'

### Authentication

All requests require a Bearer token:

Authorization: Bearer virlo_tkn_<your_key>

Never commit API keys to version control. Regenerate compromised keys from the dashboard.

### Response Envelope

All responses use a { "data": ... } envelope. List endpoints include pagination metadata:

{
  "data": {
    "total": 500,
    "limit": 50,
    "offset": 0,
    "items": [ ... ]
  }
}

### Pagination

List endpoints use offset-based pagination via limit and page query parameters:

ParameterTypeDefaultDescriptionlimitinteger50Items per page (1-100)pageinteger1Page number (1-indexed)

Maximum of 1000 total results accessible via pagination.

### Common Query Parameters

Many video-related endpoints support these filters:

ParameterTypeDescriptionmin_viewsintegerMinimum view count thresholdplatformsstringComma-separated: youtube, tiktok, instagramstart_datestringISO 8601 date filter (earliest publish date)end_datestringISO 8601 date filter (latest publish date)order_bystringSort field (varies per endpoint)sortstringSort direction: asc or desc (default: desc)

### Platforms

youtube — YouTube Shorts and videos
tiktok — TikTok videos
instagram — Instagram Reels

### Hashtags

Virlo tracks 500K+ hashtags ranked by usage count and total views.

List Hashtags

GET /v1/hashtags

Standard pagination (limit, page).

Response:

{
  "data": [
    {
      "hashtag": "#shorts",
      "count": 10926,
      "total_views": 869912593
    }
  ]
}

FieldTypeDescriptionhashtagstringThe hashtag text (may or may not include #)countintegerNumber of videos using this hashtagtotal_viewsintegerSum of views across all videos with this tag

### Trends

Daily curated trending topics updated at 1am UTC.

List Trend Groups

GET /v1/trends

Standard pagination (limit, page).

Response:

{
  "data": [
    {
      "id": "b88c0c23-8501-4975-a1e9-b7c1160c6342",
      "title": "Trends for Oct 15th",
      "trends": [
        {
          "id": "132ea402-804d-4515-b706-f3ff9c698c5e",
          "trend_id": "8ab75d1a-cb50-4885-b9b3-2e4ede2a3620",
          "trend_group_id": "b88c0c23-8501-4975-a1e9-b7c1160c6342",
          "ranking": 1,
          "trend": {
            "id": "8ab75d1a-cb50-4885-b9b3-2e4ede2a3620",
            "name": "NBA Season Opening Night",
            "description": "The 2025-26 NBA season officially tipped off...",
            "trend_type": "content"
          }
        }
      ]
    }
  ]
}

FieldTypeDescriptionidstringUUID of the trend grouptitlestringDisplay title (e.g., "Trends for Oct 15th")trendsarrayArray of ranked trend entries

Trend entry fields: id, trend_id, trend_group_id, ranking, trend (object with id, name, description, trend_type).

### Videos

2M+ viral videos across YouTube, TikTok, and Instagram.

List Top Videos (Cross-Platform)

GET /v1/videos

ParameterTypeDescriptionlimitintegerItems per page (1-100, default 50)pageintegerPage number (1-indexed, default 1)min_viewsintegerMinimum view count filterplatformsstringComma-separated: youtube, tiktok, instagramstart_datestringISO 8601 earliest publish dateend_datestringISO 8601 latest publish dateorder_bystringpublish_date, views, created_atsortstringasc or desc (default: desc)

Platform-Specific Endpoints

GET /v1/youtube-videos
GET /v1/tiktok-videos
GET /v1/instagram-videos

Same parameters and response shape as /v1/videos, filtered to a single platform.

Video Object Fields

FieldTypeDescriptionidstringVirlo UUIDurlstringOriginal video URLpublish_datestringISO 8601 publish timestampviewsintegerView countnumber_of_likesintegerLike countnumber_of_commentsintegerComment countdescriptionstringVideo descriptionthumbnail_urlstringThumbnail image URLhashtagsstring[]Extracted hashtagstypestringPlatform: youtube, tiktok, instagramnichestringContent niche categoryauthor_idstringUUID of the video authorbookmarksintegerBookmark/save countexternal_idstringPlatform-specific video IDregionstring/nullGeographic region codedurationintegerDuration in secondstranscript_rawstring/nullRaw video transcript (when available)

### Orbit — Social Listening

Queue keyword-based video discovery jobs that search across platforms. Supports async analysis, Meta ads collection, and creator outlier detection.

Create Orbit Search

POST /v1/orbit

FieldTypeRequiredDescriptionnamestringYesDescriptive name for the search jobkeywordsstring[]YesKeywords to search (1-10)platformsstring[]NoPlatforms: youtube, tiktok, instagram. Default: allmin_viewsintegerNoMinimum view count thresholdtime_periodstringNotoday, this_week, this_month, this_yearrun_analysisbooleanNoEnable AI social intelligence analysis (default: false)enable_meta_adsbooleanNoEnable Meta ads collection (default: false)exclude_keywordsstring[]NoKeywords to exclude from resultsexclude_keywords_strictbooleanNoAlso check transcripts for exclusions (default: false)

List Orbit Searches

GET /v1/orbit

Paginated list of all search jobs. Standard limit/page parameters.

Get Orbit Results

GET /v1/orbit/:orbit_id

Poll until job completes. When run_analysis: true, includes AI analysis report.

Query params: order_by (views, likes, shares, comments, bookmarks, publish_date, author.followers), sort (asc/desc).

Response fields: name, keywords, analysis (markdown AI report when ready), results (contains total_videos, platform counts, trends, videos, ads, creators).

Get Orbit Videos (Paginated)

GET /v1/orbit/:orbit_id/videos

Standard pagination plus min_views, platforms, start_date, end_date, order_by, sort.

Get Orbit Ads

GET /v1/orbit/:orbit_id/ads

Meta ads collected (requires enable_meta_ads: true). Pagination plus order_by (created_at, page_like_count), sort.

Get Creator Outliers

GET /v1/orbit/:orbit_id/creators/outliers

Creators outperforming their follower count. High outlier_ratio = content reaching far beyond follower base. Standard pagination.

### Comet — Automated Niche Monitoring

Create niche configs that automatically discover videos, ads, and creator outliers on a schedule.

Create Comet Config

POST /v1/comet

FieldTypeRequiredDescriptionnamestringYesDescriptive name (e.g., "Tech Reviews")keywordsstring[]YesKeywords to search (1-20)platformsstring[]YesPlatforms: youtube, tiktok, instagramcadencestringYesdaily, weekly, monthly, or cron expressionmin_viewsintegerYesMinimum view count thresholdtime_rangestringYestoday, this_week, this_month, this_yearis_activebooleanNoDefault: true. Set false to create pausedmeta_ads_enabledbooleanNoEnable Meta ads collection (default: false)exclude_keywordsstring[]NoKeywords to excludeexclude_keywords_strictbooleanNoAlso check transcripts for exclusions (default: false)

List Comet Configs

GET /v1/comet

Add ?include_inactive=true to include deactivated configs.

Get / Update / Delete Comet Config

GET /v1/comet/:id
PUT /v1/comet/:id       # Full replacement — all required fields must be provided
DELETE /v1/comet/:id     # Soft-delete, returns 204

Get Comet Videos

GET /v1/comet/:id/videos

Standard pagination plus min_views, platforms, start_date, end_date, order_by, sort.

Get Comet Ads

GET /v1/comet/:id/ads

Requires meta_ads_enabled: true. Standard pagination plus order_by (created_at, page_like_count), sort.

Get Creator Outliers

GET /v1/comet/:id/creators/outliers

Standard pagination.

### Error Handling

CodeNameDescription200OKRequest processed successfully201CreatedResource created202AcceptedAsync job queued (e.g., Orbit search)204No ContentSuccessful deletion400Bad RequestInvalid request parameters401UnauthorizedMissing or invalid API key403ForbiddenInsufficient permissions404Not FoundResource not found422Unprocessable EntityValid syntax but cannot process429Too Many RequestsRate limit exceeded500Internal Server ErrorServer error

Error response format:

{
  "error": {
    "type": "validation_error",
    "message": "keywords is required",
    "param": "keywords"
  }
}

### Rate Limits

Max limit per request: 100 items
Max total accessible results: 1,000 items per query
On 429, back off and retry after the retry_after value (in seconds)
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: VirloGit
- Version: 1.0.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/virlo-short-form-video-training-data)
- [Send to Agent page](https://openagent3.xyz/skills/virlo-short-form-video-training-data/agent)
- [JSON manifest](https://openagent3.xyz/skills/virlo-short-form-video-training-data/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/virlo-short-form-video-training-data/agent.md)
- [Download page](https://openagent3.xyz/downloads/virlo-short-form-video-training-data)