InsightSocial API
Mastodon

Mastodon Timelines Hashtag API reference

Your first 10 calls are free, no card needed. Pricing and FAQ

Get a free API key
Example request
curl "https://api.insightsocial.app/v1/mastodon/timelines/hashtag?tag=<tag>&host=<host>" \
  -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
GET
/v1/mastodon/timelines/hashtag

List public Mastodon posts with a hashtag.

Beta. The source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp), not one of the schema-2 entities. Fields may change. See Beta endpoints.

20 credits per call.

Paginates by cursor: see Pagination.

x-api-key<token>

Your key from the dashboard. It starts with isk_.

In: header

Query Parameters

tag*string

Hashtag name without the #, e.g. photography. Letters of any script are allowed; the server folds case and accents.

host*string

The Mastodon server to ask, e.g. mastodon.social. A server URL is also accepted. The server you name is the one that answers.

scope?string

all (default) is everything the server has seen, local only the server's own accounts, remote only accounts from other servers.

Value in

  • "all"
  • "local"
  • "remote"
media_only?boolean

Only posts with media attachments.

any?array<string>

Also match any of these hashtags (comma-separated).

all?array<string>

Also require all of these hashtags (comma-separated).

none?array<string>

Exclude posts with these hashtags (comma-separated).

limit?integer

Items per page, 1 to 40. Default: 20.

Range1 <= value <= 40
cursor?string

Pass pagination.next_cursor from the previous response to get the next page. Keep the other parameters the same.

dry_run?"1"

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

Value in

  • "1"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.insightsocial.app/v1/mastodon/timelines/hashtag?tag=string&host=string"
{  "success": true,  "platform": "string",  "endpoint": "string",  "schema_version": "2",  "pagination": {    "next_cursor": "string",    "has_more": true,    "page_size": 0,    "stopped_at": "since"  },  "unavailable": [    "string"  ],  "credits_used": 0,  "credits_remaining": 0,  "request_id": "string",  "cached": true,  "idempotent_replay": true,  "charge_reason": "string",  "free_call": true,  "data": {    "property1": null,    "property2": null  }}