Trends

The trends endpoint provides access to trending topics organized into groups. Each group contains ranked trends with detailed information about trending content.

GET/trends

Get trends

Returns trend groups within a specified date range. Each group contains ranked trends that were active at that time. Defaults to the last 24 hours to capture the most recent trends (typically generated at 1am UTC daily).

Cost per request:500 credits

Query parameters

Name
startDate
Type
string
Description
Start date for filtering (ISO 8601 format like 2025-10-14T00:00:00.000Z or simplified 2025-10-14). Defaults to 24 hours ago.
Name
endDate
Type
string
Description
End date for filtering (ISO 8601 format like 2025-10-16T23:59:59.999Z or simplified 2025-10-16). Defaults to now.
Name
limit
Type
number
Description
Maximum number of trend groups to return (1-10). Default is 5.

Request

GET

/trends

curl -G https://api.virlo.ai/trends \
  -H "Authorization: Bearer {token}" \
  -d startDate=2025-10-14 \
  -d endDate=2025-10-16 \
  -d limit=5

Response

{
  "results": 1,
  "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 with opening night games, marking LeBron James' first season opener absence since 2002 due to injury. Fans are celebrating the return of basketball with highlights, predictions, and reactions to the new season.",
            "trend_type": "content"
          }
        },
        {
          "id": "e4b183c8-a704-4add-bd14-43f11a27b92d",
          "trend_id": "63f0c8a1-f0f3-42ff-92bf-c2be4c61dc90",
          "trend_group_id": "b88c0c23-8501-4975-a1e9-b7c1160c6342",
          "ranking": 2,
          "trend": {
            "id": "63f0c8a1-f0f3-42ff-92bf-c2be4c61dc90",
            "name": "Inside the NBA Returns to ESPN After 23 Years",
            "description": "The iconic Inside the NBA crew is officially back on ESPN for the first time in 23 years, and basketball fans are celebrating. The beloved show with its legendary chemistry and hilarious moments is returning to a new network, marking a historic shift in NBA broadcasting that has everyone nostalgic.",
            "trend_type": "content"
          }
        }
      ]
    }
  ]
}

GET/trends/digest

Get trends digest

Returns today's trend groups based on current date in EST/EDT timezone. This endpoint ensures that at 9pm EST (1am UTC next day), we still show today's EST trends.

Cost per request:500 credits

Request

GET

/trends/digest

curl https://api.virlo.ai/trends/digest \
  -H "Authorization: Bearer {token}"

Response

{
  "results": 1,
  "data": [
    {
      "id": "def-456",
      "title": "Trends for Oct 22nd",
      "trends": [
        {
          "id": "trend-2",
          "trend_id": "t-456",
          "trend_group_id": "def-456",
          "ranking": 1,
          "trend": {
            "id": "t-456",
            "name": "Playboi Carti Super Bowl Performance Petition",
            "description": "Fans have started a petition demanding Playboi Carti perform at the 2026 Super Bowl instead of Bad Bunny, with the campaign gaining massive traction as fans debate which artist deserves the coveted performance slot",
            "trend_type": "content"
          }
        },
        {
          "id": "trend-3",
          "trend_id": "t-789",
          "trend_group_id": "def-456",
          "ranking": 2,
          "trend": {
            "id": "t-789",
            "name": "Drake Birthday Merch Drop - More Life & FATD Themed",
            "description": "Drake teamed up with Amazon for a birthday merch collection featuring gear themed from 'More Life' and 'For All The Dogs', with fans hyped about the new drop celebrating the rapper's birthday with throwback album aesthetics",
            "trend_type": "content"
          }
        }
      ]
    }
  ]
}

Error responses

The trends endpoints may return the following error codes:

Name
400 Bad Request
Description
Invalid parameters provided. Common causes include: - Invalid date format (must be ISO 8601 format for /trends) - Invalid limit value (must be 1-10)
Name
401 Unauthorized
Description
Missing or invalid API key. Ensure you're including your API key in the Authorization header.
Name
429 Too Many Requests
Description
Rate limit exceeded. Your plan has specific rate limits per endpoint. Wait before making additional requests.