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

Name	Type	Description
access_token	string	(Required) Bearer token for retrieving statuses.
search_keyword	string	(Required) The search keyword.

Headers

The following header must be included in the request:

• Authorization :Bearer token for authentication

Authorization: Bearer {access_token}

Request Example (POST request)

curl --location 'https://{mastodon_instance}/api/v2/search?q={search_keyword}&type=statuses' --header 'Authorization: Bearer 'TOKEN'

Note

• Ensure the provided access_token is a valid Bearer token.
• The response includes lists of accounts, statuses, and hashtags. But only populated statuses as we specifically select it.