Rufen Sie öffentliche Zielgruppenbeziehungen und Interaktionssignale rund um Soziale Beziehungen auf X/Twitter für Recherche und Segmentierung ab.
Nutzen Sie „Freunde nach Nutzer-ID“, wenn Ihr Produkt verstehen muss, welche Konten mit einem Objekt interagieren oder mit ihm verbunden sind.
Prüfen Sie zuerst das Ergebnis und die typischen Abläufe und gehen Sie dann zu den Parametern und einem funktionierenden Anfragebeispiel über.
Die Antwort enthält öffentliche Konten und die verfügbaren Beziehungs- oder Interaktionssignale für Soziale Beziehungen.
Nutzen Sie „Freunde nach Nutzer-ID“, wenn Ihr Produkt verstehen muss, welche Konten mit einem Objekt interagieren oder mit ihm verbunden sind.
Untersuchen Sie Zusammensetzung und Überschneidungen des öffentlichen Publikums rund um X/Twitter-Objekte.
Bilden Sie Kontogruppen für Analysen und spätere Anreicherung.
Ergänzen Sie Objektmetriken um öffentliche Interaktionsdaten.
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.
Wechseln Sie auf dieser Seite die Version, um die Antwortstrukturen unter derselben Dokumentations-URL zu vergleichen.
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.
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.
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.
| Parameter | Pflicht | Typ | Beispiel | Beschreibung |
|---|---|---|---|---|
user_id |
Ja | str |
44196397 |
Numerische ID des Nutzers auf der gewählten Plattform. |
cursor |
Nein | str | None |
DAABCgABF4ABCD... |
Cursor der nächsten Seite aus der vorherigen Antwort. Für die erste Seite weglassen. |
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/twitter.com/social/friends-by-user-idcurl --request GET \
--url "https://www.scrapestorm.net/api/v2/twitter.com/social/friends-by-user-id" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'user_id=44196397' \
# Optional parameters:
# --data-urlencode 'cursor=DAABCgABF4ABCD...'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/twitter.com/social/friends-by-user-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"user_id": "44196397",
}
# Optional parameters
# params["cursor"] = "DAABCgABF4ABCD..."
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/twitter.com/social/friends-by-user-id";
const params = new URLSearchParams({
user_id: "44196397",
});
// Optional parameters
// params.set("cursor", "DAABCgABF4ABCD...");
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 = {
user_id: "44196397",
};
// Optional parameters
// params.cursor = "DAABCgABF4ABCD...";
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 = [
"user_id" => "44196397",
];
// Optional parameters
// $query["cursor"] = "DAABCgABF4ABCD...";
try {
$response = $client->request("GET", "/api/v2/twitter.com/social/friends-by-user-id", [
'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/twitter.com/social/friends-by-user-id"
params := url.Values{}
params.Set("user_id", "44196397")
// Optional parameters
// params.Set("cursor", "DAABCgABF4ABCD...")
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)
}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/v1/twitter.com/social/friends-by-user-idcurl --request GET \
--url "https://www.scrapestorm.net/api/v1/twitter.com/social/friends-by-user-id" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'user_id=44196397' \
# Optional parameters:
# --data-urlencode 'cursor=DAABCgABF4ABCD...'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/twitter.com/social/friends-by-user-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"user_id": "44196397",
}
# Optional parameters
# params["cursor"] = "DAABCgABF4ABCD..."
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/v1/twitter.com/social/friends-by-user-id";
const params = new URLSearchParams({
user_id: "44196397",
});
// Optional parameters
// params.set("cursor", "DAABCgABF4ABCD...");
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 = {
user_id: "44196397",
};
// Optional parameters
// params.cursor = "DAABCgABF4ABCD...";
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 = [
"user_id" => "44196397",
];
// Optional parameters
// $query["cursor"] = "DAABCgABF4ABCD...";
try {
$response = $client->request("GET", "/api/v1/twitter.com/social/friends-by-user-id", [
'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/v1/twitter.com/social/friends-by-user-id"
params := url.Values{}
params.Set("user_id", "44196397")
// Optional parameters
// params.Set("cursor", "DAABCgABF4ABCD...")
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)
}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.
Dieses kompakte JSON-Beispiel stammt aus dem letzten erfolgreichen Verifizierungslauf von V2.
{
"success": true,
"status": "ok",
"pagination": {
"cursor": "1865114503909977250|2078956826803568568",
"has_more": true
},
"search_context": {
"user_id": "44196397"
},
"data": {
"users": {
"count": 70,
"items": [
{
"url": "https://x.com/jordanbpeterson",
"user_id": "95092020",
"username": "jordanbpeterson",
"display_name": "Dr Jordan B Peterson",
"description": "Best-Selling Author | Clinical Psychologist | #1 Education Podcast | Co-founder of @petersonacademy | Order my new book \"We Who Wrestle With God\" here:",
"emails": [],
"external_links": [],
"location": null,
"created_at": "2009-12-06T23:33:02Z",
"is_verified": false,
"is_blue_verified": true,
"is_protected": false,
"possibly_sensitive": false,
"default_profile": false,
"default_profile_image": false,
"followers_count": 6179359,
"following_count": 1653,
"tweet_count": 51548,
"media_count": 7380,
"listed_count": 14773,
"like_count": 247,
"professional_type": "Creator",
"professional_category_name": [
"Education"
],
"affiliated_account": {
"label": "Peterson Academy",
"url": "https://x.com/petersonacademy",
"badge_url": "https://pbs.twimg.com/profile_images/2010195782155350017/0xKKxQJs_bigger.jpg",
"label_type": "BusinessLabel"
},
"_more_fields": "3 more fields"
},
{
"url": "https://x.com/DonaldJTrumpJr",
"user_id": "39344374",
"username": "DonaldJTrumpJr",
"display_name": "Donald Trump Jr.",
"description": "Co-Founder @worldlibertyfi",
"emails": [],
"external_links": [],
"location": "Florida, USA",
"created_at": "2009-05-11T21:18:33Z",
"is_verified": false,
"is_blue_verified": true,
"is_protected": false,
"possibly_sensitive": false,
"default_profile": false,
"default_profile_image": false,
"followers_count": 16223217,
"following_count": 2335,
"tweet_count": 52414,
"media_count": 3476,
"listed_count": 25625,
"like_count": 39869,
"professional_type": null,
"professional_category_name": null,
"affiliated_account": null,
"_more_fields": "3 more fields"
},
{
"_more_items": 68
}
]
}
}
}Dieses kompakte JSON-Beispiel stammt aus dem letzten erfolgreichen Verifizierungslauf von V1.
{
"success": true,
"status": "ok",
"pagination": {
"cursor": "1865114503909977250|2078956718284341176",
"has_more": true
},
"search_context": {
"user_id": "44196397"
},
"data": {
"data": {
"user": {
"result": {
"__typename": "User",
"timeline": {
"timeline": {
"instructions": "…"
}
}
}
}
}
}
}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.
Nutzen Sie diese Antworten, um zu entscheiden, ob diese API-Methode zu Ihrem Ablauf, Ihrer Versionswahl und Ihrem Einführungsplan passt.
Die Methode führt „Freunde nach Nutzer-ID“ für Soziale Beziehungen aus. Das kompakte Antwortbeispiel unten zeigt die genaue Struktur der Felder.
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.
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.