Owned Media & Communitys

Welche Ihrer eigenen Kanäle und welche Community-Diskussionen in KI-Antworten zitiert werden. Zurückgegeben werden alle Zeilen der Plattform, nicht nur Ihre eigenen. Jede Zeile trägt das Flag yours, damit Sie Ihre Präsenz mit der aller anderen vergleichen können, die dort zitiert werden. Verfügbar ab Tarif Growth.

GET`/dimensions/owned_media`

Owned-Media-Zitierungen einer Plattform. provider ist erforderlich und hat keinen Standardwert: Ohne diesen Parameter wird ERR_INVALID_PARAM zurückgegeben. Die Ansichten hängen von der Plattform ab: youtube unterstützt videos (Standard), channels und own_citations; die sozialen Plattformen unterstützen posts (Standard), profiles und own_citations; mobile_apps unterstützt apps. own_citations liefert nur die Zitierungen des hinterlegten Profils und bleibt leer, bis ein Profil hinterlegt ist. Für Reddit gibt es weiter unten einen eigenen Endpunkt. Standardzeitraum sind die letzten 30 Tage.

Parameter:

project_iderforderlich
providererforderlich: youtube|instagram|facebook|tiktok|linkedin|mobile_apps
view
storegoogle_play|app_store, nur mobile_apps
owned
model
collection_id
country_code
language_code
brand_kind
range
from
to
page
per_page
output

GET`/dimensions/owned_media/summary`

Die KPI-Karten und Diagramme eines Tabs in Owned Media: die Zitierungen der Plattform insgesamt, Ihre eigenen (getrennt nach Profil und Inhalten) und Ihr Anteil, der gleich lange Vorzeitraum mit der Veränderung gegenüber diesem, die wöchentliche Datenreihe sowie die Aufschlüsselungen nach Modell, Land, Inhaltstyp und Alter der Inhalte. provider=overview liefert eine Zusammenfassung pro Plattform, provider=mobile_apps ergänzt die Summen pro App-Store. Bei provider=youtube benötigen Teammitglieder außerdem die Berechtigung für YouTube Intelligence. Standardzeitraum sind die letzten 30 Tage.

Parameter:

project_iderforderlich
providererforderlich: youtube|instagram|facebook|tiktok|linkedin|mobile_apps|overview
model
collection_id
country_code
language_code
brand_kind
range
from
to

GET`/dimensions/owned_media/citing_prompts`

Die KI-Antworten hinter einer Tabellenzeile in Owned Media oder YouTube Intelligence. Übergeben Sie genau einen der Parameter url (URL eines Beitrags oder Videos) oder profile (ein Handle, die URL eines Profils oder Kanals oder der key des Kanals aus der Kanalansicht). Liefert das Element mit seinen Statistiken, der Zahl seiner Zitierungen und Prompts sowie die zitierenden Antworten, die neuesten zuerst, jeweils mit Prompt, Antwort-ID, Modell, Datum und einem Auszug als reiner Text. Teammitglieder benötigen außerdem die Berechtigung für Prompts und bei provider=youtube die Berechtigung für YouTube Intelligence. Standardzeitraum sind die letzten 30 Tage.

Parameter: project_id (erforderlich), provider (erforderlich: youtube|instagram|facebook|tiktok|linkedin), url oder profile (eines von beiden), model, collection_id, country_code, language_code, brand_kind, range, from, to, page, per_page, output.

GET`/dimensions/reddit`

Von KI-Antworten zitierte Reddit-Inhalte. view=subreddits (Standard) liefert eine Zeile pro Subreddit mit der Zahl der Zitierungen, der Zahl verschiedener Reddit-Konten und der Aufteilung des Sentiments in positiv und negativ. view=authors liefert eine Zeile pro Reddit-Konto. view=threads liefert die einzelnen zitierten Threads mit Upvotes, Kommentaren, durchschnittlicher Position und vorherrschendem Sentiment. Der Filter brand bezieht sich auf die Marken, die in den abgerufenen Reddit-Inhalten erwähnt werden, nicht auf die in der KI-Antwort. Standardzeitraum sind die letzten 30 Tage.

Parameter:

project_iderforderlich
viewsubreddits|authors|threads
subreddit
author
statusopen|archived, nur threads
owned
brandbrand oder eine Wettbewerber-ID
order
direction
model
collection_id
country_code
language_code
brand_kind
range
from
to
page
per_page
output

GET`/projects/:id/owned_media`

Die Profile, deren Zitierungen als Ihre eigenen zählen, pro Plattform (YouTube, App-Stores, Instagram, Facebook, TikTok, LinkedIn, Reddit): das Hauptprofil, die weiteren Profile sowie die als eigene angegebenen Subreddits und Reddit-Benutzernamen, jeweils mit URL, Handle, Name, Avatar und Abrufstatus. settings enthält den aktuellen Wert jedes Felds, das die Aktualisierung akzeptiert.

Parameter:

iderforderlich, die Projekt-ID im Pfad

PATCH`/projects/:id/owned_media`

Legt das Hauptprofil und die weiteren Profile pro Plattform sowie die als eigene angegebenen Subreddits und Reddit-Benutzernamen fest oder entfernt sie. Senden Sie nur die Felder, die Sie ändern möchten: Ein leerer String oder null entfernt eine URL, und eine Liste ersetzt die gespeicherte ([] leert sie). URLs werden wie in den Projekteinstellungen validiert, und für ein neues Profil werden Name und Avatar im Hintergrund abgerufen. Erfordert einen Schlüssel mit dem Zugriffsumfang read_write.

Anfragetext:

youtube_channel_url
app_store_url
google_play_url
instagram_profile_url
facebook_page_url
tiktok_profile_url
linkedin_company_url
<platform>_extra_profile_urlsyoutube, mobile_apps, instagram, facebook, tiktok, linkedin
reddit_subreddits
reddit_usernames

Codebeispiele

Download: OpenAPI Swagger Postman

KI fragen: In ChatGPT öffnen In Claude öffnen Als Markdown anzeigen

Sprache

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/dimensions/owned_media?project_id=PROJECT_ID&provider=youtube&range=30"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/owned_media?project_id=PROJECT_ID&provider=youtube&range=30", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/owned_media?project_id=PROJECT_ID&provider=youtube&range=30",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/owned_media?project_id=PROJECT_ID&provider=youtube&range=30",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/owned_media?project_id=PROJECT_ID&provider=youtube&range=30", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/dimensions/owned_media?project_id=PROJECT_ID&provider=youtube&range=30', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/dimensions/owned_media?project_id=PROJECT_ID&provider=youtube&range=30"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/dimensions/owned_media/summary?project_id=PROJECT_ID&provider=instagram&range=30"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/owned_media/summary?project_id=PROJECT_ID&provider=instagram&range=30", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/owned_media/summary?project_id=PROJECT_ID&provider=instagram&range=30",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/owned_media/summary?project_id=PROJECT_ID&provider=instagram&range=30",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/owned_media/summary?project_id=PROJECT_ID&provider=instagram&range=30", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/dimensions/owned_media/summary?project_id=PROJECT_ID&provider=instagram&range=30', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/dimensions/owned_media/summary?project_id=PROJECT_ID&provider=instagram&range=30"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/dimensions/owned_media/citing_prompts?project_id=PROJECT_ID&provider=youtube&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dabc123&range=30"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/owned_media/citing_prompts?project_id=PROJECT_ID&provider=youtube&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dabc123&range=30", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/owned_media/citing_prompts?project_id=PROJECT_ID&provider=youtube&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dabc123&range=30",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/owned_media/citing_prompts?project_id=PROJECT_ID&provider=youtube&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dabc123&range=30",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/owned_media/citing_prompts?project_id=PROJECT_ID&provider=youtube&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dabc123&range=30", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/dimensions/owned_media/citing_prompts?project_id=PROJECT_ID&provider=youtube&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dabc123&range=30', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/dimensions/owned_media/citing_prompts?project_id=PROJECT_ID&provider=youtube&url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3Dabc123&range=30"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/dimensions/reddit?project_id=PROJECT_ID&view=subreddits&range=30"

const response = await fetch("https://api.llmpulse.ai/api/v1/dimensions/reddit?project_id=PROJECT_ID&view=subreddits&range=30", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

import requests

response = requests.get(
    "https://api.llmpulse.ai/api/v1/dimensions/reddit?project_id=PROJECT_ID&view=subreddits&range=30",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
data = response.json()

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/dimensions/reddit?project_id=PROJECT_ID&view=subreddits&range=30",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/dimensions/reddit?project_id=PROJECT_ID&view=subreddits&range=30", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/dimensions/reddit?project_id=PROJECT_ID&view=subreddits&range=30', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/dimensions/reddit?project_id=PROJECT_ID&view=subreddits&range=30"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X GET -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media"

const response = await fetch("https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media", {
  headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();

require 'httparty'

response = HTTParty.get(
  "https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media",
  headers: { "Authorization" => "Bearer YOUR_API_KEY" }
)
data = response.parsed_response

package main

import "net/http"

func main() {
	req, _ := http.NewRequest("GET", "https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media", nil)
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('GET', 'https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY']
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .GET()
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Request

curl -X PATCH -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"instagram_profile_url":"https://www.instagram.com/acme/","reddit_subreddits":["acme","acmeusers"]}' \
  "https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media"

const response = await fetch("https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"instagram_profile_url":"https://www.instagram.com/acme/","reddit_subreddits":["acme","acmeusers"]})
});
const data = await response.json();

import requests

response = requests.patch(
    "https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"instagram_profile_url": "https://www.instagram.com/acme/", "reddit_subreddits": ["acme", "acmeusers"]}
)
data = response.json()

require 'httparty'
require 'json'

response = HTTParty.patch(
  "https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media",
  headers: {
    "Authorization" => "Bearer YOUR_API_KEY",
    "Content-Type" => "application/json"
  },
  body: { "instagram_profile_url" => "https://www.instagram.com/acme/", "reddit_subreddits" => ["acme", "acmeusers"] }.to_json
)
data = response.parsed_response

package main

import (
	"net/http"
	"strings"
)

func main() {
	req, _ := http.NewRequest("PATCH", "https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media", strings.NewReader(`{"instagram_profile_url":"https://www.instagram.com/acme/","reddit_subreddits":["acme","acmeusers"]}`))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")
	client := &http.Client{}
	resp, err := client.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

$client = new GuzzleHttp\Client();
$response = $client->request('PATCH', 'https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media', [
    'headers' => ['Authorization' => 'Bearer YOUR_API_KEY'],
    'json' => ['instagram_profile_url' => 'https://www.instagram.com/acme/', 'reddit_subreddits' => ['acme', 'acmeusers']]
]);
$data = json_decode($response->getBody(), true);

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.llmpulse.ai/api/v1/projects/PROJECT_ID/owned_media"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .method("PATCH", HttpRequest.BodyPublishers.ofString("{\"instagram_profile_url\":\"https://www.instagram.com/acme/\",\"reddit_subreddits\":[\"acme\",\"acmeusers\"]}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    }
}

Owned Media & Communitys

GET/dimensions/owned_media

GET/dimensions/owned_media/summary

GET/dimensions/owned_media/citing_prompts

GET/dimensions/reddit

GET/projects/:id/owned_media

PATCH/projects/:id/owned_media

GET`/dimensions/owned_media`

GET`/dimensions/owned_media/summary`

GET`/dimensions/owned_media/citing_prompts`

GET`/dimensions/reddit`

GET`/projects/:id/owned_media`

PATCH`/projects/:id/owned_media`