मीडिया एनालिटिक्स प्राप्त करें

curl --request GET \
  --url https://api.x.com/2/media/analytics \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.x.com/2/media/analytics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/media/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/media/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/media/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "media_key": "<string>",
      "timestamped_metrics": [
        {
          "metrics": {
            "cta_url_clicks": 123,
            "cta_watch_clicks": 123,
            "play_from_tap": 123,
            "playback25": 123,
            "playback50": 123,
            "playback75": 123,
            "playback_complete": 123,
            "playback_start": 123,
            "video_views": 123,
            "watch_time_ms": 123
          },
          "timestamp": "2025-03-17T06:30:00Z"
        }
      ]
    }
  ],
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

{
  "code": 123,
  "message": "<string>"
}

GET

media

analytics

मीडिया एनालिटिक्स प्राप्त करें

curl --request GET \
  --url https://api.x.com/2/media/analytics \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.x.com/2/media/analytics', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.x.com/2/media/analytics",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.x.com/2/media/analytics"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.x.com/2/media/analytics")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "media_key": "<string>",
      "timestamped_metrics": [
        {
          "metrics": {
            "cta_url_clicks": 123,
            "cta_watch_clicks": 123,
            "play_from_tap": 123,
            "playback25": 123,
            "playback50": 123,
            "playback75": 123,
            "playback_complete": 123,
            "playback_start": 123,
            "video_views": 123,
            "watch_time_ms": 123
          },
          "timestamp": "2025-03-17T06:30:00Z"
        }
      ]
    }
  ],
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

{
  "code": 123,
  "message": "<string>"
}

प्राधिकरण

Authorization

string

header

आवश्यक

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

tweet.read

View all Posts you can see, including those from protected accounts.

क्वेरी पैरामीटर

media_keys

string[]

आवश्यक

मीडिया कीज़ की अल्पविराम से अलग की गई सूची। एक अनुरोध में अधिकतम 100 की अनुमति है।

Required array length: 1 - 100 elements

इस अटैचमेंट के लिए Media Key पहचानकर्ता।

Pattern: ^([0-9]+)_([0-9]+)$

end_time

string<date-time>

आवश्यक

YYYY-MM-DDTHH:mm:ssZ. समय सीमा के अंत को दर्शाने वाला UTC टाइमस्टैम्प।

start_time

string<date-time>

आवश्यक

YYYY-MM-DDTHH:mm:ssZ. समय सीमा की शुरुआत को दर्शाने वाला UTC टाइमस्टैम्प।

granularity

enum<string>

डिफ़ॉल्ट:daily

आवश्यक

खोज गणना परिणामों के लिए ग्रैन्युलैरिटी।

उपलब्ध विकल्प:

hourly,

daily,

total

media_analytics.fields

enum<string>[]

प्रदर्शित करने के लिए MediaAnalytics फ़ील्ड्स की अल्पविराम-से-पृथक सूची। MediaAnalytics ऑब्जेक्ट के लिए उपलब्ध फ़ील्ड्स।

Minimum array length: 1

उपलब्ध विकल्प:

cta_url_clicks,

cta_watch_clicks,

media_key,

play_from_tap,

playback25,

playback50,

playback75,

playback_complete,

playback_start,

timestamp,

video_views,

watch_time_ms

उदाहरण:

[
  "cta_url_clicks",
  "cta_watch_clicks",
  "media_key",
  "play_from_tap",
  "playback25",
  "playback50",
  "playback75",
  "playback_complete",
  "playback_start",
  "timestamp",
  "video_views",
  "watch_time_ms"
]

प्रतिक्रिया

अनुरोध सफल रहा है।

data

object[]

Show child attributes

errors

object[]

Minimum array length: 1

IETF RFC 7807 (https://tools.ietf.org/html/rfc7807) में परिभाषित एक HTTP Problem Details ऑब्जेक्ट।

Show child attributes

अवलोकन

पोस्ट्स

उपयोगकर्ता

डायरेक्ट मैसेज

लाइक्स

सूचियाँ

Spaces

Communities

Community Notes

ट्रेंड्स

समाचार