# Tumblr Scraper \[$2.50/1K💰] Images, Tags & Reblogs (`ahmed_jasarevic/tumblr-scraper`) Actor

Extract Tumblr posts — full-resolution images, tags, reblogs and engagement data for content research.

- **URL**: https://apify.com/ahmed\_jasarevic/tumblr-scraper.md
- **Developed by:** [Ahmed Jasarevic](https://apify.com/ahmed_jasarevic) (community)
- **Categories:** Social media, Automation, Videos
- **Stats:** 18 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Tumblr Scraper — Images, Tags & Reblogs

Scrape Tumblr blog posts, images, tags, and reblogs from any blog or tag feed for content research, archiving, and influencer discovery — no Tumblr API needed.

### Main Use Cases

- **Content archiving** — back up blog posts, images and captions before they disappear
- **Tag & trend research** — collect tagged posts (e.g. `photography`) to map what's popular
- **Influencer & blog discovery** — analyze blog activity, reblogs and notes for outreach
- **Visual asset collection** — gather image URLs from blogs for creative and mood-board work
- **Community monitoring** — track posts, notes and reblog behavior over time

### How It Works

You supply blog profiles (`https://www.tumblr.com/23-jumpstreet`), tag feeds (`https://www.tumblr.com/tagged/photography`), or plain blog names — mixed freely. The actor walks each target, extracting every post with its captions, tags, images, notes count and reblog state, stopping at the total item limit.

### Extract Structured Tumblr Post Data for Research and Archiving

Instead of manually scrolling feeds, get clean, per-post records: the blog, URL, timestamp, post type, title, description, tags, notes, reblog info and image URLs — all shaped for a database or spreadsheet.

### Build Content Analysis and Influencer Datasets at Scale

Combining multiple blogs and tags in one run gives you a comparable dataset for content research, competitive analysis, or influencer identification, without hitting the public site page by page.

### Input

| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `targets` | array | ✅ | — | Blog URLs, tag URLs or plain blog names. Mix freely. |
| `limit` | integer | — | 20 | Max posts in total across all targets (1+). **Free users limited to 5.** |

### Output

Each dataset record is one Tumblr post:

| Field | Type | Description |
|---|---|---|
| `id` | string | Post ID |
| `blog` | string | Blog name |
| `url` | string | Post URL |
| `timestamp` | integer | Unix timestamp |
| `date_iso` | string | Human-readable date |
| `type` | string | Post type (photo, text, quote…) |
| `title` | string | Post title |
| `description` | string | Post caption/body |
| `tags` | array | Post tags |
| `notes` | integer | Note/reblog count |
| `reblog` | object | `is_reblog` boolean flag |
| `images` | array | Image URLs |
| `avatar` | string/`null` | Blog avatar URL |

### Example Input

```json
{
  "targets": [
    "https://www.tumblr.com/tagged/photography",
    "https://www.tumblr.com/23-jumpstreet"
  ],
  "limit": 20
}
```

### Example Output

```json
{
  "id": "7336912345678",
  "blog": "example-photoblog",
  "url": "https://www.tumblr.com/example-photoblog/7336912345678",
  "timestamp": 1714500000,
  "date_iso": "2024-05-01T00:00:00Z",
  "type": "photo",
  "title": "Golden hour",
  "description": "Shot in Lisbon at sunset.",
  "tags": ["photography", "goldenhour", "lisbon"],
  "notes": 214,
  "reblog": { "is_reblog": false },
  "images": ["https://64.media.tumblr.com/abc/photo_1280.jpg"],
  "avatar": "https://64.media.tumblr.com/avatar.png"
}
```

### Integrations & Automation

- Webhooks for new-post delivery
- Schedule daily/weekly runs to monitor blogs or tags over time
- Export image URLs and captions to your CMS, spreadsheet or archive tool

Recurring usage tip: schedule a weekly run to keep an ongoing record of notes, reblogs and new posts for the blogs you track.

### Related Actors

- `maxcopell/tumblr-scraper` — Tumblr blog and post data
- `vdutts7/tumblr-post-scraper` — Tumblr posts and media extraction
- `compass/tumblr-scraper` — Tumblr image and post gathering
- `bpodowski/tumblr-photo-scraper` — Tumblr photo collection
- `clockworks/tumblr-tagged-scraper` — tag-based Tumblr collection

### FAQ

#### Why use this actor instead of the Tumblr API?

Tumblr's public API requires an OAuth app registration and daily request caps. This actor reads public blog and tag pages directly with no credentials, and pulls image URLs and reblog data in one pass — useful when you don't want to manage API registration or want to exceed per-app limits for research.

#### What are alternatives to this actor / Tumblr data?

The official Tumblr API, Tumblr's export tool, and other Tumblr scrapers on Apify (see Related Actors). For pure visual archiving, alternatives like image-downloader actors can pair with this to save media locally.

#### Can I scrape a blog and tags in the same run?

Yes — `targets` accepts both blog URLs and tag URLs, plus plain blog names, in any combination.

#### Do I need proxies?

The public Tumblr feed is generally accessible without special proxies for modest volumes. If you hit rate limits on large runs, add an Apify proxy.

#### What's the free-plan limit?

Free runs are capped at **5 posts** total regardless of `limit`.

#### What post types are captured?

`type` reflects each post's kind (photo, text, quote, video, etc.), and images are returned as an array of image URLs where present.

### SEO Keywords

tumblr scraper, tumblr blog data, tumblr tag scraper, tumblr images, tumblr reblogs, tumblr api alternative, tumblr post extractor, tumblr archive tool, tumblr influencer discovery, tumblr captions data, tumblr notes data, tumblr photography tag, scrape tumblr, tumblr content archive, tumblr visual assets, tumblr posts dataset, tumblr blog monitoring, tumblr media collection, tumblr export, tumblr trend research

### For AI Agents & LLM Apps

Returns one record per Tumblr post — caption, tags, notes, reblog state and media URLs.

Minimal working input:

```json
{
  "targets": ["https://www.tumblr.com/tagged/photography"],
  "limit": 5
}
```

Output field list (dataset): `id`, `blog`, `url`, `timestamp`, `date_iso`, `type`, `title`, `description`, `tags`, `notes`, `reblog.is_reblog`, `images`, `avatar`.

Behaviors an agent should know:

- `targets` is required — at least one blog/source name or URL.
- `limit` is capped at **5 on the free plan**; higher values apply on paid plans.
- Image URLs are returned as strings in the `images` array — fetch them separately if you need the binaries.

Billing: pay-per-event (compute-based); free tier capped at 5 posts — keep test runs small.

### Legal & Compliance Disclaimer

This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Tumblr (Automattic). It accesses only publicly available blog and tag pages; it does not bypass logins or access private content. Users are responsible for complying with Tumblr's Terms of Service and applicable data-protection law when using or redistributing scraped content.

# Actor input Schema

## `targets` (type: `array`):

Blog profiles (https://www.tumblr.com/23-jumpstreet), tag feeds (https://www.tumblr.com/tagged/photography) or plain blog names. You can mix both types freely.

## `limit` (type: `integer`):

Maximum number of posts to scrape in total across all targets. Free users are limited to 5.

## Actor input object example

```json
{
  "targets": [
    "https://www.tumblr.com/tagged/photography"
  ],
  "limit": 20
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "targets": [
        "https://www.tumblr.com/tagged/photography"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("ahmed_jasarevic/tumblr-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "targets": ["https://www.tumblr.com/tagged/photography"] }

# Run the Actor and wait for it to finish
run = client.actor("ahmed_jasarevic/tumblr-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "targets": [
    "https://www.tumblr.com/tagged/photography"
  ]
}' |
apify call ahmed_jasarevic/tumblr-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ahmed_jasarevic/tumblr-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/vwMMqZ0VvIcvKPOZa/builds/YxVhgtbQBl8Y23P1b/openapi.json