Mastodon Search API reference
Your first 10 calls are free, no card needed. Pricing and FAQ
Get a free API keycurl "https://api.insightsocial.app/v1/mastodon/search?host=<host>&query=photography" \ -H "x-api-key: $INSIGHTSOCIAL_API_KEY"
Search a Mastodon server for accounts, hashtags or posts.
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.
Authorization
apiKey Your key from the dashboard. It starts with isk_.
In: header
Query Parameters
The Mastodon server to ask, e.g. mastodon.social. A server URL is also accepted. The server you name is the one that answers.
Search text.
What to search. Omit for accounts and hashtags. posts works only on servers whose software allows searching posts without a login (Pleroma, Akkoma and some others); Mastodon itself does not.
Value in
- "accounts"
- "hashtags"
- "posts"
Items per page, 1 to 40. Default: 20.
1 <= value <= 40Set 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/search?host=string&query=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 }}