List Mastodon trending links
List the links trending on a Mastodon server.
Headers
Get your API keyAPI key (`sfk_...`)
The Mastodon server to ask, e.g. `mastodon.social`. A server URL is also accepted. The server you name is the one that answers.
Pass `page.nextCursor` from the previous response (a plain number is taken as an offset). The list is ordered live, so a row can appear on two pages; remove repeats by `id`, `name` or `url`.
min 1 chars · max 512 chars
Items to skip, as an offset. Prefer `cursor` for the next page. Default: 0.
≥ 0 · ≤ 100000
Items per page, 1 to 20. Default: 20.
≥ 1 · ≤ 20
Endpoint-specific response payload.
`found`, `not_found`, `restricted` (login required or closed), `unsupported` (this server does not offer it) or `not_compatible` (the host is not a Mastodon-compatible server). See `reason`.
one of: found, not_found, restricted, unsupported, not_compatible
The server that was asked.
Only on a `not_compatible` result (and always on the server endpoint): the software the host runs, from its NodeInfo, e.g. `misskey` or `lemmy`; null when it does not say. Absent otherwise.
Why `lookupStatus` is not `found`, or null when it is `found`.
Machine-readable reason.
one of: login_required, closed_by_operator, hidden_by_owner, suspended, not_implemented, disabled_by_operator, not_a_mastodon_server, unsupported_server_software, host_not_found, post_not_visible
Plain-language explanation.
Trending links, most shared first.
The link the card points to.
Title of the linked page.
Short description of the linked page.
`link`, `photo`, `video` or `rich`.
Site that published the linked page.
The publisher's own page.
Authors of the linked page.
Author name.
Author page.
When the linked page was published, when known.
ISO language code of the linked page, when known.
Preview image, when the link has one.
Preview image.
Alt text.
Blurhash placeholder for the preview.
Width in pixels, when known.
Height in pixels, when known.
Daily shares and distinct accounts, newest first.
UTC date, `YYYY-MM-DD`.
Times the hashtag was used that day.
Distinct accounts that used the hashtag that day.
Pagination state for the current page.
Whether another page is available.
The way to the next page: pass it as `cursor`; null on the last page.
Offset to pass as `offset`; null on the last page. Prefer `nextCursor`.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/mastodon/trends/links?host=mastodon.social" \
-H "x-api-key: YOUR_API_KEY"Responses
Links trending on one server.