# list_trends

List the trends on Layer's Trends page, for creative direction on game marketing assets.

\`creative\` trends are hooks and formats distilled from mobile game UA video ads, ordered by  
how many ads show them. \`top\` trends are what is charting on public boards (TikTok, YouTube,  
Google Trends, ...), ordered by rank; \`source\` keeps to one board. Call \`get\_trend\` on an  
item for its scenario, variants, research and the reference files to generate from.

## Parameters

| Parameter             | Type              | Default  | Description                                                                                                                                                                     |
| --------------------- | ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| workspace\_idrequired | string (uuid)     | —        | The user's workspace id.                                                                                                                                                        |
| type                  | enum              | creative | \`creative\` (the default) lists patterns distilled from UA video ads, most-matched first. \`top\` lists entries on public trending boards, in rank order.One of: creative, top |
| source                | string0–64 chars  | —        | Board slug such as \`tiktok\`, \`youtube\` or \`google-trends\`, to list one board's \`top\` trends.                                                                            |
| search                | string0–200 chars | —        | Full-text search over title, summary, tags, genres and countries.                                                                                                               |
| pagination            | PaginationInput   | —        | Parameters driving result pagination                                                                                                                                            |
| limit                 | integer1–100      | 20       | Maximum number of results to return                                                                                                                                             |
| cursor                | string            | —        | Cursor from which to return results                                                                                                                                             |