v0.2.0-beta

OpenAPI 3.1.0

Content Analysis – API wyszukiwania

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operacje

post/v1/beta/dataforseo/content_analysis/search/live

Content Analysis – API wyszukiwania

Zwraca listę poszczególnych stron cytujących słowo kluczowe, a nie sumy. Każdy element zawiera url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score i page_category, a także total_count i items_count. filters przyjmuje pola wymienione przez get_dataforseo_content_available_filters. Dla liczb i rozkładów zamiast stron użyj post_dataforseo_content_summary_live.

Informacje o cenach

Rozliczanie: zgłoszony koszt odpowiedzi.
Referencyjny szacunek kosztu żądania: USD 0.0276.
Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne — nie oferta dla konta, nie gwarantowana cena ani limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść

application/json

Typ: array (object | null)[]
- filters
  Typ: array (object | null)[] | null
  
  tablica parametrów filtrowania wyników
  pole opcjonalne
  możesz dodać kilka filtrów jednocześnie (maksymalnie 8)
  między warunkami należy ustawić operator logiczny and, or
  obsługiwane są następujące operatory:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, match, not_match
  operatora % możesz użyć z like i not_like, aby dopasować dowolny ciąg złożony z zera lub więcej znaków
  przykład:
  ["country","=", "US"]
  
  [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]]
  
  [["domain_rank",">",800], "and", [["page_types","has","ecommerce"], "or",
  
  ["content_info.text_category","has",10994]]]
  więcej informacji o filtrach znajdziesz w Content Analysis API - Filters
  
  Pusty obiekt
- keyword
  Typ: string
  
  docelowe słowo kluczowe
  pole wymagane
  kodowanie UTF-8
  słowa kluczowe zostaną przekonwertowane na format małych liter;
  Uwaga: aby dopasować dokładną frazę zamiast pojedynczego słowa kluczowego, użyj podwójnych cudzysłowów i ukośników odwrotnych;
  przykład:
  "keyword": "\"tesla palo alto\""
  
  więcej o zasadach i ograniczeniach pól keyword i keywords w interfejsach API DataForSEO znajdziesz w tym artykule Centrum pomocy
- keyword_fields
  Typ: object | null
  
  docelowe pola słów kluczowych i docelowe słowa kluczowe
  pole opcjonalne
  użyj tego parametru, aby filtrować zbiór danych według słów kluczowych, które powinny zawierać określone pola;
  pola, które możesz podać: title, main_title, previous_title, snippet
  możesz wskazać kilka pól;
  Uwaga: aby dopasować dokładną frazę zamiast pojedynczego słowa kluczowego, użyj podwójnych cudzysłowów i ukośników odwrotnych;
  przykład:
  "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"
  
  propertyName
  Typ: string | null
- limit
  Typ: integer | null
  
  maksymalna liczba zwracanych cytowań
  pole opcjonalne
  wartość domyślna: 100
  wartość maksymalna: 1000
- offset
  Typ: integer | null
  
  przesunięcie w tablicy wyników zwracanych cytowań
  pole opcjonalne
  wartość domyślna: 0
  jeśli podasz wartość 10, pierwsze dziesięć cytowań w tablicy wyników zostanie pominiętych, a dane zostaną zwrócone dla kolejnych cytowań
  Uwaga: zalecamy używanie tego parametru tylko przy pobieraniu do 10 000 wyników
  do pobierania ponad 10 000 wyników użyj zamiast tego offset_token.
- offset_token
  Typ: string | null
  
  token przesunięcia dla kolejnych żądań
  pole opcjonalne
  podawany w tym samym polu odpowiedzi na każde żądanie;
  użyj tego parametru, aby uniknąć przekroczeń limitu czasu podczas próby uzyskania ponad 10 000 wyników w jednym żądaniu;
  podając unikalną wartość offset_token z tablicy odpowiedzi, otrzymasz kolejne wyniki początkowego zadania;
  wartości offset_token są unikalne dla każdego kolejnego zadania
  Uwaga: jeśli w żądaniu podano offset_token, wszystkie pozostałe parametry oprócz limit nie będą brane pod uwagę podczas przetwarzania zadania
  więcej o tym parametrze znajdziesz w naszym Centrum pomocy
- order_by
  Typ: array string[] | null
  
  zasady sortowania wyników
  pole opcjonalne
  do sortowania wyników możesz użyć tych samych wartości co w tablicy filters
  możliwe typy sortowania:
  asc — wyniki zostaną posortowane rosnąco
  desc — wyniki zostaną posortowane malejąco
  typ sortowania ustawia się przecinkiem
  przykład:
  ["content_info.sentiment_connotations.anger,desc"]
  domyślna reguła:
  ["content_info.sentiment_connotations.anger,desc"]
  pamiętaj, że w jednym żądaniu można ustawić nie więcej niż trzy zasady sortowania
  kilka zasad sortowania należy oddzielić przecinkiem
  przykład:
  ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]
- page_type
  Typ: array string[] | null
  
  docelowe typy stron
  pole opcjonalne
  użyj tego parametru, aby filtrować zbiór danych według typów stron
  możliwe wartości:
  "ecommerce", "news", "blogs", "message-boards", "organization"
- rank_scale
  Typ: string | null
  
  określa skalę użytą do obliczania i wyświetlania wartości domain_rank i url_rank
  pole opcjonalne
  
  tego parametru możesz użyć, aby wybrać, czy wartości rank są prezentowane w skali 0–100 czy 0–1000
  
  możliwe wartości:
  one_hundred — wartości rank są wyświetlane w skali 0–100
  one_thousand — wartości rank są wyświetlane w skali 0–1000
  
  wartość domyślna: one_thousand
  
  więcej o działaniu tego parametru znajdziesz w tym artykule Centrum pomocy
- search_mode
  Typ: string | null
  
  typ grupowania wyników
  pole opcjonalne
  możliwe typy grupowania:
  as_is — zwraca wszystkie cytowania dla docelowego keyword
  one_per_domain — zwraca jedno cytowanie keyword na domenę
  wartość domyślna: as_is
- tag
  Typ: string | null
  
  identyfikator zadania zdefiniowany przez użytkownika
  pole opcjonalne
  limit znaków: 255
  ten parametr służy do identyfikacji zadania i dopasowania go do wyniku
  podaną wartość tag znajdziesz w obiekcie data odpowiedzi

Odpowiedzi

200
Typ: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

status_code
Typ: integer | null

ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

tasks
Typ: array (object | null)[] | null

tablica zadań

Typ: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveTaskInfo
cost
Typ: number | null Format: double

łączny koszt zadań, USD

data
Typ: object | null

zawiera te same parametry, które podano w żądaniu POST

propertyName
Typ: object | null
id
Typ: string | null

identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID

path
Typ: array (string | null)[] | null

ścieżka URL

result
Typ: array (object | null)[] | null

tablica wyników

items
Typ: array (object | null)[] | null

zawiera cytowania i powiązane dane

content_info
Typ: object | null · Response36Afe1097B20_AnalysisContentInfo

zawiera dane o cytowaniach z podanego url

author
Typ: string | null

autor treści

connotation_types
Typ: object | null

typy konotacji
zawiera typy sentymentów (polaryzację sentymentu) powiązane z danym cytowaniem oraz wskaźnik prawdopodobieństwa dla każdego typu sentymentu
możliwe typy konotacji sentymentu: positive, negative, neutral

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

content_quality_score
Typ: integer | null

wynik jakości treści
ta wartość jest obliczana na podstawie liczby słów, zdań i znaków zawartych w treści

content_type
Typ: string | null

typ treści
przykład:
page_content, comment

date_published
Typ: string | null

data i godzina publikacji treści
w formacie UTC: "yyyy-mm-dd hh-mm-ss +00:00"
przykład:
2017-01-24 13:20:59 +00:00

group_date
Typ: string | null

data i godzina grupy cytowań
wskazuje datę publikacji treści lub datę i godzinę pierwszego odwiedzenia strony przez nasz crawler;
tego pola można użyć do grupowania cytowań według daty i wyświetlania trendów cytowań;
data i godzina są podane w formacie UTC: "yyyy-mm-dd hh-mm-ss +00:00"
przykład:
2017-01-24 13:20:59 +00:00

highlighted_text
Typ: string | null

wyróżniony tekst z snippet

language
Typ: string | null

główny język domeny
pełną listę dostępnych języków znajdziesz w endpointcie Languages

level
Typ: integer | null

poziom nagłówka title
wskazuje poziom znacznika h od 1 (najwyższy) do 6 (najniższy)

main_title
Typ: string | null

tytuł strony

previous_title
Typ: string | null

tytuł poprzedniego bloku treści

rating
Typ: object | null · Response36Afe1097B20_ContententRatingInfo

ocena treści
ocena powiązana z content_info

max_rating_value
Typ: number | null Format: double

maksymalna wartość dla nazwy oceny

name
Typ: string | null

nazwa oceny tutaj znajdziesz następujące elementy: Max5, Percents, CustomMax

rating_count
Typ: integer | null Format: int64

liczba głosów

rating_value
Typ: number | null Format: double

wartość oceny

relative_rating
Typ: number | null Format: double

ocena względna

semantic_location
Typ: string | null

lokalizacja semantyczna
wskazuje element semantyczny w HTML, w którym znajduje się cytowanie docelowego słowa kluczowego
przykład:
article, header

sentiment_connotations
Typ: object | null

konotacje sentymentu
zawiera sentymenty (reakcje emocjonalne) powiązane z danym cytowaniem oraz wskaźnik prawdopodobieństwa dla każdego sentymentu
możliwe konotacje sentymentu: anger, happiness, love, sadness, share, fun

propertyName
Typ: integer | null Format: int64

Signed 64-bit integers (long type).

snippet
Typ: string | null

fragment treści

snippet_length
Typ: integer | null

długość fragmentu w znakach

social_metrics
Typ: array (object | null)[] | null

mierniki zaangażowania w mediach społecznościowych
dane o interakcjach w mediach społecznościowych powiązanych z treścią, na podstawie osadzeń witryn tworzonych i obsługiwanych przez platformy społecznościowe

like_count
Typ: integer | null Format: int64

liczba polubień

type
Typ: string | null

typ elementu

text_category
Typ: array integer[] | null

kategoria tekstu
pełną listę dostępnych kategorii znajdziesz w endpoincie Categories

title
Typ: string | null

tytuł wyniku

country
Typ: string | null

kod kraju rejestracji domeny
pełną listę dostępnych krajów znajdziesz w endpointcie Locations

domain
Typ: string | null

nazwa domeny

domain_rank
Typ: integer | null

ranking domeny domain
wartość oparta na danych o linkach zwrotnych dla danej domeny z DataForSEO Backlink Index;
domain_rank jest obliczany metodą rankingu węzłów w połączonej bazie danych — zasadą stosowaną w oryginalnym algorytmie Google PageRank
więcej o mierniku i sposobie jego obliczania znajdziesz w tym artykule Centrum Pomocy

fetch_time
Typ: string | null

data i godzina, kiedy nasz crawler odwiedził stronę
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:
2017-01-24 13:20:59 +00:00

language
Typ: string | null

główny język domeny
pełną listę dostępnych języków znajdziesz w endpointcie Languages

main_domain
Typ: string | null

główna domena

page_category
Typ: array integer[] | null

zawiera wszystkie istotne kategorie stron
kategorie produktów i usług istotne dla strony
pełną listę dostępnych kategorii znajdziesz w endpointcie Categories

page_types
Typ: array string[] | null

typy stron

ratings
Typ: array (object | null)[] | null

oceny znalezione na stronie
wszystkie oceny znalezione na stronie na podstawie mikrodanych

max_rating_value
Typ: number | null Format: double

maksymalna wartość dla nazwy oceny

name
Typ: string | null

nazwa oceny tutaj znajdziesz następujące elementy: Max5, Percents, CustomMax

rating_count
Typ: integer | null Format: int64

liczba głosów

rating_value
Typ: number | null Format: double

wartość oceny

relative_rating
Typ: number | null Format: double

ocena względna

score
Typ: number | null

wskaźnik ekspozycji cytowania
wartość oparta na url_rank, domain_rank, obecności keyword w title, main_title, url, snippet
im wyższy score, tym większą wartość ma powiązane cytowanie

social_metrics
Typ: array (object | null)[] | null

mierniki zaangażowania w mediach społecznościowych
dane o interakcjach w mediach społecznościowych powiązanych z treścią, na podstawie osadzeń witryn tworzonych i obsługiwanych przez platformy społecznościowe

like_count
Typ: integer | null Format: int64

liczba polubień

type
Typ: string | null

typ elementu

spam_score
Typ: integer | null

ocena spamu linków zwrotnych url
wartość oparta na danych o linkach zwrotnych dla danego URL z DataForSEO Backlink Index;
więcej o sposobie obliczania tego miernika znajdziesz na tej stronie Centrum Pomocy

type
Typ: string | null

typ elementu

url
Typ: string | null

URL, pod którym znaleziono cytowanie

url_rank
Typ: integer | null

ranking url
wartość oparta na danych o linkach zwrotnych dla danego URL z DataForSEO Backlink Index;
url_rank jest obliczany metodą rankingu węzłów w połączonej bazie danych — zasadą stosowaną w oryginalnym algorytmie Google PageRank
więcej o mierniku i sposobie jego obliczania znajdziesz w tym artykule Centrum Pomocy

items_count
Typ: integer | null Format: int64

liczba wyników zwróconych w tablicy items

offset_token
Typ: string | null

token przesunięcia dla kolejnych żądań
ciąg podany w tym polu możesz użyć, aby pobrać kolejne wyniki początkowego zadania;
uwaga: wartości offset_token są unikalne dla każdego kolejnego zadania

total_count
Typ: integer | null Format: int64

łączna liczba wyników w naszej bazie danych odpowiadających Twojemu żądaniu

result_count
Typ: integer | null Format: int64

liczba elementów w tablicy result

status_code
Typ: integer | null

kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj

status_message
Typ: string | null

komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj

time
Typ: string | null

czas wykonania, sekundy

tasks_count
Typ: integer | null Format: int64

liczba zadań w tablicy tasks

tasks_error
Typ: integer | null Format: int64

liczba zadań w tablicy tasks zwróconych z błędem

time
Typ: string | null

łączny czas wykonania, sekundy

version
Typ: string | null

bieżąca wersja interfejsu API
application/json
400

Nie można przetworzyć żądania. Sprawdź parametry żądania.
401

Wymagany jest prawidłowy klucz API Felo.
402

Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
403

Konto nie ma uprawnień do wykonania tej operacji.
429

Osiągnięto limit żądań lub wydatków.
502

Usługa nie mogła ukończyć żądania.
503

API lub usługa rozliczeniowa jest tymczasowo niedostępna.
504

Upłynął limit czasu usługi podczas przetwarzania żądania.
default

Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

application/json

post/v1/beta/dataforseo/content_analysis/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword_fields": {
      "snippet": "logitech"
    },
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "search_mode": "as_is",
    "filters": [
      "main_domain",
      "=",
      "reviewfinder.ca"
    ],
    "order_by": [
      "content_info.sentiment_connotations.anger,desc"
    ],
    "limit": 10
  }
]'

Pokaż schemat

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "offset_token": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "main_domain": null,
              "url_rank": null,
              "spam_score": null,
              "domain_rank": null,
              "fetch_time": null,
              "country": null,
              "language": null,
              "score": null,
              "page_category": [
                "[Max Depth Exceeded]"
              ],
              "page_types": [
                "[Max Depth Exceeded]"
              ],
              "ratings": [
                "[Max Depth Exceeded]"
              ],
              "social_metrics": [
                "[Max Depth Exceeded]"
              ],
              "content_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operacja zakończona powodzeniem

Content Analysis – API wyszukiwania

UwierzytelnianieRequired

DataForSEO

Content Analysis – API wyszukiwania

Informacje o cenach