Skip to main content


Mastodon is a federated social media and social networking service.

This loader fetches the text from the "toots" of a list of Mastodon accounts, using the Python package.

Public accounts can the queried by default without any authentication. If non-public accounts or instances are queried, you have to register an application for your account which gets you an access token, and set that token and your account's API base URL.

Then you need to pass in the Mastodon account names you want to extract, in the @account@instance format.

from langchain_community.document_loaders import MastodonTootsLoader

API Reference:

%pip install --upgrade --quiet
loader = MastodonTootsLoader(
number_toots=50, # Default value is 100

# Or set up access information to use a Mastodon app.
# Note that the access token can either be passed into
# constructor or you can set the environment "MASTODON_ACCESS_TOKEN".
# loader = MastodonTootsLoader(
# access_token="<ACCESS TOKEN OF MASTODON APP>",
# mastodon_accounts=[""],
# number_toots=50, # Default value is 100
# )
documents = loader.load()
for doc in documents[:3]:
print("=" * 80)
<p>It is tough to leave this behind and go back to reality. And some people live here! I’m sure there are downsides but it sounds pretty good to me right now.</p>
<p>I wish we could stay here a little longer, but it is time to go home πŸ₯²</p>
<p>Last day of the honeymoon. And it’s <a href="" class="mention hashtag" rel="tag">#<span>caturday</span></a>! This cute tabby came to the restaurant to beg for food and got some chicken.</p>

The toot texts (the documents' page_content) is by default HTML as returned by the Mastodon API.

Help us out by providing feedback on this documentation page: