Timelines

GET/api/v1/timelines/home

Home timeline

Mastodon compatible Supports _pe User token Scope read

Query parameters

limitinteger

max_idstring

min_idstring

include_reblogsboolean

photos_reblogs_onlyboolean

_peboolean

Returns

curl "https://pixelfed.social/api/v1/timelines/home?limit=5" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1/timelines/home?limit=5", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const posts = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1/timelines/home",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
    params={
        "limit": 5,
    },
)

posts = res.json()

use Illuminate\Support\Facades\Http;

$posts = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1/timelines/home', [
        'limit' => 5,
    ])
    ->json();

Response

[{
  "id": "728341901556629504",
  "created_at": "2026-09-14T17:42:10.000Z",
  "url": "https://pixelfed.social/p/dansup/728341901556629504",
  "content": "Golden hour at the pier",
  "visibility": "public",
  "sensitive": false,
  "spoiler_text": "",
  "reblog": null,
  "favourited": false,
  "reblogged": false,
  "bookmarked": false,
  "favourites_count": 12,
  "reblogs_count": 1,
  "replies_count": 2,
  "media_attachments": [{
    "id": "728341067224219648",
    "type": "image",
    "url": "https://pixelfed.social/storage/m/_v2/2/pier.jpg",
    "preview_url": "https://pixelfed.social/storage/m/_v2/2/pier_thumb.jpg",
    "description": "Wooden pier at sunset, two people fishing at the far end",
    "blurhash": "UJF}Qo~W9aIV4.xuRjWB00WB-pof",
    "meta": {
      "original": {
        "width": 1080,
        "height": 1350,
        "aspect": 0.8
      }
    }
  }],
  "account": {
    "id": "2",
    "username": "dansup",
    "acct": "dansup",
    "display_name": "dansup",
    "url": "https://pixelfed.social/dansup"
  }
}]

[]

{
  "error": "Unauthenticated."
}

GET/api/v1.1/accounts/timelines/home

Home timeline (Pixelfed path)

Pixelfed only Supports _pe User token Scope read

Query parameters

limitinteger

max_idstring

min_idstring

include_reblogsboolean

photos_reblogs_onlyboolean

_peboolean

Returns

curl "https://pixelfed.social/api/v1.1/accounts/timelines/home?limit=5" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1.1/accounts/timelines/home?limit=5", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const posts = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1.1/accounts/timelines/home",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
    params={
        "limit": 5,
    },
)

posts = res.json()

use Illuminate\Support\Facades\Http;

$posts = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1.1/accounts/timelines/home', [
        'limit' => 5,
    ])
    ->json();

Response

[{
  "id": "728341901556629504",
  "created_at": "2026-09-14T17:42:10.000Z",
  "url": "https://pixelfed.social/p/dansup/728341901556629504",
  "content": "Golden hour at the pier",
  "visibility": "public",
  "reblog": null,
  "favourited": false,
  "favourites_count": 12,
  "reblogs_count": 1,
  "replies_count": 2,
  "media_attachments": [{
    "id": "728341067224219648",
    "type": "image",
    "url": "https://pixelfed.social/storage/m/_v2/2/pier.jpg"
  }],
  "account": {
    "id": "2",
    "username": "dansup",
    "acct": "dansup"
  }
}]

{
  "error": "Unauthenticated."
}

GET/api/v1/timelines/public

Public timeline

Mastodon compatible Supports _pe User token

Query parameters

localboolean

remoteboolean

limitinteger

max_idstring

min_idstring

_peboolean

Returns

curl "https://pixelfed.social/api/v1/timelines/public?remote=true&limit=10" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1/timelines/public?remote=true&limit=10", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const posts = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1/timelines/public",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
    params={
        "remote": True,
        "limit": 10,
    },
)

posts = res.json()

use Illuminate\Support\Facades\Http;

$posts = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1/timelines/public', [
        'remote' => true,
        'limit' => 10,
    ])
    ->json();

Response

[{
  "id": "728355012774117376",
  "created_at": "2026-09-14T18:34:02.000Z",
  "url": "https://pixelfed.social/p/jonas/728355012774117376",
  "content": "First frost on the allotment",
  "visibility": "public",
  "sensitive": false,
  "reblog": null,
  "favourited": false,
  "reblogged": false,
  "bookmarked": false,
  "favourites_count": 4,
  "reblogs_count": 0,
  "replies_count": 0,
  "media_attachments": [{
    "id": "728354900331618304",
    "type": "image",
    "url": "https://pixelfed.social/storage/m/_v2/412760184563377/frost.jpg",
    "preview_url": "https://pixelfed.social/storage/m/_v2/412760184563377/frost_thumb.jpg",
    "description": "Frost on cabbage leaves in early morning light"
  }],
  "account": {
    "id": "412760184563377",
    "username": "jonas",
    "acct": "jonas",
    "display_name": "Jonas",
    "url": "https://pixelfed.social/jonas"
  }
}]

{
  "message": "The limit field must be at least 1.",
  "errors": {
    "limit": ["The limit field must be at least 1."]
  }
}

GET/api/v1/timelines/tag/{hashtag}

Hashtag timeline

Mastodon compatible Supports _pe User token Scope read

Path parameters

hashtagstringrequired

Query parameters

limitinteger

only_mediaboolean

cursorstring

min_idstring

max_idstring

_peboolean

Returns

curl "https://pixelfed.social/api/v1/timelines/tag/goldenhour?limit=10" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1/timelines/tag/goldenhour?limit=10", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const posts = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1/timelines/tag/goldenhour",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
    params={
        "limit": 10,
    },
)

posts = res.json()

use Illuminate\Support\Facades\Http;

$posts = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1/timelines/tag/goldenhour', [
        'limit' => 10,
    ])
    ->json();

Response

[{
  "id": "728341901556629504",
  "created_at": "2026-09-14T17:42:10.000Z",
  "url": "https://pixelfed.social/p/dansup/728341901556629504",
  "content": "Golden hour at the pier <a href=\"https://pixelfed.social/discover/tags/goldenhour\">#goldenhour</a>",
  "visibility": "public",
  "reblog": null,
  "favourited": false,
  "favourites_count": 12,
  "reblogs_count": 1,
  "replies_count": 2,
  "tags": [{
    "name": "goldenhour",
    "url": "https://pixelfed.social/discover/tags/goldenhour"
  }],
  "media_attachments": [{
    "id": "728341067224219648",
    "type": "image",
    "url": "https://pixelfed.social/storage/m/_v2/2/pier.jpg"
  }],
  "account": {
    "id": "2",
    "username": "dansup",
    "acct": "dansup"
  }
}]

{
  "error": "Invalid permissions for this action"
}

GET/api/v1/markers

Get a read marker

Mastodon compatible User token Scope read

Query parameters

timeline[]array of stringsrequired

Returns

curl "https://pixelfed.social/api/v1/markers?timeline[]=home" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1/markers?timeline[]=home", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const marker = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1/markers",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
    params={
        "timeline[]": "home",
    },
)

marker = res.json()

use Illuminate\Support\Facades\Http;

$marker = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1/markers', [
        'timeline[]' => 'home',
    ])
    ->json();

Response

{
  "last_read_id": "728341901556629504",
  "version": 3,
  "updated_at": "2026-09-14T19:02:44.118Z"
}

{
  "error": "Unauthenticated."
}

POST/api/v1/markers

Save a read marker

Mastodon compatible User token Scope write

Body parameters

home[last_read_id]string

notifications[last_read_id]string

Returns

curl -X POST "https://pixelfed.social/api/v1/markers" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "home": {
      "last_read_id": "728341901556629504"
    }
  }'

const res = await fetch("https://pixelfed.social/api/v1/markers", {
  method: "POST",
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    home: {
      last_read_id: "728341901556629504",
    },
  }),
});

const marker = await res.json();

import requests

res = requests.post(
    "https://pixelfed.social/api/v1/markers",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
    json={
        "home": {
            "last_read_id": "728341901556629504",
        },
    },
)

marker = res.json()

use Illuminate\Support\Facades\Http;

$marker = Http::acceptJson()
    ->withToken($token)
    ->post('https://pixelfed.social/api/v1/markers', [
        'home' => [
            'last_read_id' => '728341901556629504',
        ],
    ])
    ->json();

Response

{
  "last_read_id": "728341901556629504",
  "version": 4,
  "updated_at": "2026-09-14T19:05:10.502Z"
}

{
  "error": "Unauthenticated."
}

Pixelfed is free and open source software. Edit this page Report a docs issue