> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/dev-to/trend>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/dev-to/trend.mdx>

---

# Dev.to Trend API

One trending topic, its top-scoring posts, and optionally every post in it.

`GET /v1/dev-to/trend` takes exactly one of `id` or `slug` and returns `trend` with `id`, `name`, `slug`, `description`, `keyQuestions`, `score`, `articlesCount`, `coverImage`, `firstObservedAt` and `lastObservedAt`. It also carries `topArticles`, each with `id`, `title`, `slug`, `score` and `publishedAt`.

Add `include=articles` to receive a page of the trend's full post objects in `articles`, using the same post shape as `/v1/dev-to/articles`, with `page` and `limit` controlling that list. Without `include=articles`, `articles` and `page` are null, and sending `page` or `limit` without it is refused. An unknown trend returns `lookupStatus: not_found` with `trend` null.

## Request

- **Endpoint:** `GET /v1/dev-to/trend`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by id or slug
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/dev-to/trend/get)
- **Platform page:** [/platforms/dev-to](https://www.socialfetch.dev/platforms/dev-to)

## FAQ

### Why do page and limit need include=articles?

They apply to the trend's article list. Without include=articles there is no list to page, so those parameters are refused rather than ignored.

### How many credits does a trend lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.

### What does topArticles contain?

The trend's top-scoring posts with id, title, slug, score and publishedAt. For full post bodies, use the article route with each id.

### Can I send a slug instead of an id?

Yes, but exactly one of the two. The slug is lowercase and can contain hyphens, for example a trend slug from the trends list.