Tumblr API: Blog — Beitragsmetriken nach Blog-Kennung

Was dieser Endpunkt macht

Was Sie mit dieser API-Methode bauen können

Prüfen Sie zuerst das Ergebnis und die typischen Abläufe und gehen Sie dann zu den Parametern und einem funktionierenden Anfragebeispiel über.

Wobei dieser Endpunkt hilft

Die Antwort liefert eine einsatzbereite Blog-Zusammenfassung mit Zählern und wichtigen Metriken im gewählten API-Format.

Wann er sinnvoll ist

Nutzen Sie „Beitragsmetriken nach Blog-Kennung“ für Dashboards, Bewertungen und wiederkehrende Berichte, die einen kompakten Metrik-Schnappschuss benötigen.

Typische Anwendungsfälle

Produkt-Dashboards

Zeigen Sie die wichtigsten Tumblr-Metriken an, ohne eine vollständige Sammlung zu laden und zu verarbeiten.

Trend-Monitoring

Speichern Sie regelmäßige Schnappschüsse und vergleichen Sie Veränderungen der Metriken im Zeitverlauf.

Bewertung von Objekten

Nutzen Sie aggregierte Metriken als Eingabe für Rankings und interne Regeln.

Verfügbare Versionen

Antwortversion

Beide Versionen lösen dieselbe Aufgabe und akzeptieren dieselben Parameter. Vergleichen Sie mit dem Umschalter die Antwortstruktur und wählen Sie die Version, die Ihr Client erwartet.

Antwortversion V2

Wechseln Sie auf dieser Seite die Version, um die Antwortstrukturen unter derselben Dokumentations-URL zu vergleichen.

V1 Nicht verfügbar

Was gleich bleibt

Authentifizierung, Pflichtparameter und Anfrageform sind in V1 und V2 identisch. In der Praxis wählen Sie die Version beim Aufbau des Endpunktpfads und bei der Auswertung der Antwort.

Was sich zwischen den Versionen ändert

Der Hauptunterschied liegt in der Antwort-Hülle. Verwenden Sie V2 für neue Integrationen und behalten Sie V1 nur, wenn Sie Kompatibilität mit einem bestehenden Client-Vertrag benötigen.

So verwenden Sie ihn

So rufen Sie die Methode auf

Verwenden Sie in beiden Versionen denselben API-Schlüssel-Header und dieselben Query-Parameter. Diese Dokumentation zeigt zuerst den gemeinsamen Parametersatz und danach die Pfade und Codeausschnitte jeder Version.

Eingabeparameter

Gemeinsame Parameter

Parameter	Pflicht	Typ	Beispiel	Beschreibung
`blog_identifier`	Ja	`str`	`staff`	Tumblr blog username or host without protocol or path. Pass `staff` or `staff.tumblr.com`, not a full URL. Example: staff.
`post_type`	Nein	`all \| regular \| photo \| quote \| link \| conversation \| audio \| video \| answer`	`all`	Optional Tumblr post type filter. Use `all` for the default mixed timeline. Examples: all, photo.
`tag`	Nein	`str \| None`	`tumblr staff`	Optional Tumblr tag filter. Spaces are allowed, slashes and URL fragments are not. Example: tumblr staff.

Anfragepfad nach Version

V2

Wählen Sie eine Version, wenn Sie den genauen Endpunktpfad, die Beispiel-URL und den Codeausschnitt kopieren. Die Parameterliste oben ändert sich nicht.

GET /api/v2/tumblr.com/blog/post-metrics-by-blog-identifier

Normalisiertes Format

Vorschau der Anfrage

Basis-URL https://www.scrapestorm.net

Endpunkt /api/v2/tumblr.com/blog/post-metrics-by-blog-identifier

Pflichtparameter

blog_identifier

Optionale Parameter

post_type tag

Beispiel-URL

https://www.scrapestorm.net/api/v2/tumblr.com/blog/post-metrics-by-blog-identifier?blog_identifier=staff

Codebeispiele

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/tumblr.com/blog/post-metrics-by-blog-identifier" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'blog_identifier=staff' \
  # Optional parameters:
  # --data-urlencode 'post_type=all'
  # --data-urlencode 'tag=tumblr staff'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/tumblr.com/blog/post-metrics-by-blog-identifier"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "blog_identifier": "staff",
}

# Optional parameters
# params["post_type"] = "all"
# params["tag"] = "tumblr staff"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/tumblr.com/blog/post-metrics-by-blog-identifier";

const params = new URLSearchParams({
  blog_identifier: "staff",
});

// Optional parameters
// params.set("post_type", "all");
// params.set("tag", "tumblr staff");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  blog_identifier: "staff",
};

// Optional parameters
// params.post_type = "all";
// params.tag = "tumblr staff";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "blog_identifier" => "staff",
];

// Optional parameters
// $query["post_type"] = "all";
// $query["tag"] = "tumblr staff";

try {
    $response = $client->request("GET", "/api/v2/tumblr.com/blog/post-metrics-by-blog-identifier", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v2/tumblr.com/blog/post-metrics-by-blog-identifier"

    params := url.Values{}
    params.Set("blog_identifier", "staff")

    // Optional parameters
    // params.Set("tag", "tumblr staff")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

Antwortbeispiel

Live-Antwort nach Version

Die Vorschau enthält die wichtigsten Felder und die ersten Elemente der Sammlung, damit Sie die Form der Antwort schnell prüfen können. Beim Wechsel der Version ändert sich das JSON-Format.

Antwortbeispiel

V2 Antwort-JSON

Verifiziertes Beispiel

Dieses kompakte JSON-Beispiel stammt aus dem letzten erfolgreichen Verifizierungslauf von V2.

{
  "success": true,
  "status": "ok",
  "search_context": {
    "blog_identifier": "staff",
    "post_type": "all",
    "tag": "tumblr staff"
  },
  "data": {
    "blog": {
      "url": "https://staff.tumblr.com",
      "blog_identifier": "staff.tumblr.com",
      "uuid": null,
      "username": "staff",
      "display_name": "Tumblr Staff",
      "description": null,
      "emails": [],
      "external_links": [],
      "rss_url": "https://staff.tumblr.com/rss",
      "timezone": null,
      "is_custom_domain": false,
      "avatar_url": null,
      "avatar_urls": null
    },
    "analytics": {
      "all_posts": {
        "analyzed_posts_count": 20,
        "last_post_date": "2026-07-13T20:37:36+00:00",
        "total_engagement": 0,
        "avg_engagement_rate_per_post": 0.0,
        "peak_engagement_rate_per_post": 0.0,
        "avg_weighted_engagement_score": 0.0,
        "total_engagement_rate": 0.0,
        "median_engagement_per_post": 0.0,
        "max_engagement_per_post": 0,
        "avg_caption_length": 33,
        "avg_posts_per_week": 1,
        "avg_posts_per_month": 4,
        "posts_count_last_7_days": 0,
        "posts_count_last_30_days": 0,
        "total_notes": 0,
        "avg_notes_per_post": 0,
        "total_note_rate": 0.0,
        "content_format_breakdown": [
          {
            "format": "regular",
            "count": 20,
            "percentage": 100.0
          }
        ],
        "posting_time_analysis": {
          "by_day_of_week": [
            {
              "day": "Tuesday",
              "count": 6
            },
            {
              "day": "Wednesday",
              "count": 4
            },
            {
              "_more_items": 4
            }
          ],
          "by_hour_of_day": [
            {
              "hour": 16,
              "count": 6
            },
            {
              "hour": 20,
              "count": 4
            },
            {
              "_more_items": 7
            }
          ]
        },
        "top_hashtags": [
          {
            "hashtag": "1",
            "count": 2
          },
          {
            "hashtag": "20",
            "count": 2
          },
          {
            "_more_items": 6
          }
        ],
        "top_posts_by_engagement": [
          {
            "item_id": "822057428507049984",
            "post_id": "822057428507049984",
            "url": "https://staff.tumblr.com/post/822057428507049984",
            "title": "In case you’re looking for a blog that’s gone missing on Tumblr and didn’t see this recent update.",
            "text": "In case you’re looking for a blog that’s gone missing on Tumblr and didn’t see this recent update.",
            "created_at": "2026-07-13T20:37:36+00:00",
            "content_format": "regular",
            "engagement": 0,
            "is_sponsored": false,
            "sponsored_detection_source": null,
            "sponsored_detection_confidence": null
          },
          {
            "item_id": "818408523445731328",
            "post_id": "818408523445731328",
            "url": "https://staff.tumblr.com/post/818408523445731328",
            "title": "Where’s that comment?",
            "text": "Where’s that comment?",
            "created_at": "2026-06-03T13:59:49+00:00",
            "content_format": "regular",
            "engagement": 0,
            "is_sponsored": false,
            "sponsored_detection_source": null,
            "sponsored_detection_confidence": null
          },
          {
            "_more_items": 3
          }
        ],
        "engagement_by_format": [
          {
            "format": "regular",
            "count": 20,
            "total_engagement": 0,
            "avg_engagement_per_post": 0.0,
            "avg_engagement_rate_per_post": 0.0
          }
        ]
      },
      "sponsored_posts": {
        "analyzed_posts_count": 0,
        "total_engagement": 0,
        "avg_engagement_rate_per_post": 0.0,
        "peak_engagement_rate_per_post": 0.0,
        "avg_weighted_engagement_score": 0.0,
        "total_engagement_rate": 0.0,
        "median_engagement_per_post": 0.0,
        "max_engagement_per_post": 0,
        "avg_caption_length": 0,
        "avg_posts_per_week": 0,
        "avg_posts_per_month": 0,
        "posts_count_last_7_days": 0,
        "posts_count_last_30_days": 0
      },
      "organic_posts": {
        "analyzed_posts_count": 20,
        "last_post_date": "2026-07-13T20:37:36+00:00",
        "total_engagement": 0,
        "avg_engagement_rate_per_post": 0.0,
        "peak_engagement_rate_per_post": 0.0,
        "avg_weighted_engagement_score": 0.0,
        "total_engagement_rate": 0.0,
        "median_engagement_per_post": 0.0,
        "max_engagement_per_post": 0,
        "avg_caption_length": 33,
        "avg_posts_per_week": 1,
        "avg_posts_per_month": 4,
        "posts_count_last_7_days": 0,
        "posts_count_last_30_days": 0,
        "total_notes": 0,
        "avg_notes_per_post": 0,
        "total_note_rate": 0.0,
        "content_format_breakdown": [
          {
            "format": "regular",
            "count": 20,
            "percentage": 100.0
          }
        ],
        "posting_time_analysis": {
          "by_day_of_week": [
            {
              "day": "Tuesday",
              "count": 6
            },
            {
              "day": "Wednesday",
              "count": 4
            },
            {
              "_more_items": 4
            }
          ],
          "by_hour_of_day": [
            {
              "hour": 16,
              "count": 6
            },
            {
              "hour": 20,
              "count": 4
            },
            {
              "_more_items": 7
            }
          ]
        },
        "top_hashtags": [
          {
            "hashtag": "1",
            "count": 2
          },
          {
            "hashtag": "20",
            "count": 2
          },
          {
            "_more_items": 6
          }
        ],
        "top_posts_by_engagement": [
          {
            "item_id": "822057428507049984",
            "post_id": "822057428507049984",
            "url": "https://staff.tumblr.com/post/822057428507049984",
            "title": "In case you’re looking for a blog that’s gone missing on Tumblr and didn’t see this recent update.",
            "text": "In case you’re looking for a blog that’s gone missing on Tumblr and didn’t see this recent update.",
            "created_at": "2026-07-13T20:37:36+00:00",
            "content_format": "regular",
            "engagement": 0,
            "is_sponsored": false,
            "sponsored_detection_source": null,
            "sponsored_detection_confidence": null
          },
          {
            "item_id": "818408523445731328",
            "post_id": "818408523445731328",
            "url": "https://staff.tumblr.com/post/818408523445731328",
            "title": "Where’s that comment?",
            "text": "Where’s that comment?",
            "created_at": "2026-06-03T13:59:49+00:00",
            "content_format": "regular",
            "engagement": 0,
            "is_sponsored": false,
            "sponsored_detection_source": null,
            "sponsored_detection_confidence": null
          },
          {
            "_more_items": 3
          }
        ],
        "engagement_by_format": [
          {
            "format": "regular",
            "count": 20,
            "total_engagement": 0,
            "avg_engagement_per_post": 0.0,
            "avg_engagement_rate_per_post": 0.0
          }
        ]
      },
      "segment_comparison": {
        "sponsored_content_share": 0.0,
        "organic_content_share": 100.0,
        "organic_vs_sponsored_engagement_rate_gap": 0.0,
        "sponsored_to_organic_avg_engagement_ratio": 0.0
      }
    },
    "feed": {
      "count": 20,
      "items": [
        {
          "url": "https://staff.tumblr.com/post/822057428507049984",
          "post_id": "822057428507049984",
          "title": "In case you’re looking for a blog that’s gone missing on Tumblr and didn’t see this recent update.",
          "summary": "In case you’re looking for a blog that’s gone missing on Tumblr and didn’t see this recent update.",
          "body_html": "<p><a class=\"tumblr_blog\" href=\"https://changes.tumblr.com/post/818409292753436672/deleted-accounts-can-now-be-recovered-up-to-30\">changes</a>:</p><blockquote><h1>Deleted accoun…",
          "blog_username": "staff",
          "blog_display_name": "Tumblr Staff",
          "blog_url": "https://staff.tumblr.com",
          "published_at": "2026-07-13T20:37:36Z",
          "type": "regular",
          "tags": [
            "tumblr"
          ],
          "is_sponsored": false,
          "sponsored_detection_source": null,
          "sponsored_detection_confidence": null
        },
        {
          "url": "https://staff.tumblr.com/post/818408523445731328",
          "post_id": "818408523445731328",
          "title": "Where’s that comment?",
          "summary": "Where’s that comment?",
          "body_html": "<p><a class=\"tumblr_blog\" href=\"https://engineering.tumblr.com/post/818227557915901952/launch-day\">engineering</a>:</p><blockquote><p><a class=\"tumblr_blog\" href=\"https://engine…",
          "blog_username": "staff",
          "blog_display_name": "Tumblr Staff",
          "blog_url": "https://staff.tumblr.com",
          "published_at": "2026-06-03T13:59:49Z",
          "type": "regular",
          "tags": [
            "radical speed month",
            "rsm",
            {
              "_more_items": 3
            }
          ],
          "media": [
            {
              "url": "https://64.media.tumblr.com/b70baed40b8a42f2647f1e9727980326/bc08fda5fd4aaa10-94/s640x960/90039a62dfb3c54bf3efc7f22b072a9211196fb0.png",
              "width": 1030,
              "height": 1506,
              "media_type": "image"
            },
            {
              "url": "https://64.media.tumblr.com/1b0af89e8b0e820c96223492c467801e/bc08fda5fd4aaa10-f1/s640x960/d5303ad0839d889c1474bf2b498151e4f678ca1d.png",
              "width": 602,
              "height": 1047,
              "media_type": "image"
            },
            {
              "_more_items": 2
            }
          ],
          "is_sponsored": false,
          "sponsored_detection_source": null,
          "sponsored_detection_confidence": null
        },
        {
          "_more_items": 18
        }
      ]
    }
  }
}

Verwandte Methoden

Arbeiten Sie weiter mit Blog

Verwandte Methoden lösen dasselbe Objekt über eine andere Kennung auf, öffnen Details oder wechseln zu einer aggregierten Ansicht.

Nächste Schritte

Setzen Sie die Bewertung fort

Nutzen Sie diese Dokumentation als ersten Entscheidungspunkt und prüfen Sie dann Preise, Plattformabdeckung und Integrationsregeln, bevor Sie den Endpunkt für die wiederkehrende Nutzung anbinden.

Öffnen Sie die Plattformseite Tumblr

Vergleichen Sie verwandte Entitäten, Gruppen von API-Methoden und die zugehörige Dokumentation vor der Implementierung.

Plattformseite öffnen

Vergleichen Sie die Preise der API-Methoden

Prüfen Sie, wo diese Methode in der öffentlichen Preistabelle steht, bevor Sie die Nutzung skalieren.

Preise ansehen

Prüfen Sie die Integrationsregeln

Bestätigen Sie mit der Einstiegsdokumentation Authentifizierung, Versionen, Wiederholungen und die Unterschiede zwischen Test und Produktion.

Dokumentation öffnen

Häufige Fragen

Fragen, die Teams vor der Implementierung stellen

Nutzen Sie diese Antworten, um zu entscheiden, ob diese API-Methode zu Ihrem Ablauf, Ihrer Versionswahl und Ihrem Einführungsplan passt.

Welche Daten gibt diese Methode der Tumblr-API zurück?

Die Methode führt „Beitragsmetriken nach Blog-Kennung“ für Blog aus. Das kompakte Antwortbeispiel unten zeigt die genaue Struktur der Felder.

Soll ich V1 oder V2 wählen?

Wählen Sie V2 für neue Integrationen, da sie eine normalisierte Struktur bietet. Verwenden Sie V1 nur zur Kompatibilität mit Clients, die bereits das native Format der Plattform verarbeiten.

Was brauche ich für die erste Anfrage?

Erstellen Sie einen API-Schlüssel, senden Sie ihn im Header der Anfrage und geben Sie die Pflichtparameter aus der Tabelle an. Die Codebeispiele enthalten bereits den korrekten Pfad und die richtige Anfragestruktur.