# Tumblr Blog Posts

Returns a blog's posts in NPF (New Post Format) with note counts and tags. Cursor pagination: pass back next_cursor unchanged to fetch the next page.

- **Documentation:** [https://scrappa.co/docs/tumblr-api/tumblr_posts](https://scrappa.co/docs/tumblr-api/tumblr_posts)
- **API group:** Tumblr API
- **Endpoint:** `GET https://scrappa.co/api/tumblr/posts`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `blog` | string | Yes | The tumblelog name (e.g. aphractal2). |
| `cursor` | string | No | Opaque pagination cursor from a previous response (next_cursor). |
| `npf` | boolean | No | Return posts in NPF block format (default true). |
| `reblog_info` | boolean | No | Include reblog information. |
| `include_pinned_posts` | boolean | No | Include pinned posts in the response. |
| `fields` | string | No | Comma-separated blog fields to include (e.g. name,url,title,uuid,avatar). |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/tumblr/posts?blog=aphractal2"
```

## Example response

```json
{
    "success": true,
    "endpoint": "posts",
    "blog": {
        "name": "aphractal2",
        "total_posts": 591
    },
    "posts": [
        {
            "id": "830306289154506752",
            "blog_name": "aphractal2",
            "type": "blocks",
            "note_count": 34572
        }
    ],
    "has_more": true,
    "next_cursor": "VNRyGT5TMaLTYXCWiYWe2R9Sde9qlcITU3"
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | The requested Tumblr resource does not exist. |  |
|  | Upstream service error |  |
|  | Upstream service unavailable |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)