Tumblr API: Blog — Métriques des publications par identifiant de blog

Ce que fait cet endpoint

Ce que vous pouvez construire avec cette méthode d'API

Examinez d'abord le résultat et les flux courants, puis passez aux paramètres et à un exemple de requête fonctionnel.

À quoi sert cet endpoint

La réponse fournit un résumé Blog prêt à l'emploi avec des compteurs et des métriques clés au format d'API choisi.

Quand l'utiliser

Utilisez « Métriques des publications par identifiant de blog » pour les tableaux de bord, les évaluations et les rapports récurrents qui nécessitent un instantané compact des métriques.

Cas d'usage courants

Tableaux de bord produit

Affichez les principales métriques Tumblr sans charger ni traiter une collection complète.

Suivi des tendances

Enregistrez des instantanés réguliers et comparez l'évolution des métriques dans le temps.

Évaluation des objets

Utilisez les métriques agrégées comme entrée pour les classements et les règles internes.

Versions disponibles

Version de la réponse

Les deux versions répondent au même besoin et acceptent les mêmes paramètres. Utilisez le sélecteur pour comparer la structure de la réponse et choisissez la version attendue par votre client.

Version de la réponse V2

Changez de version sur cette page pour comparer les structures de réponse sous la même URL de documentation.

V1 Non disponible

Ce qui reste identique

L'authentification, les paramètres obligatoires et la forme de la requête sont identiques en V1 et V2. En pratique, vous choisissez la version en construisant le chemin de l'endpoint et en lisant la réponse.

Ce qui change entre les versions

La principale différence réside dans l'enveloppe de la réponse. Utilisez V2 pour les nouvelles intégrations et ne conservez V1 que si vous avez besoin de compatibilité avec un contrat client existant.

Comment l'utiliser

Comment appeler la méthode

Utilisez le même en-tête de clé API et les mêmes paramètres de requête dans les deux versions. Cette documentation présente d'abord l'ensemble commun de paramètres, puis les chemins et extraits de code de chaque version.

Paramètres d'entrée

Paramètres communs

Paramètre	Obligatoire	Type	Exemple	Description
`blog_identifier`	Oui	`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`	Non	`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`	Non	`str \| None`	`tumblr staff`	Optional Tumblr tag filter. Spaces are allowed, slashes and URL fragments are not. Example: tumblr staff.

Chemin de requête par version

V2

Choisissez une version lorsque vous copiez le chemin exact de l'endpoint, l'URL d'exemple et l'extrait de code. La liste des paramètres ci-dessus ne change pas.

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

Format normalisé

Aperçu de la requête

URL de base https://www.scrapestorm.net

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

Paramètres obligatoires

blog_identifier

Paramètres facultatifs

post_type tag

URL d'exemple

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

Exemples de code

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)
}

Exemple de réponse

Réponse en direct par version

L'aperçu contient les champs clés et les premiers éléments de la collection pour vous permettre de vérifier rapidement la forme de la réponse. Le format JSON change avec la version.

Exemple de réponse

V2 JSON de réponse

Exemple vérifié

Cet exemple JSON compact provient de la dernière vérification réussie de 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
        }
      ]
    }
  }
}

Méthodes associées

Continuez avec Blog

Les méthodes associées résolvent le même objet par un autre identifiant, ouvrent des détails ou passent à une vue agrégée.

Étapes suivantes

Poursuivez l'évaluation

Utilisez cette documentation comme premier point de décision, puis vérifiez les prix, la couverture de la plateforme et les règles d'intégration avant de connecter l'endpoint pour un usage récurrent.

Ouvrez la page de la plateforme Tumblr

Comparez les entités associées, les groupes de méthodes d'API et la documentation liée avant l'implémentation.

Ouvrir la page de la plateforme

Comparez les prix des méthodes d'API

Vérifiez la place de cette méthode dans le tableau public des tarifs avant d'augmenter l'utilisation.

Voir les tarifs

Consultez les règles d'intégration

Confirmez l'authentification, les versions, les nouvelles tentatives et les différences entre test et production dans la documentation de démarrage.

Ouvrir la documentation

Questions fréquentes

Les questions que posent les équipes avant l'implémentation

Utilisez ces réponses pour décider si cette méthode d'API convient à votre flux, à votre choix de version et à votre plan de déploiement.

Quelles données renvoie cette méthode de l'API Tumblr ?

La méthode exécute « Métriques des publications par identifiant de blog » pour Blog. L'exemple de réponse compact ci-dessous montre la structure exacte des champs.

Dois-je choisir V1 ou V2 ?

Choisissez V2 pour les nouvelles intégrations, car elle fournit une structure normalisée. N'utilisez V1 que pour la compatibilité avec des clients qui traitent déjà le format natif de la plateforme.

De quoi ai-je besoin pour la première requête ?

Créez une clé API, envoyez-la dans l'en-tête de la requête et renseignez les paramètres obligatoires du tableau. Les exemples de code contiennent déjà le bon chemin et la bonne structure de requête.