directory

A directory of profiles that your website is aware of.

View profile directory

GET https://mastodon.example/api/v1/directory

List accounts visible in the directory. Returns: Array of Account OAuth: Public Version history: 3.0.0 - added

Query Parameters

Name	Type	Description
offset	string	How many accounts to skip before returning results. Default 0.
limit	string	How many accounts to load. Default 40.
order	string	active to sort by most recently posted statuses (default) or new to sort by most recently created profiles.
local	boolean	Only return local accounts.

200 Sample results with limit=2

[
  {
    "id": "796927",
    "username": "eternalNo3",
    "acct": "[e-mail]",
    "display_name": "ESD＠┓（谷）┏",
    ...
  },
  {
    "id": "787648",
    "username": "ariel",
    "acct": "[e-mail]",
    "display_name": "あやっしー🧜🏻‍♀️",
    ...
  }
]