Skip to content

Murmurations Index API

Index API Documentation 📙

The Index API enables nodes, using predefined schemas, to add, update and delete their data in the index so that aggregators can discover them.

Nodes store their profiles on their website or through a dedicated profile host and then request them to be referenced in the index. The index validates that the profile meets the requirements of its associated schema(s). The index does not store the entire profile; instead it stores only certain fields that can then be used by aggregators to find profiles that match various search criteria. The index will return a list of nodes and their URLs (profile_urls) so that aggregators can then download from each node it's profile data for use in their apps.