v0.2.0-beta

OpenAPI 3.1.0

Content Analysis – API vyhledávání

Felo API Support

MIT

Server

https://openapi.felo.ai

Klientské knihovny

Shell Curl

DataForSEO

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

DataForSEO Operace

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

Content Analysis – API vyhledávání

Vypisuje jednotlivé stránky citující klíčové slovo místo souhrnů. Každá položka nese url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score a page_category spolu s total_count a items_count. filters přijímá pole uvedená v get_dataforseo_content_available_filters. Pro počty a rozdělení místo stránek použijte post_dataforseo_content_summary_live.

Referenční ceny

Účtování: vykázaná cena odpovědi.
Referenční odhad ceny požadavku: USD 0.0276.
Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata — nikoli nabídka pro účet, garantovaná cena ani limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo

application/json

Typ: array (object | null)[]
- filters
  Typ: array (object | null)[] | null
  
  pole parametrů filtrování výsledků
  volitelné pole
  můžete přidat několik filtrů najednou (maximálně 8)
  mezi podmínkami je nutné nastavit logický operátor and, or
  podporované operátory:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, match, not_match
  operátor % můžete použít s like a not_like pro shodu s libovolným řetězcem o nule nebo více znacích
  příklad:
  ["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]]]
  další informace o filtrech najdete v Content Analysis API - Filters
  
  Prázdný objekt
- keyword
  Typ: string
  
  cílové klíčové slovo
  povinné pole
  kódování UTF-8
  klíčová slova budou převedena na malá písmena;
  Poznámka: pro shodu s přesnou frází namísto samostatného klíčového slova použijte dvojité uvozovky a zpětná lomítka;
  příklad:
  "keyword": "\"tesla palo alto\""
  
  další informace o pravidlech a omezeních polí keyword a keywords v rozhraních API DataForSEO najdete v tomto článku Centra nápovědy
- keyword_fields
  Typ: object | null
  
  cílová pole klíčových slov a cílová klíčová slova
  volitelné pole
  tento parametr použijte k filtrování datové sady podle klíčových slov, která mají určitá pole obsahovat;
  pole, která můžete zadat: title, main_title, previous_title, snippet
  můžete uvést několik polí;
  Poznámka: pro shodu s přesnou frází namísto samostatného klíčového slova použijte dvojité uvozovky a zpětná lomítka;
  příklad:
  "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"
  
  propertyName
  Typ: string | null
- limit
  Typ: integer | null
  
  maximální počet vrácených citací
  volitelné pole
  výchozí hodnota: 100
  maximální hodnota: 1000
- offset
  Typ: integer | null
  
  posun v poli výsledků vrácených citací
  volitelné pole
  výchozí hodnota: 0
  pokud zadáte hodnotu 10, prvních deset citací v poli výsledků bude vynecháno a data budou poskytnuta pro následující citace
  Poznámka: tento parametr doporučujeme používat pouze při načítání do 10 000 výsledků
  pro načtení více než 10 000 výsledků použijte místo toho offset_token.
- offset_token
  Typ: string | null
  
  token posunu pro následné požadavky
  volitelné pole
  je uveden ve stejném poli odpovědi na každý požadavek;
  tento parametr použijte, abyste se vyhnuli vypršení časového limitu při pokusu o získání více než 10 000 výsledků v jednom požadavku;
  zadáním jedinečné hodnoty offset_token z pole odpovědi získáte následné výsledky počáteční úlohy;
  hodnoty offset_token jsou jedinečné pro každou následnou úlohu
  Poznámka: pokud je v požadavku uveden offset_token, všechny ostatní parametry kromě limit se při zpracování úlohy neberou v úvahu
  další informace o tomto parametru najdete v našem Centru nápovědy
- order_by
  Typ: array string[] | null
  
  pravidla řazení výsledků
  volitelné pole
  k řazení výsledků můžete použít stejné hodnoty jako v poli filters
  možné typy řazení:
  asc — výsledky budou seřazeny vzestupně
  desc — výsledky budou seřazeny sestupně
  typ řazení se nastavuje čárkou
  příklad:
  ["content_info.sentiment_connotations.anger,desc"]
  výchozí pravidlo:
  ["content_info.sentiment_connotations.anger,desc"]
  pamatujte, že v jednom požadavku lze nastavit nejvýše tři pravidla řazení
  několik pravidel řazení je nutné oddělit čárkou
  příklad:
  ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]
- page_type
  Typ: array string[] | null
  
  cílové typy stránek
  volitelné pole
  tento parametr použijte k filtrování datové sady podle typů stránek
  možné hodnoty:
  "ecommerce", "news", "blogs", "message-boards", "organization"
- rank_scale
  Typ: string | null
  
  určuje škálu použitou pro výpočet a zobrazení hodnot domain_rank a url_rank
  volitelné pole
  
  tento parametr můžete použít k volbě, zda se hodnoty rank zobrazují na škále 0–100, nebo 0–1000
  
  možné hodnoty:
  one_hundred — hodnoty rank se zobrazují na škále 0–100
  one_thousand — hodnoty rank se zobrazují na škále 0–1000
  
  výchozí hodnota: one_thousand
  
  další informace o tom, jak tento parametr funguje, najdete v tomto článku Centra nápovědy
- search_mode
  Typ: string | null
  
  typ seskupení výsledků
  volitelné pole
  možné typy seskupení:
  as_is — vrací všechny citace pro cílový keyword
  one_per_domain — vrací jednu citaci keyword na doménu
  výchozí hodnota: as_is
- tag
  Typ: string | null
  
  uživatelem definovaný identifikátor úlohy
  volitelné pole
  limit znaků je 255
  tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
  zadanou hodnotu tag najdete v objektu data odpovědi

Odpovědi

200
Typ: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

status_code
Typ: integer | null

obecný kód stavu úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

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

pole úloh

Typ: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveTaskInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

data
Typ: object | null

obsahuje stejné parametry, které jste zadali v požadavku POST

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

identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

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

cesta URL

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

pole výsledků

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

obsahuje citace a související data

content_info
Typ: object | null · Response36Afe1097B20_AnalysisContentInfo

obsahuje data o citacích z dané url

author
Typ: string | null

autor obsahu

connotation_types
Typ: object | null

typy konotací
obsahuje typy sentimentu (polaritu sentimentu) související s danou citací a index pravděpodobnosti pro každý typ sentimentu
možné typy konotace sentimentu: positive, negative, neutral

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

content_quality_score
Typ: integer | null

skóre kvality obsahu
tato hodnota se vypočítává na základě počtu slov, vět a znaků, které obsah obsahuje

content_type
Typ: string | null

typ obsahu
příklad:
page_content, comment

date_published
Typ: string | null

datum a čas publikace obsahu
ve formátu UTC: "yyyy-mm-dd hh-mm-ss +00:00"
příklad:
2017-01-24 13:20:59 +00:00

group_date
Typ: string | null

datum a čas skupiny citací
označuje datum publikace obsahu nebo datum a čas, kdy náš crawler stránku poprvé navštívil;
toto pole lze použít k seskupení citací podle data a zobrazení trendů citací;
datum a čas jsou uvedeny ve formátu UTC: "yyyy-mm-dd hh-mm-ss +00:00"
příklad:
2017-01-24 13:20:59 +00:00

highlighted_text
Typ: string | null

zvýrazněný text z snippet

language
Typ: string | null

hlavní jazyk domény
úplný seznam dostupných jazyků najdete v endpointu Languages

level
Typ: integer | null

úroveň nadpisu title
označuje úroveň značky h od 1 (nejvyšší) po 6 (nejnižší)

main_title
Typ: string | null

název stránky

previous_title
Typ: string | null

název předchozího bloku obsahu

rating
Typ: object | null · Response36Afe1097B20_ContententRatingInfo

hodnocení obsahu
hodnocení související s content_info

max_rating_value
Typ: number | null Formát: double

maximální hodnota pro název hodnocení

name
Typ: string | null

název hodnocení zde najdete následující prvky: Max5, Percents, CustomMax

rating_count
Typ: integer | null Formát: int64

počet hlasů

rating_value
Typ: number | null Formát: double

hodnota hodnocení

relative_rating
Typ: number | null Formát: double

relativní hodnocení

semantic_location
Typ: string | null

sémantická lokalita
označuje sémantický prvek v HTML, kde se nachází citace cílového klíčového slova
příklad:
article, header

sentiment_connotations
Typ: object | null

konotace sentimentu
obsahuje sentimenty (emoční reakce) související s danou citací a index pravděpodobnosti pro každý sentiment
možné konotace sentimentu: anger, happiness, love, sadness, share, fun

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

snippet
Typ: string | null

úryvek obsahu

snippet_length
Typ: integer | null

délka úryvku v znacích

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

metriky zapojení na sociálních sítích
data o interakcích na sociálních sítích spojených s obsahem na základě vložení webů vytvářených a podporovaných platformami sociálních sítí

like_count
Typ: integer | null Formát: int64

počet lajků

type
Typ: string | null

typ prvku

text_category
Typ: array integer[] | null

kategorie textu
úplný seznam dostupných kategorií najdete v endpointu Categories

title
Typ: string | null

název výsledku

country
Typ: string | null

kód země registrace domény
úplný seznam dostupných zemí najdete v endpointu Locations

domain
Typ: string | null

název domény

domain_rank
Typ: integer | null

pořadí domény domain
tato hodnota vychází z dat o zpětných odkazech pro danou doménu z DataForSEO Backlink Index;
domain_rank se počítá metodou hodnocení uzlů v propojené databázi – principem použitým v původním algoritmu Google PageRank
více o metrice a jejím výpočtu najdete v tomto článku nápovědy

fetch_time
Typ: string | null

datum a čas, kdy náš crawler navštívil stránku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00“
příklad:
2017-01-24 13:20:59 +00:00

language
Typ: string | null

hlavní jazyk domény
úplný seznam dostupných jazyků najdete v endpointu Languages

main_domain
Typ: string | null

hlavní doména

page_category
Typ: array integer[] | null

obsahuje všechny relevantní kategorie stránek
kategorie produktů a služeb relevantní pro stránku
úplný seznam dostupných kategorií najdete v endpointu Categories

page_types
Typ: array string[] | null

typy stránek

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

hodnocení nalezená na stránce
všechna hodnocení nalezená na stránce na základě mikrodat

max_rating_value
Typ: number | null Formát: double

maximální hodnota pro název hodnocení

name
Typ: string | null

název hodnocení zde najdete následující prvky: Max5, Percents, CustomMax

rating_count
Typ: integer | null Formát: int64

počet hlasů

rating_value
Typ: number | null Formát: double

hodnota hodnocení

relative_rating
Typ: number | null Formát: double

relativní hodnocení

score
Typ: number | null

skóre výraznosti citace
tato hodnota vychází z url_rank, domain_rank, přítomnosti keyword v title, main_title, url, snippet
čím vyšší je score, tím větší hodnotu příslušná citace má

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

metriky zapojení na sociálních sítích
data o interakcích na sociálních sítích spojených s obsahem na základě vložení webů vytvářených a podporovaných platformami sociálních sítí

like_count
Typ: integer | null Formát: int64

počet lajků

type
Typ: string | null

typ prvku

spam_score
Typ: integer | null

skóre spamu zpětných odkazů url
tato hodnota vychází z dat o zpětných odkazech pro danou URL z DataForSEO Backlink Index;
více o tom, jak se metrika počítá, najdete na této stránce nápovědy

type
Typ: string | null

typ prvku

url
Typ: string | null

URL, kde byla citace nalezena

url_rank
Typ: integer | null

pořadí url
tato hodnota vychází z dat o zpětných odkazech pro danou URL z DataForSEO Backlink Index;
url_rank se počítá metodou hodnocení uzlů v propojené databázi – principem použitým v původním algoritmu Google PageRank
více o metrice a jejím výpočtu najdete v tomto článku nápovědy

items_count
Typ: integer | null Formát: int64

počet výsledků vrácených v poli items

offset_token
Typ: string | null

token posunu pro následné požadavky
řetězec uvedený v tomto poli můžete použít k získání následných výsledků počáteční úlohy;
poznámka: hodnoty offset_token jsou jedinečné pro každou následnou úlohu

total_count
Typ: integer | null Formát: int64

celkový počet výsledků v naší databázi relevantních pro váš požadavek

result_count
Typ: integer | null Formát: int64

počet prvků v poli result

status_code
Typ: integer | null

stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

time
Typ: string | null

doba provedení, sekundy

tasks_count
Typ: integer | null Formát: int64

počet úloh v poli tasks

tasks_error
Typ: integer | null Formát: int64

počet úloh v poli tasks vrácených s chybou

time
Typ: string | null

celková doba provádění, sekundy

version
Typ: string | null

aktuální verze API
application/json
400

Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
401

Je vyžadován platný API klíč Felo.
402

V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
403

Účet nemá oprávnění tuto operaci provést.
429

Byl dosažen limit požadavků nebo útraty.
502

Služba nemohla požadavek dokončit.
503

API nebo fakturační služba je dočasně nedostupná.
504

Při zpracování požadavku vypršel časový limit služby.
default

Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

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
  }
]'

Zobrazit schéma

{
  "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]"
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

Content Analysis – API vyhledávání

OvěřováníRequired

DataForSEO

Content Analysis – API vyhledávání

Referenční ceny