Inconsistency in API output

[thagxt]

There's an annoying inconsistency in the API. The Latest posts' output is different from older ones.

https://api.tumblr.com/v2/blog/MY-BLOG/posts/photo/?api_key=MY-API-KEY&offset=80&page_number=5

The newest posts output is like so:
body": "<figure class=\"tmblr-full\" data-orig-height=\"2048\" data-orig-width=\"1365\"><img src=\"https://64.media.tumblr.com/.../s640x960/..85.jpg\" data-orig-height=\"2048\" data-orig-width=\"1365\"></figure><p>description</p>"

But the oldest doesn't have the body, instead they have:

photos": [
    {
        "caption": "",
        "original_size": {
            "url": "https://64.media.tumblr.com/.../tumblr_xxl_1280.jpg",

Both are PHOTO posts. Why is that?

[cyle]

This is likely a consequence of the newer post being saved in the Neue Post Format, and the older one being saved in the legacy format. Generally speaking, post types are becoming deprecated on Tumblr under the hood. You can read more about this here and on the Engineering blog in general, as well as the documentation in this repo for the NPF spec. I strongly encourage you to check out leveraging ?npf=true and the Neue Post Format JSON so you can get consistent results here. You can still use filters like /posts/photo, but it may not always work the way you expect for new posts, see the legacy post type mapping here. Hope this helps!

[sorin-costea]

Just to understand better, you mean that the above weird answer is a consequence of requesting a NPF post over the old API?

[cyle]

Yes, exactly. Sorry if that was a bit confusing.

All of the current API endpoints for fetching posts (like the one above) can possibly return legacy posts alongside new NPF posts, depending on how the post was made. To maintain backwards compatibility, new NPF posts will look and act like legacy text/regular type posts using these endpoints (hence why they have body set). You can change this behavior and have post content served consistently as NPF by setting npf=true via a query string parameter, which is more closely aligned with how we deal with post content within Tumblr's official clients.

[thagxt]

Thank you for your answer @cyle! I've tried and it works with npf=true.
I think you should state that in the docs, it's not really clear.

[cyle]

I think you should state that in the docs, it's not really clear.

Sure, happy to try to make this clearer. I'll see what I can do. 👌

[cyle]

Updated the docs with some blurbs about this, FYI ba6c02e