Skip to content

listPersonMoments

GET
/people/{personId}/moments
curl --request GET \
  --url 'http://localhost:8080/api/v1/people/per_01j9x3k8m2q4r5s6t7v8w9y0z1/moments?kind=story&limit=30' \
  --cookie hs_session=<hs_session>

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
personId
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/

Query Parameters

Section titled “Query Parameters”
kind
string
Allowed values: story post video link text
limit
integer
default: 30 >= 1 <= 100
cursor
string
<= 512 characters

Responses

Section titled “Responses”

200

Section titled “200”

Moments, newest first.

Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/
person
required
object
id
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/
displayName
required
string
relationLabel
string | null
kind
required
string
Allowed values: family friend creator other
closeness
required

1 = closest. Weights the feed and hearth picks.

integer
>= 1 <= 3
avatar
One of:
object
id
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/
url
required

Signed URL, valid 24 h.

string
thumbUrl
string
cardUrl
string
posterUrl
string
mime
required
string
width
integer
height
integer
durationMs
integer
blurhash
string
alt
string
account
required
object
id
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/
platform
required
string
Allowed values: instagram facebook line wechat bluesky x douyin xiaohongshu truthsocial
handle
required
string
displayName
string | null
profileUrl
required
string format: uri
deepLinks
required

Client picks app link on mobile when installed, else web.

object
web
required
string format: uri
ios
string
android
string
copyValue

Value to copy when no link exists (e.g. WeChat ID).

string
hintKey

I18n key with instructions, e.g. “platformWechatOpenHint”.

string
kind
required
string
Allowed values: story post video link text
text
string | null
lang
string | null
url
required
string format: uri
publishedAt
required
string format: date-time
expiresAt
One of:
string format: date-time
media
required
Array<object>
object
id
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/
url
required

Signed URL, valid 24 h.

string
thumbUrl
string
cardUrl
string
posterUrl
string
mime
required
string
width
integer
height
integer
durationMs
integer
blurhash
string
alt
string
seen
required
boolean
source
required
string
Allowed values: server agent extension
capturedBy
One of:
object
id
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/
displayName
required
string
avatar
One of:
object
id
required
string
/^[a-z]{2,3}_[0-9a-hjkmnp-tv-z]{26}$/
url
required

Signed URL, valid 24 h.

string
thumbUrl
string
cardUrl
string
posterUrl
string
mime
required
string
width
integer
height
integer
durationMs
integer
blurhash
string
alt
string
summary

AI-written summary in summaryLocale; null when none or hidden by the viewer’s setting.

string | null
summaryLocale
One of:
string
Allowed values: en zh-Hans th
nextCursor
required
string | null

Examples

Exampleseed

Derived from fixtures/seed.json.

{
  "items": [
    {
      "account": {
        "deepLinks": {
          "android": "https://www.instagram.com/_u/mom.wong.bkk/",
          "ios": "instagram://user?username=mom.wong.bkk",
          "web": "https://www.instagram.com/mom.wong.bkk/"
        },
        "displayName": null,
        "handle": "mom.wong.bkk",
        "id": "acc_01j93283xpmc4y04hy7rmmt7y7",
        "platform": "instagram",
        "profileUrl": "https://www.instagram.com/mom.wong.bkk/"
      },
      "capturedBy": {
        "avatar": null,
        "displayName": "Mali",
        "id": "mem_01j9kt0d8rwgmhnmxkmv0frnr0"
      },
      "expiresAt": "2026-10-18T07:30:00.000Z",
      "id": "mom_01j9nrjezabk0hz8xwak44q3yj",
      "kind": "story",
      "lang": null,
      "media": [
        {
          "alt": "White orchids in a clay pot",
          "cardUrl": "/fixtures/media/orchid.jpg",
          "height": 240,
          "id": "med_01j9a1b2c3d4e5f6g7h8j9k003",
          "mime": "image/jpeg",
          "thumbUrl": "/fixtures/media/orchid.jpg",
          "url": "/fixtures/media/orchid.jpg",
          "width": 320
        }
      ],
      "person": {
        "avatar": null,
        "closeness": 1,
        "displayName": "Mom",
        "id": "per_01j9wst6a8vjc69r66y6fj70t5",
        "kind": "family",
        "relationLabel": "แม่"
      },
      "publishedAt": "2026-10-17T07:30:00.000Z",
      "seen": false,
      "source": "extension",
      "summary": null,
      "summaryLocale": null,
      "text": null,
      "url": "https://www.instagram.com/stories/mom.wong.bkk/3456789012345678903/"
    },
    {
      "account": {
        "deepLinks": {
          "android": "https://www.instagram.com/_u/mom.wong.bkk/",
          "ios": "instagram://user?username=mom.wong.bkk",
          "web": "https://www.instagram.com/mom.wong.bkk/"
        },
        "displayName": null,
        "handle": "mom.wong.bkk",
        "id": "acc_01j93283xpmc4y04hy7rmmt7y7",
        "platform": "instagram",
        "profileUrl": "https://www.instagram.com/mom.wong.bkk/"
      },
      "capturedBy": {
        "avatar": null,
        "displayName": "Mali",
        "id": "mem_01j9kt0d8rwgmhnmxkmv0frnr0"
      },
      "expiresAt": "2026-10-18T07:12:00.000Z",
      "id": "mom_01j991j97j1nk24fm0mgptj50b",
      "kind": "story",
      "lang": null,
      "media": [
        {
          "alt": "Market aisle with flower garlands",
          "cardUrl": "/fixtures/media/market-2.jpg",
          "height": 240,
          "id": "med_01j9a1b2c3d4e5f6g7h8j9k002",
          "mime": "image/jpeg",
          "thumbUrl": "/fixtures/media/market-2.jpg",
          "url": "/fixtures/media/market-2.jpg",
          "width": 320
        }
      ],
      "person": {
        "avatar": null,
        "closeness": 1,
        "displayName": "Mom",
        "id": "per_01j9wst6a8vjc69r66y6fj70t5",
        "kind": "family",
        "relationLabel": "แม่"
      },
      "publishedAt": "2026-10-17T07:12:00.000Z",
      "seen": false,
      "source": "extension",
      "summary": null,
      "summaryLocale": null,
      "text": null,
      "url": "https://www.instagram.com/stories/mom.wong.bkk/3456789012345678902/"
    },
    {
      "account": {
        "deepLinks": {
          "android": "https://www.instagram.com/_u/mom.wong.bkk/",
          "ios": "instagram://user?username=mom.wong.bkk",
          "web": "https://www.instagram.com/mom.wong.bkk/"
        },
        "displayName": null,
        "handle": "mom.wong.bkk",
        "id": "acc_01j93283xpmc4y04hy7rmmt7y7",
        "platform": "instagram",
        "profileUrl": "https://www.instagram.com/mom.wong.bkk/"
      },
      "capturedBy": {
        "avatar": null,
        "displayName": "Mali",
        "id": "mem_01j9kt0d8rwgmhnmxkmv0frnr0"
      },
      "expiresAt": "2026-10-18T07:00:00.000Z",
      "id": "mom_01j9adj9t141gzfk8s7x1yyg4j",
      "kind": "story",
      "lang": null,
      "media": [
        {
          "alt": "Market stall with oranges and bananas",
          "cardUrl": "/fixtures/media/market-1.jpg",
          "height": 240,
          "id": "med_01j9a1b2c3d4e5f6g7h8j9k001",
          "mime": "image/jpeg",
          "thumbUrl": "/fixtures/media/market-1.jpg",
          "url": "/fixtures/media/market-1.jpg",
          "width": 320
        }
      ],
      "person": {
        "avatar": null,
        "closeness": 1,
        "displayName": "Mom",
        "id": "per_01j9wst6a8vjc69r66y6fj70t5",
        "kind": "family",
        "relationLabel": "แม่"
      },
      "publishedAt": "2026-10-17T07:00:00.000Z",
      "seen": false,
      "source": "extension",
      "summary": "แม่แชร์ภาพตลาดนัดวันอาทิตย์: ส้ม กล้วยไม้ และแผงทุเรียน",
      "summaryLocale": "th",
      "text": null,
      "url": "https://www.instagram.com/stories/mom.wong.bkk/3456789012345678901/"
    }
  ],
  "nextCursor": null
}