List posts with media for an actor

GET

/2/profile/{handle}/media

• FxBluesky API host

Returns a timeline page in the same shape as FxTwitter GET /2/profile/{handle}/media (code, results, cursor). handle may be a handle or DID. Pagination uses Bluesky app.bsky.feed.getAuthorFeed with filter=posts_with_media: cursor.bottom is the opaque next-page token (pass as cursor query param). cursor.top is always null.

Parameters

Path Parameters

handle

required

string

Example

bsky.app

Bluesky handle (e.g. user.bsky.social) or DID (did:plc:…)

Query Parameters

count

integer

default: 20 >= 1 <= 100

Page size (default 20)

cursor

string

Pagination cursor from prior response (cursor.bottom)

lang

string

Example

es

Target language (ISO 639-1 or BCP 47) for inline translation when available

Responses

200

Media timeline page

object

code

required

number

results

required

Array<object>

object

id

required

string

cid

string

at_uri

string

url

required

string

text

required

string

created_at

required

string

created_timestamp

required

number

likes

required

number

reposts

required

number

quotes

number

replies

required

number

quote

object recursive

poll

object

choices

required

Array<object>

object

label

required

string

count

required

number

percentage

required

number

total_votes

required

number

ends_at

required

string

time_left_en

required

string

author

required

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

required

string

nullable

banner_url

required

string

nullable

description

required

string

raw_description

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

location

required

string

url

required

string

protected

required

boolean

followers

required

number

following

required

number

statuses

required

number

media_count

required

number

likes

required

number

joined

required

string

website

required

object

url

required

string

display_url

required

string

birthday

object

day

number

month

number

year

number

verification

object

verified

required

boolean

type

required

string

nullable

Allowed values: organization government individual

verified_at

string

nullable

identity_verified

boolean

about_account

object

based_in

string

nullable

location_accurate

boolean

created_country_accurate

boolean

nullable

source

string

nullable

username_changes

object

count

required

number

last_changed_at

required

string

nullable

profile_embed

boolean

media

required

object

external

object

type

required

string

Allowed values: video

url

required

string

thumbnail_url

string

height

number

width

number

photos

Array<object>

object

id

string

format

string

type

required

string

Allowed values: photo gif

url

required

string

width

required

number

height

required

number

transcode_url

string

nullable

altText

string

videos

Array<object>

object

id

string

format

string

type

required

string

Allowed values: video gif

url

required

string

width

required

number

height

required

number

thumbnail_url

string

nullable

transcode_url

string

nullable

duration

required

number

filesize

number

formats

required

Array<object>

object

container

string

Allowed values: mp4 webm m3u8

codec

string

Allowed values: h264 hevc vp9 av1

bitrate

number

url

required

string

size

number

height

number

width

number

publisher

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

required

string

nullable

banner_url

required

string

nullable

description

required

string

raw_description

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

location

required

string

url

required

string

protected

required

boolean

followers

required

number

following

required

number

statuses

required

number

media_count

required

number

likes

required

number

joined

required

string

website

required

object

url

required

string

display_url

required

string

birthday

object

day

number

month

number

year

number

verification

object

verified

required

boolean

type

required

string

nullable

Allowed values: organization government individual

verified_at

string

nullable

identity_verified

boolean

about_account

object

based_in

string

nullable

location_accurate

boolean

created_country_accurate

boolean

nullable

source

string

nullable

username_changes

object

count

required

number

last_changed_at

required

string

nullable

profile_embed

boolean

all

Array

Any of:

object

object

id

string

format

string

type

required

string

Allowed values: photo gif

url

required

string

width

required

number

height

required

number

transcode_url

string

nullable

altText

string

object

object

id

string

format

string

type

required

string

Allowed values: video gif

url

required

string

width

required

number

height

required

number

thumbnail_url

string

nullable

transcode_url

string

nullable

duration

required

number

filesize

number

formats

required

Array<object>

object

container

string

Allowed values: mp4 webm m3u8

codec

string

Allowed values: h264 hevc vp9 av1

bitrate

number

url

required

string

size

number

height

number

width

number

publisher

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

required

string

nullable

banner_url

required

string

nullable

description

required

string

raw_description

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

location

required

string

url

required

string

protected

required

boolean

followers

required

number

following

required

number

statuses

required

number

media_count

required

number

likes

required

number

joined

required

string

website

required

object

url

required

string

display_url

required

string

birthday

object

day

number

month

number

year

number

verification

object

verified

required

boolean

type

required

string

nullable

Allowed values: organization government individual

verified_at

string

nullable

identity_verified

boolean

about_account

object

based_in

string

nullable

location_accurate

boolean

created_country_accurate

boolean

nullable

source

string

nullable

username_changes

object

count

required

number

last_changed_at

required

string

nullable

profile_embed

boolean

object

object

id

string

format

string

type

required

string

Allowed values: mosaic_photo

url

required

string

width

required

number

height

required

number

formats

required

object

webp

required

string

jpeg

required

string

object

object

id

string

format

string

type

required

string

url

required

string

width

required

number

height

required

number

mosaic

object

id

string

format

string

type

required

string

Allowed values: mosaic_photo

url

required

string

width

required

number

height

required

number

formats

required

object

webp

required

string

jpeg

required

string

broadcast

object

url

required

string

width

required

number

height

required

number

state

required

string

Allowed values: LIVE ENDED

broadcaster

required

object

username

required

string

display_name

required

string

id

required

string

stream

object

url

required

string

title

required

string

source

required

string

orientation

required

string

Allowed values: landscape portrait

broadcast_id

required

string

media_id

required

string

media_key

required

string

is_high_latency

required

boolean

thumbnail

required

object

original

required

object

url

required

string

small

object

url

required

string

medium

object

url

required

string

large

object

url

required

string

x_large

object

url

required

string

raw_text

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

lang

required

string

nullable

translation

object

text

required

string

source_lang

required

string

source_lang_en

required

string

target_lang

required

string

provider

required

string

possibly_sensitive

required

boolean

replying_to

required

object

screen_name

required

string

status

required

string

source

required

string

nullable

embed_card

required

string

Allowed values: tweet summary summary_large_image player

provider

required

string

Allowed values: bluesky

reposted_by

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

string

nullable

url

string

cursor

required

object

top

required

string

nullable

bottom

required

string

nullable

400

Invalid path or query parameters (e.g. count out of range)

object

code

required

number

Allowed values: 400

message

required

string

404

Actor not found

object

code

required

number

results

required

Array<object>

object

id

required

string

cid

string

at_uri

string

url

required

string

text

required

string

created_at

required

string

created_timestamp

required

number

likes

required

number

reposts

required

number

quotes

number

replies

required

number

quote

object recursive

poll

object

choices

required

Array<object>

object

label

required

string

count

required

number

percentage

required

number

total_votes

required

number

ends_at

required

string

time_left_en

required

string

author

required

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

required

string

nullable

banner_url

required

string

nullable

description

required

string

raw_description

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

location

required

string

url

required

string

protected

required

boolean

followers

required

number

following

required

number

statuses

required

number

media_count

required

number

likes

required

number

joined

required

string

website

required

object

url

required

string

display_url

required

string

birthday

object

day

number

month

number

year

number

verification

object

verified

required

boolean

type

required

string

nullable

Allowed values: organization government individual

verified_at

string

nullable

identity_verified

boolean

about_account

object

based_in

string

nullable

location_accurate

boolean

created_country_accurate

boolean

nullable

source

string

nullable

username_changes

object

count

required

number

last_changed_at

required

string

nullable

profile_embed

boolean

media

required

object

external

object

type

required

string

Allowed values: video

url

required

string

thumbnail_url

string

height

number

width

number

photos

Array<object>

object

id

string

format

string

type

required

string

Allowed values: photo gif

url

required

string

width

required

number

height

required

number

transcode_url

string

nullable

altText

string

videos

Array<object>

object

id

string

format

string

type

required

string

Allowed values: video gif

url

required

string

width

required

number

height

required

number

thumbnail_url

string

nullable

transcode_url

string

nullable

duration

required

number

filesize

number

formats

required

Array<object>

object

container

string

Allowed values: mp4 webm m3u8

codec

string

Allowed values: h264 hevc vp9 av1

bitrate

number

url

required

string

size

number

height

number

width

number

publisher

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

required

string

nullable

banner_url

required

string

nullable

description

required

string

raw_description

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

location

required

string

url

required

string

protected

required

boolean

followers

required

number

following

required

number

statuses

required

number

media_count

required

number

likes

required

number

joined

required

string

website

required

object

url

required

string

display_url

required

string

birthday

object

day

number

month

number

year

number

verification

object

verified

required

boolean

type

required

string

nullable

Allowed values: organization government individual

verified_at

string

nullable

identity_verified

boolean

about_account

object

based_in

string

nullable

location_accurate

boolean

created_country_accurate

boolean

nullable

source

string

nullable

username_changes

object

count

required

number

last_changed_at

required

string

nullable

profile_embed

boolean

all

Array

Any of:

object

object

id

string

format

string

type

required

string

Allowed values: photo gif

url

required

string

width

required

number

height

required

number

transcode_url

string

nullable

altText

string

object

object

id

string

format

string

type

required

string

Allowed values: video gif

url

required

string

width

required

number

height

required

number

thumbnail_url

string

nullable

transcode_url

string

nullable

duration

required

number

filesize

number

formats

required

Array<object>

object

container

string

Allowed values: mp4 webm m3u8

codec

string

Allowed values: h264 hevc vp9 av1

bitrate

number

url

required

string

size

number

height

number

width

number

publisher

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

required

string

nullable

banner_url

required

string

nullable

description

required

string

raw_description

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

location

required

string

url

required

string

protected

required

boolean

followers

required

number

following

required

number

statuses

required

number

media_count

required

number

likes

required

number

joined

required

string

website

required

object

url

required

string

display_url

required

string

birthday

object

day

number

month

number

year

number

verification

object

verified

required

boolean

type

required

string

nullable

Allowed values: organization government individual

verified_at

string

nullable

identity_verified

boolean

about_account

object

based_in

string

nullable

location_accurate

boolean

created_country_accurate

boolean

nullable

source

string

nullable

username_changes

object

count

required

number

last_changed_at

required

string

nullable

profile_embed

boolean

object

object

id

string

format

string

type

required

string

Allowed values: mosaic_photo

url

required

string

width

required

number

height

required

number

formats

required

object

webp

required

string

jpeg

required

string

object

object

id

string

format

string

type

required

string

url

required

string

width

required

number

height

required

number

mosaic

object

id

string

format

string

type

required

string

Allowed values: mosaic_photo

url

required

string

width

required

number

height

required

number

formats

required

object

webp

required

string

jpeg

required

string

broadcast

object

url

required

string

width

required

number

height

required

number

state

required

string

Allowed values: LIVE ENDED

broadcaster

required

object

username

required

string

display_name

required

string

id

required

string

stream

object

url

required

string

title

required

string

source

required

string

orientation

required

string

Allowed values: landscape portrait

broadcast_id

required

string

media_id

required

string

media_key

required

string

is_high_latency

required

boolean

thumbnail

required

object

original

required

object

url

required

string

small

object

url

required

string

medium

object

url

required

string

large

object

url

required

string

x_large

object

url

required

string

raw_text

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

lang

required

string

nullable

translation

object

text

required

string

source_lang

required

string

source_lang_en

required

string

target_lang

required

string

provider

required

string

possibly_sensitive

required

boolean

replying_to

required

object

screen_name

required

string

status

required

string

source

required

string

nullable

embed_card

required

string

Allowed values: tweet summary summary_large_image player

provider

required

string

Allowed values: bluesky

reposted_by

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

string

nullable

url

string

cursor

required

object

top

required

string

nullable

bottom

required

string

nullable

500

Upstream or processing error

object

code

required

number

results

required

Array<object>

object

id

required

string

cid

string

at_uri

string

url

required

string

text

required

string

created_at

required

string

created_timestamp

required

number

likes

required

number

reposts

required

number

quotes

number

replies

required

number

quote

object recursive

poll

object

choices

required

Array<object>

object

label

required

string

count

required

number

percentage

required

number

total_votes

required

number

ends_at

required

string

time_left_en

required

string

author

required

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

required

string

nullable

banner_url

required

string

nullable

description

required

string

raw_description

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

location

required

string

url

required

string

protected

required

boolean

followers

required

number

following

required

number

statuses

required

number

media_count

required

number

likes

required

number

joined

required

string

website

required

object

url

required

string

display_url

required

string

birthday

object

day

number

month

number

year

number

verification

object

verified

required

boolean

type

required

string

nullable

Allowed values: organization government individual

verified_at

string

nullable

identity_verified

boolean

about_account

object

based_in

string

nullable

location_accurate

boolean

created_country_accurate

boolean

nullable

source

string

nullable

username_changes

object

count

required

number

last_changed_at

required

string

nullable

profile_embed

boolean

media

required

object

external

object

type

required

string

Allowed values: video

url

required

string

thumbnail_url

string

height

number

width

number

photos

Array<object>

object

id

string

format

string

type

required

string

Allowed values: photo gif

url

required

string

width

required

number

height

required

number

transcode_url

string

nullable

altText

string

videos

Array<object>

object

id

string

format

string

type

required

string

Allowed values: video gif

url

required

string

width

required

number

height

required

number

thumbnail_url

string

nullable

transcode_url

string

nullable

duration

required

number

filesize

number

formats

required

Array<object>

object

container

string

Allowed values: mp4 webm m3u8

codec

string

Allowed values: h264 hevc vp9 av1

bitrate

number

url

required

string

size

number

height

number

width

number

publisher

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

required

string

nullable

banner_url

required

string

nullable

description

required

string

raw_description

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

location

required

string

url

required

string

protected

required

boolean

followers

required

number

following

required

number

statuses

required

number

media_count

required

number

likes

required

number

joined

required

string

website

required

object

url

required

string

display_url

required

string

birthday

object

day

number

month

number

year

number

verification

object

verified

required

boolean

type

required

string

nullable

Allowed values: organization government individual

verified_at

string

nullable

identity_verified

boolean

about_account

object

based_in

string

nullable

location_accurate

boolean

created_country_accurate

boolean

nullable

source

string

nullable

username_changes

object

count

required

number

last_changed_at

required

string

nullable

profile_embed

boolean

all

Array

Any of:

object

object

id

string

format

string

type

required

string

Allowed values: photo gif

url

required

string

width

required

number

height

required

number

transcode_url

string

nullable

altText

string

object

object

id

string

format

string

type

required

string

Allowed values: video gif

url

required

string

width

required

number

height

required

number

thumbnail_url

string

nullable

transcode_url

string

nullable

duration

required

number

filesize

number

formats

required

Array<object>

object

container

string

Allowed values: mp4 webm m3u8

codec

string

Allowed values: h264 hevc vp9 av1

bitrate

number

url

required

string

size

number

height

number

width

number

publisher

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

required

string

nullable

banner_url

required

string

nullable

description

required

string

raw_description

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

location

required

string

url

required

string

protected

required

boolean

followers

required

number

following

required

number

statuses

required

number

media_count

required

number

likes

required

number

joined

required

string

website

required

object

url

required

string

display_url

required

string

birthday

object

day

number

month

number

year

number

verification

object

verified

required

boolean

type

required

string

nullable

Allowed values: organization government individual

verified_at

string

nullable

identity_verified

boolean

about_account

object

based_in

string

nullable

location_accurate

boolean

created_country_accurate

boolean

nullable

source

string

nullable

username_changes

object

count

required

number

last_changed_at

required

string

nullable

profile_embed

boolean

object

object

id

string

format

string

type

required

string

Allowed values: mosaic_photo

url

required

string

width

required

number

height

required

number

formats

required

object

webp

required

string

jpeg

required

string

object

object

id

string

format

string

type

required

string

url

required

string

width

required

number

height

required

number

mosaic

object

id

string

format

string

type

required

string

Allowed values: mosaic_photo

url

required

string

width

required

number

height

required

number

formats

required

object

webp

required

string

jpeg

required

string

broadcast

object

url

required

string

width

required

number

height

required

number

state

required

string

Allowed values: LIVE ENDED

broadcaster

required

object

username

required

string

display_name

required

string

id

required

string

stream

object

url

required

string

title

required

string

source

required

string

orientation

required

string

Allowed values: landscape portrait

broadcast_id

required

string

media_id

required

string

media_key

required

string

is_high_latency

required

boolean

thumbnail

required

object

original

required

object

url

required

string

small

object

url

required

string

medium

object

url

required

string

large

object

url

required

string

x_large

object

url

required

string

raw_text

required

object

text

required

string

facets

required

Array<object>

object

type

required

Facet kind: e.g. url, mention, hashtag, bold, media, custom_emoji (Mastodon custom emoji image)

string

indices

required

Start and end UTF-16 indices

Array<number>

>= 2 items <= 2 items

original

string

replacement

string

display

string

id

string

lang

required

string

nullable

translation

object

text

required

string

source_lang

required

string

source_lang_en

required

string

target_lang

required

string

provider

required

string

possibly_sensitive

required

boolean

replying_to

required

object

screen_name

required

string

status

required

string

source

required

string

nullable

embed_card

required

string

Allowed values: tweet summary summary_large_image player

provider

required

string

Allowed values: bluesky

reposted_by

object

id

required

string

name

required

string

screen_name

required

string

avatar_url

string

nullable

url

string

cursor

required

object

top

required

string

nullable

bottom

required

string

nullable