# Tumblr Posts by user API (tumblr.user_posts)

- Canonical page: [https://everyinfra.com/en/tumblr-api/user_posts](https://everyinfra.com/en/tumblr-api/user_posts?utm_medium=ai_doc&utm_campaign=page_md)
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "tumblr", "action": "user_posts", "params": {...}}
- Price: $0.01279 per call ($12.79 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 50 per call
- Mode: sync; add "mode": "async" for slow tasks

Tumblr Posts by user reads one Tumblr blog, named by `username`, and lists its public posts, which can be text, photo, video, quote, link or audio posts. Each row carries the post text, link, post type, tags, note count, publish time and the blog's name and link. Artists' managers, brand teams and researchers use it to follow what a blog publishes and which posts draw reactions: tracking a creator's or brand's blog, studying how a community blog's posting mix changes, or archiving a blog's public posts.

Because a blog mixes these types, set `post_type` to one of them when you need only one kind, and compare engagement within a type. `note_count` merges likes and reblogs into one total that cannot be split. `tags` lists the tags the blog put on each post, which shows how it files its own content.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=tumblr&action=user_posts

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| username | not declared | yes | not declared | Blog short name or name.tumblr.com domain. Do not pass a full link containing https:// in this field; complete addresses belong in `url`. `profile` queries aggregate public blog data only. |
| post_type | not declared | no | not declared | Single post type for `search`, `tag`, or `user_posts`: `any` for unrestricted, `text`, `photo`, `video`, `quote`, `link`, or `audio`. This is not an array, and `profile` does not use this filter. |
| limit | integer (1–50) | no | 20 | The most rows to return in this call, an integer from 1 to 50. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| text | Body text with HTML removed, returned in full and never cut short (on a few platforms the list results themselves carry only an excerpt; the platform's field notes say so). |
| post_type | platform-native meaning |
| author_username | Author's username (@handle), usually usable in URLs. |
| author_name | Author's display name. |
| author_url | Link to the author's profile on the platform. |
| note_count | platform-native meaning |
| posted_at | Publish time in ISO 8601, UTC (for example 2026-08-07T12:34:56+00:00). Non-standard strings from the platform are passed through as is, so parse defensively. null means the platform does not disclose it. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |
| tags | Array of tags. An empty array, not null, when there are none. |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "tumblr",
  "action": "user_posts",
  "params": {
    "username": "staff"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "tumblr",
        "action": "user_posts",
        "params": {
            "username": "staff",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "tumblr",
  "action": "user_posts",
  "results": [
    {
      "id": "•••",
      "url": "https://staff.tumblr.com/post/828009069026721792/premium-just-got-better",
      "text": "Premium just got better Your feedback matters. Tumblr Premium now includes a few brand new, top-requested features. Saved Posts & Collections Never lose a post again. Use the bookmark icon to save any post you want to come back to, and sort them into private Collections. This is …",
      "post_type": "regular",
      "author_username": "staff",
      "author_name": "•••",
      "author_url": "https://staff.tumblr.com/•••",
      "note_count": 2600,
      "posted_at": "2026-09-17T13:16:22+00:00",
      "platform": "tumblr",
      "tags": [
        "tumblr premium",
        "new features"
      ]
    },
    {
      "id": "•••",
      "url": "https://staff.tumblr.com/post/822057428507049984/in-case-youre-looking-for-a-blog-thats-gone",
      "text": "changes : Deleted accounts can now be recovered up to 30 days later We’re making a big change to how account deletion works on Tumblr, and we’re really excited about it, because this is something that some of you have been requesting for… well… a literal decade. Before today, whe…",
      "post_type": "regular",
      "author_username": "staff",
      "author_name": "•••",
      "author_url": "https://staff.tumblr.com/•••",
      "note_count": 12368,
      "posted_at": "2026-07-13T20:37:36+00:00",
      "platform": "tumblr",
      "tags": [
        "tumblr"
      ]
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### What do I pass as `username`?

The blog's short name, such as staff, or its name.tumblr.com address. Leave out https:// and any path, and do not pass a full link in this field. The short name is the part before .tumblr.com in the blog's address.

### Can I ask for photos and videos in one call?

No. `post_type` takes a single value, one of any, text, photo, video, quote, link or audio, not a list. Make one call per type, or use any and split the rows afterwards by the `post_type` each row carries.

### Can `tags` be null?

No. When a post carries no tags, `tags` is an empty list, so you can loop over it without a null check. Counting tags across a blog's posts shows the themes it files content under most often.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=tumblr
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
