Home

Welcome to the osomemastodon documentation.

API Documentation

API Endpoints

1. Instance - Get Mastodon Instances API
2. Status - Search by keyword API
3. Status - Most recent by hashtag API
4. Status - Most recent for instance API
5. Status - Single status by Id API
6. Accounts - Search by keyword
7. Accounts - Single Account by Id
8. Get Hashtag metadata

1. Instance - Get Mastodon Instances API

Overview

The Mastodon Instances API provides a list of Mastodon instances based on specified criteria, including minimum active users, count, sorting, and authorization. You can access the official documentation from here.

Official API Endpoint

GET https://instances.social/api/1.0/instances/list

Request

• Method : GET
• URL : https://instances.social/api/1.0/instances/list
• Headers:
• Authorization: Bearer YOUR_API_KEY

OSoMe API Endpoint

GET https://osome.iu.edu/tools/mastodon/api/get-instance-data

Request

• Method : GET
• URL : https://osome.iu.edu/tools/mastodon/api/get-instance-data

Note Data is returned in JSON format.

2. Status - Search by keyword API

Overview

The Search API provides a method to retrieve accounts, statuses, and hashtags based on a specified search keyword. In this API, we get the statuses results as a json format. You can access the official documentation from here.

Official API Endpoint

GET https://{mastodon_instance}/api/v2/search?q={search_keyword}&type=statuses&resolve=true