v0.2.0-beta

OpenAPI 3.1.0

Content Analysis – API souhrnů

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/summary/live

Content Analysis – API souhrnů

Souhrnný pohled na všechny citace klíčového slova v indexu webu. Vrací total_count, rank, top_domains (každý s domain a count), sentiment_connotations (hněv, štěstí, láska, smutek, sdílení, zábava), connotation_types (pozitivní, negativní, neutrální), text_categories, page_categories, page_types, countries a languages. Toto je centrum rodiny obsahu: post_dataforseo_content_sentiment_analysis_live vrací pouze dva bloky konotací, které už jsou zde obsaženy, takže volejte tento endpoint, pokud výslovně nechcete menší datovou zátěž. Pro jednotlivé citující stránky místo souhrnů použijte post_dataforseo_content_search_live; pro stejný souhrn v čase post_dataforseo_content_phrase_trends_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)[]
- initial_dataset_filters
  Typ: array (object | null)[] | null
  
  parametry filtrování počáteční datové sady
  volitelné pole
  počáteční parametry filtrování, které se vztahují na pole v endpointu Search
  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, has, has_not
  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:
  ["domain","<>", "logitech.com"]
  
  [["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]]
  
  [["domain","<&gt","logitech.com"]], "and", [["content_info.connotation_types.negative",">",1000], "or",
  
  ["content_info.text_category","has",10994]]]
  další informace o filtrech najdete v Content Analysis API - Filters
  další informace o filtrech počáteční datové sady najdete v tomto článku Centra nápovědy.
  
  Prázdný objekt
- internal_list_limit
  Typ: integer | null
  
  maximální počet prvků ve vnitřních polích
  volitelné pole
  toto pole můžete použít k omezení počtu prvků v následujících polích:
  top_domains
  text_categories
  page_categories
  countries
  languages
  výchozí hodnota: 1
  maximální hodnota: 20
- 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": { "snippet": ""logitech mouse"", "main_title": "sale" }
  
  propertyName
  Typ: string | null
- 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"
- positive_connotation_threshold
  Typ: number | null
  
  prahová hodnota pozitivní konotace
  volitelné pole
  udává se jako prahová hodnota indexu pravděpodobnosti pozitivního sentimentu souvisejícího s obsahem citace
  pokud toto pole zadáte, objekt connotation_types v odpovědi bude obsahovat pouze data o citacích s pravděpodobností sentimentu positive větší nebo rovnou zadané hodnotě
  možné hodnoty: od 0 do 1
  výchozí hodnota: 0.4
- rank_scale
  Typ: string | null
  
  určuje škálu použitou pro výpočet a zobrazení hodnot 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
- sentiments_connotation_threshold
  Typ: number | null
  
  prahová hodnota konotace sentimentu
  volitelné pole
  udává se jako prahová hodnota indexu pravděpodobnosti konotací sentimentu souvisejících s obsahem citace
  pokud toto pole zadáte, objekt sentiment_connotations v odpovědi bude obsahovat pouze data o citacích, u nichž
  je pravděpodobnost pro každý sentiment větší nebo rovna zadané hodnotě
  možné hodnoty: od 0 do 1
  výchozí hodnota: 0.4
- 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_ContentAnalysisSummaryLiveResponseInfo
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_ContentAnalysisSummaryLiveTaskInfo
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ů

connotation_types
Typ: object | null

typy konotací
obsahuje typy sentimentů (polaritu sentimentu) související s citací klíčového slova a počet citací pro každý typ sentimentu
možné typy konotací sentimentu: positive, negative, neutral

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

countries
Typ: object | null

země
obsahuje země a počet citací v každé zemi
úplný seznam dostupných zemí najdete v endpointu Locations

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

languages
Typ: object | null

jazyky
obsahuje jazyky a počet citací v každém jazyce
úplný seznam dostupných jazyků najdete v endpointu Languages

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

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

kategorie stránek
obsahuje objekty s kategoriemi stránek a počtem citací v každé kategorii stránky
úplný seznam dostupných kategorií najdete v endpointu Categories

category
Typ: array (integer | null)[] | null
count
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

page_types
Typ: object | null

typy stránek
obsahuje typy stránek a počet citací pro každý typ stránky

propertyName
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

rank
Typ: integer | null

pořadí všech URL citujících keyword
normalizovaný součet pořadí všech URL citujících cílové keyword

sentiment_connotations
Typ: object | null

konotace sentimentu
obsahuje sentimenty (emoční reakce) související s citací cílového klíčového slova a počet citací 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).

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

kategorie textů
obsahuje objekty s kategoriemi textů a počtem citací v každé kategorii textu
úplný seznam dostupných kategorií najdete v endpointu Categories

category
Typ: array (integer | null)[] | null
count
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

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

hlavní domény citující cílové klíčové slovo
obsahuje objekty s hlavními doménami citujícími cílové klíčové slovo a počet citací pro každou doménu

count
Typ: integer | null Formát: int64

Signed 64-bit integers (long type).

domain
Typ: string | null
total_count
Typ: integer | null Formát: int64

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

type
Typ: string | null

typ prvku

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/summary/live

curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "internal_list_limit": 8,
    "positive_connotation_threshold": 0.5
  }
]'

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": [
        {
          "type": null,
          "total_count": null,
          "rank": null,
          "top_domains": [
            {
              "domain": null,
              "count": null
            }
          ],
          "sentiment_connotations": null,
          "connotation_types": null,
          "text_categories": [
            {
              "category": [
                "[Max Depth Exceeded]"
              ],
              "count": null
            }
          ],
          "page_categories": [
            {
              "category": [
                "[Max Depth Exceeded]"
              ],
              "count": null
            }
          ],
          "page_types": null,
          "countries": null,
          "languages": null
        }
      ]
    }
  ]
}

Úspěšná operace

Content Analysis – API souhrnů

OvěřováníRequired

DataForSEO

Content Analysis – API souhrnů

Referenční ceny