Batch Get Federated Accounts Activities (Beta)

Retrieve activities associated with multiple accounts on all compatible networks. You can use various query parameters to filter and paginate the results, including limits on the number of activities and actions, timestamps, success status, direction, and more.

POST

/federated/accounts

Request Body

application/jsonRequired

Request body for batch retrieving activities for multiple federated accounts

`accounts`array<string>

List of federated accounts to retrieve activities

`limit`integer

Specify the number of activities to retrieve

Default: 100Minimum: 1Maximum: 100

`action_limit`integer

Specify the number of actions within the activity to retrieve

Default: 10Minimum: 1Maximum: 20

`cursor`string

Specify the cursor used for pagination

`since_timestamp`integer

Retrieve activities starting from this timestamp

`until_timestamp`integer

Retrieve activities up to this timestamp

`success`boolean

Retrieve activities based on success status

`direction`string

The direction of an activity.

Value in: "in" | "out" | "self"

`network`string

Retrieve activities from the specified network(s)

`tag`string

Retrieve activities for the specified tag(s)

`type`array<string>

Retrieve activities for the specified type(s)

`platform`string

Retrieve activities from the specified platform(s)

curl -X POST "https://gi.rss3.io/federated/accounts" \
  -H "Content-Type: application/json" \
  -d '{
    "accounts": [
      "@hauptstadtzoos@mastodon.berlin",
      "@nummycreations@mstdn.business"
    ],
    "limit": 20,
    "action_limit": 10,
    "cursor": "string",
    "since_timestamp": 0,
    "until_timestamp": 0,
    "success": true,
    "direction": "out",
    "network": "string",
    "tag": "social",
    "type": [
      "post",
      "comment",
      "share"
    ],
    "platform": "Mastodon"
  }'

A successful response with the activities from the specified account. The response includes details about each activity, such as its ID, timestamp, and associated actions.

{
  "data": [
    {
      "id": "https://universeodon.com/users/woofers/statuses/113324128515491294/activity",
      "owner": "@georgetakei@universeodon.com",
      "network": "mastodon",
      "from": "@woofers@universeodon.com",
      "to": "@georgetakei@universeodon.com",
      "index": 0,
      "platform": "Mastodon",
      "success": true,
      "tag": "social",
      "type": "comment",
      "direction": "out",
      "timestamp": 1729188972,
      "total_actions": 1,
      "actions": [
        {
          "tag": "social",
          "type": "comment",
          "platform": "Mastodon",
          "from": "@woofers@universeodon.com",
          "to": "@georgetakei@universeodon.com",
          "metadata": {
            "handle": "@woofers@universeodon.com",
            "body": "@ georgetakei ( https://universeodon.com/@georgetakei ) now hold on just a minute...\n\n# woof ( https://universeodon.com/tags/woof )",
            "publication_id": "113324128515491294",
            "tags": [
              "@georgetakei",
              "#woof"
            ],
            "author_url": "https://universeodon.com/users/woofers",
            "timestamp": 1729188972,
            "target": {
              "handle": "@georgetakei@universeodon.com",
              "body": "Just a little treat.",
              "media": [
                {
                  "address": "https://media.universeodon.com/media_attachments/files/113/319/346/314/075/495/original/26e989bcf15840a6.png",
                  "mime_type": "image/png"
                }
              ],
              "publication_id": "113319346448373294",
              "author_url": "https://universeodon.com/users/georgetakei",
              "timestamp": 1729116004
            },
            "target_url": "https://universeodon.com/users/georgetakei/statuses/113319346448373294"
          },
          "related_urls": [
            "https://universeodon.com/users/woofers/statuses/113324128515491294"
          ]
        }
      ]
    }
  ],
  "meta": {
    "cursor": "string"
  }
}

Batch Get Federated Accounts Activities (Beta)

Body

Request Body

accountsarray<string>

limitinteger

action_limitinteger

cursorstring

since_timestampinteger

until_timestampinteger

successboolean

directionstring

networkstring

tagstring

typearray<string>

platformstring

Response