[Request] shelf API doesn't return complete Post data.

[mohammadrafigh]

Currently, when we call /api/me/shelf/item/${itemUUID}, We get a non-complete Post object, So to get the exact Post we tried to get it using Mastodon API /api/v1/statuses/${post_id} with the provided post_id from shelf response. But it throws 404 which means the post_id returned from shelf API is not actually an ActivityPub post_id.
There should be a way to get complete post by user, Either using shelf API or Mastodon API.
Currently I'm stuck here.

If there is an undocumented way to get the complete post I would appreciate to know it.

[alphatownsman]

it throws 404

can you share an example (if it's not a public item on your shelf, just DM in discord)

[mohammadrafigh]

Sure. Here is the response from shelf endpoint for item 2c5QBUV1feGwuCMiwkMATL:

{
  "shelf_type": "complete",
  "visibility": 0,
  "post_id": 494397148316661900,
  "item": {
    "type": "TVSeason",
    "title": "Love, Death & Robots Season 3",
    "description": "艾美奖获奖动画选集《爱、死亡 & 机器人》第三部回归，由蒂姆·米勒（《死侍》《终结者：黑暗命运》）和大卫·芬奇（《心灵猎人》《曼克》）担任监制。恐怖、想象力和美在新剧集中完美融合，从揭示古老的邪恶力量到喜剧般的末日，剧集以标志性的巧思和创造性的视觉效果，为观众带来令人震惊的奇幻、恐怖和科幻短篇故事。",
    "localized_title": [
      {
        "lang": "zh-cn",
        "text": "爱，死亡和机器人 第三季"
      },
      {
        "lang": "en",
        "text": "Love, Death & Robots"
      },
      {
        "lang": "zh-cn",
        "text": "爱 x 死 x 机器人(台)"
      },
      {
        "lang": "zh-cn",
        "text": "爱 · 死 · 机械人(港)"
      },
      {
        "lang": "zh-cn",
        "text": "爱、死亡 + 机器人"
      },
      {
        "lang": "zh-cn",
        "text": "爱、死亡 & 机器人"
      },
      {
        "lang": "zh-cn",
        "text": "爱情，死亡与机器人"
      },
      {
        "lang": "zh-cn",
        "text": "Love, Death & Robots 第 3 季"
      },
      {
        "lang": "es",
        "text": "Volumen 3"
      }
    ],
    "localized_description": [
      {
        "lang": "zh-cn",
        "text": "艾美奖获奖动画选集《爱、死亡 & 机器人》第三部回归，由蒂姆·米勒（《死侍》《终结者：黑暗命运》）和大卫·芬奇（《心灵猎人》《曼克》）担任监制。恐怖、想象力和美在新剧集中完美融合，从揭示古老的邪恶力量到喜剧般的末日，剧集以标志性的巧思和创造性的视觉效果，为观众带来令人震惊的奇幻、恐怖和科幻短篇故事。"
      },
      {
        "lang": "zh-cn",
        "text": "这部荣获艾美奖的动画系列剧由蒂姆·米勒和大卫·芬奇联袂打造，即将上映的第三季将带来离奇的世界、奇怪的生物和曲折的故事。"
      },
      {
        "lang": "es",
        "text": "Tercer volumen de la antología de cortometrajes de animación para adultos \"Love, Death + Robots\", creada por Tim Miller (\"Deadpool\"). Presentará nuevos trabajos de directores como Alberto Mielgo (\"La testigo\", T1), Jerome Chen (\"Afortunados 13\", T1) o Jennifer Yuh (\"Respuesta evolutiva\", T2), una secuela del corto \"Tres robots\" (T1) y el debut en el mundo de la animación de David Fincher."
      }
    ],
    "cover_image_url": "https://neodb.social/m/movie/2022/11/07ee90bcbf-cf32-4611-88df-1a708c4521dd.jpg",
    "rating": 7.8,
    "rating_count": 1100,
    "rating_distribution": [
      0,
      2,
      19,
      53,
      24
    ],
    "tags": [
      "2020s",
      "2022",
      "netflix",
      "剧情",
      "剧集",
      "动作",
      "动画",
      "动画片",
      "动画短片",
      "奇幻",
      "惊悚",
      "爱死机",
      "电视剧",
      "短片",
      "科幻",
      "网飞",
      "美剧",
      "美国",
      "美国动画"
    ],
    "brief": "艾美奖获奖动画选集《爱、死亡 & 机器人》第三部回归，由蒂姆·米勒（《死侍》《终结者：黑暗命运》）和大卫·芬奇（《心灵猎人》《曼克》）担任监制。恐怖、想象力和美在新剧集中完美融合，从揭示古老的邪恶力量到喜剧般的末日，剧集以标志性的巧思和创造性的视觉效果，为观众带来令人震惊的奇幻、恐怖和科幻短篇故事。",
    "id": "https://neodb.social/tv/season/2c5QBUV1feGwuCMiwkMATL",
    "uuid": "2c5QBUV1feGwuCMiwkMATL",
    "url": "/tv/season/2c5QBUV1feGwuCMiwkMATL",
    "api_url": "/api/tv/season/2c5QBUV1feGwuCMiwkMATL",
    "category": "tv",
    "parent_uuid": "2ATZ0jLDGLF8LPVwicYP1j",
    "display_title": "Love, Death & Robots Season 3",
    "external_resources": [
      {
        "url": "https://eggplant.place/tv/season/26t5btJ9RxRJpVlcqHLHKW"
      },
      {
        "url": "https://movie.douban.com/subject/35436582/"
      },
      {
        "url": "https://www.themoviedb.org/tv/86831/season/3"
      },
      {
        "url": "https://fantastika.social/tv/season/0OBPTckbOXxRP5L4caPGwZ"
      }
    ]
  },
  "created_time": "2025-09-26T13:37:45.535Z",
  "comment_text": "Really liked episode #1 and #7",
  "rating_grade": 8,
  "tags": []
}

The response doesn't include enough data to parse the post properly (like how posts API provides), So I need to get the post data from Mastodon API. The returned post_id is 494397148316661900 so I'm trying to fetch it using Mastodon API https://neodb.social/api/v1/statuses/494397148316661900 which returns 404.

[alphatownsman]

it's likely not an issue of neodb itself, but the swagger ui which default to a behaviour that limits accurate int value to 2^53 (as js number) so the value is displayed incorrectly in dev console.

swagger-api/swagger-ui#2030

on a hindsight, I should probably have exposed this as str.

[mohammadrafigh]

I doubt so, you can try it with curl still the same results here.

[alphatownsman]

Would you mind open the network tab of browser, and hit shelf endpoint for item 2c5QBUV1feGwuCMiwkMATL again? You should be able to see different id in the actual response like:

[mohammadrafigh]

Yeah, I tried it, thanks for highlighting. There is a "JS: " parsed value which is the same as what I get in my app... that's why I still get the 404 in my app. I think the ids should be returned as string as you mentioned to prevent this large number parsing in different languages. Some use 4 bytes some use 8 bytes so, I cannot get the correct post_id in the app with normally parsing returned JSON. Should I triage it in NeoComment or you will update the API?

[alphatownsman]

I plan to change it but probably in a few weeks or so after I give a notice, so that other clients have time to add compatible code and release thru app stores.

[mohammadrafigh]

Great, thanks for your efforts.