Discover

GET/api/v1.1/discover/posts/trending

Get trending posts

Pixelfed only User token

Query parameters

rangestring

Returns

curl "https://pixelfed.social/api/v1.1/discover/posts/trending?range=daily" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1.1/discover/posts/trending?range=daily", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const posts = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1.1/discover/posts/trending",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
    params={
        "range": "daily",
    },
)

posts = res.json()

use Illuminate\Support\Facades\Http;

$posts = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1.1/discover/posts/trending', [
        'range' => 'daily',
    ])
    ->json();

Response

[{
  "id": "728341901556629504",
  "shortcode": "kG7vQ2pX",
  "url": "https://pixelfed.social/p/dansup/728341901556629504",
  "content": "Golden hour at the pier",
  "content_text": "Golden hour at the pier",
  "created_at": "2026-09-14T17:42:10.000Z",
  "favourites_count": 212,
  "reblogs_count": 18,
  "reply_count": 9,
  "sensitive": false,
  "visibility": "public",
  "pf_type": "photo",
  "local": true,
  "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"
  }],
  "account": {
    "id": "2",
    "username": "dansup",
    "acct": "dansup",
    "display_name": "dansup",
    "avatar": "https://pixelfed.social/storage/avatars/2/avatar.jpg"
  }
}]

{
  "message": "The selected range is invalid.",
  "errors": {
    "range": ["The selected range is invalid."]
  }
}

GET/api/v1.1/discover/posts/hashtags

Get trending hashtags

Pixelfed only User token

Returns

curl "https://pixelfed.social/api/v1.1/discover/posts/hashtags" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1.1/discover/posts/hashtags", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const hashtags = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1.1/discover/posts/hashtags",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
)

hashtags = res.json()

use Illuminate\Support\Facades\Http;

$hashtags = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1.1/discover/posts/hashtags')
    ->json();

Response

[{
  "id": 18342,
  "total": 486,
  "name": "#autumn",
  "hashtag": "autumn",
  "url": "https://pixelfed.social/discover/tags/autumn"
}, {
  "id": 902,
  "total": 311,
  "name": "#filmphotography",
  "hashtag": "filmphotography",
  "url": "https://pixelfed.social/discover/tags/filmphotography"
}]

{
  "error": "Unauthenticated."
}

GET/api/v1.1/discover/posts/network/trending

Get network trending posts

Pixelfed only User token

Returns

curl "https://pixelfed.social/api/v1.1/discover/posts/network/trending" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

const res = await fetch("https://pixelfed.social/api/v1.1/discover/posts/network/trending", {
  headers: {
    Accept: "application/json",
    Authorization: `Bearer ${token}`,
  },
});

const posts = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1.1/discover/posts/network/trending",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
)

posts = res.json()

use Illuminate\Support\Facades\Http;

$posts = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1.1/discover/posts/network/trending')
    ->json();

Response

[{
  "id": "731012004466233344",
  "url": "https://photog.example/p/ines/731012004466233344",
  "content": "First snow on the ridge",
  "created_at": "2026-10-16T19:03:51.000Z",
  "favourites_count": 1208,
  "sensitive": false,
  "visibility": "public",
  "pf_type": "photo",
  "local": false,
  "media_attachments": [{
    "id": "731012009113522176",
    "type": "image",
    "url": "https://photog.example/storage/m/_v2/ridge.jpg"
  }],
  "account": {
    "id": "509981120334872576",
    "username": "ines",
    "acct": "ines@photog.example",
    "display_name": "Ines"
  }
}]

{
  "error": "Record not found"
}

GET/api/v1/discover/posts

Get suggested posts

Pixelfed only User token Scope read

Query parameters

limitinteger

Returns

curl "https://pixelfed.social/api/v1/discover/posts" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

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

const discover = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1/discover/posts",
    headers={"Accept": "application/json", "Authorization": f"Bearer {token}"},
)

discover = res.json()

use Illuminate\Support\Facades\Http;

$discover = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1/discover/posts')
    ->json();

Response

{
  "posts": [{
    "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,
    "favourites_count": 212,
    "media_attachments": [{
      "id": "728341067224219648",
      "type": "image",
      "url": "https://pixelfed.social/storage/m/_v2/2/pier.jpg"
    }],
    "account": {
      "id": "2",
      "username": "dansup",
      "acct": "dansup"
    }
  }]
}

{
  "error": ""
}

GET/api/v1.2/discover/accounts/popular

Get popular accounts

Pixelfed only User token Scope read

Query parameters

limitinteger

cursorstring

Returns

curl "https://pixelfed.social/api/v1.2/discover/accounts/popular?limit=2" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

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

const accounts = await res.json();

import requests

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

accounts = res.json()

use Illuminate\Support\Facades\Http;

$accounts = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1.2/discover/accounts/popular', [
        'limit' => 2,
    ])
    ->json();

Response

[{
  "id": "412760184563377",
  "username": "jonas",
  "acct": "jonas",
  "display_name": "Jonas Berg",
  "locked": false,
  "followers_count": 9310,
  "following_count": 204,
  "statuses_count": 96,
  "note_text": "Ferries, fog and 35mm.",
  "url": "https://pixelfed.social/jonas",
  "avatar": "https://pixelfed.social/storage/avatars/412760184563377/avatar.jpg",
  "local": true
}, {
  "id": "498812004377211904",
  "username": "tove",
  "acct": "tove@photog.example",
  "display_name": "Tove",
  "locked": false,
  "followers_count": 8122,
  "url": "https://photog.example/tove",
  "avatar": "https://photog.example/storage/avatars/tove.jpg",
  "local": false
}]

{
  "error": ""
}

GET/api/v1.1/discover/accounts/popular

Get popular accounts (v1.1)

Pixelfed only User token Scope read

Returns

curl "https://pixelfed.social/api/v1.1/discover/accounts/popular" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer $TOKEN"

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

const accounts = await res.json();

import requests

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

accounts = res.json()

use Illuminate\Support\Facades\Http;

$accounts = Http::acceptJson()
    ->withToken($token)
    ->get('https://pixelfed.social/api/v1.1/discover/accounts/popular')
    ->json();

Response

[{
  "id": "412760184563377",
  "username": "jonas",
  "acct": "jonas",
  "display_name": "Jonas Berg",
  "followers_count": 9310,
  "url": "https://pixelfed.social/jonas",
  "avatar": "https://pixelfed.social/storage/avatars/412760184563377/avatar.jpg",
  "local": true
}]

{
  "error": ""
}

GET/api/landing/v1/directory

Get the profile directory

Pixelfed only No token

Query parameters

cursorstring

Returns

curl "https://pixelfed.social/api/landing/v1/directory" \
  -H "Accept: application/json"

const res = await fetch("https://pixelfed.social/api/landing/v1/directory", {
  headers: {
    Accept: "application/json",
  },
});

const directory = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/landing/v1/directory",
    headers={"Accept": "application/json"},
)

directory = res.json()

use Illuminate\Support\Facades\Http;

$directory = Http::acceptJson()->get('https://pixelfed.social/api/landing/v1/directory')->json();

Response

{
  "data": [{
    "id": 2,
    "name": "dansup",
    "username": "dansup",
    "url": "https://pixelfed.social/dansup",
    "avatar": "https://pixelfed.social/storage/avatars/2/avatar.jpg",
    "following_count": 187,
    "followers_count": 1294,
    "statuses_count": 342,
    "bio": "Harbour walks before work. Tallinn."
  }],
  "links": {
    "first": null,
    "last": null,
    "prev": null,
    "next": "https://pixelfed.social/api/landing/v1/directory?cursor=eyJwcm9maWxlcy51cGRhdGVkX2F0IjoiMjAyNi0xMC0xNSJ9"
  },
  "meta": {
    "path": "https://pixelfed.social/api/landing/v1/directory",
    "per_page": 20,
    "next_cursor": "eyJwcm9maWxlcy51cGRhdGVkX2F0IjoiMjAyNi0xMC0xNSJ9",
    "prev_cursor": null
  }
}

{
  "error": "Record not found"
}

GET/api/v1.1/directory/listing

Get the server directory listing

Pixelfed only No token

Query parameters

skstringrequired

Returns

curl "https://pixelfed.social/api/v1.1/directory/listing?sk=3f9a1c7e5b2d48a6" \
  -H "Accept: application/json"

const res = await fetch("https://pixelfed.social/api/v1.1/directory/listing?sk=3f9a1c7e5b2d48a6", {
  headers: {
    Accept: "application/json",
  },
});

const listing = await res.json();

import requests

res = requests.get(
    "https://pixelfed.social/api/v1.1/directory/listing",
    headers={"Accept": "application/json"},
    params={
        "sk": "3f9a1c7e5b2d48a6",
    },
)

listing = res.json()

use Illuminate\Support\Facades\Http;

$listing = Http::acceptJson()->get('https://pixelfed.social/api/v1.1/directory/listing', [
    'sk' => '3f9a1c7e5b2d48a6',
])->json();

Response

{
  "_domain": "pixelfed.social",
  "_hash": "9b1f6c2e0d7a4e58b3c1f2a9d8e7c6b5a4f3e2d1c0b9a8f7e6d5c4b3a2f1e0d9",
  "_sk": "3f9a1c7e5b2d48a6",
  "_ts": 1792118400,
  "activitypub_enabled": true,
  "admin": {
    "id": "2",
    "username": "dansup",
    "display_name": "dansup"
  },
  "contact_email": "admin@pixelfed.social",
  "curated_onboarding": false,
  "feature_config": {
    "media_types": ["image/jpeg", "image/png", "video/mp4"],
    "max_photo_size": 15000,
    "max_caption_length": 500,
    "max_album_length": 10,
    "account_deletion": true
  },
  "features_enabled": {
    "stories": true
  },
  "is_eligible": true,
  "oauth_enabled": true,
  "open_registration": true,
  "primary_locale": "en",
  "stats": {
    "user_count": 41822,
    "post_count": 2298114
  },
  "summary": "Photo sharing for everyone.",
  "version": "0.12.6"
}

{
  "error": ""
}

{
  "error": "Record not found"
}

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