Felo API PlatformFelo API Platform
Všechny endpointy DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Content Analysis – API rozdělení hodnocení

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

Content Analysis – API rozdělení hodnocení

​

Rozděluje citace klíčového slova do pásem hodnocení a pro každé uvádí celou sadu metrik. Vrací jednu položku na pásmo s min, max a objektem metrics obsahujícím 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. rank_scale volí rozdělení do pásem. Pro stejné metriky bez rozdělení použijte post_dataforseo_content_summary_live; pro samotný sentiment post_dataforseo_content_sentiment_analysis_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, 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:
      ["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": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}

      • 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

    • 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

    • 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_ContentAnalysisRatingDistributionLiveResponseInfo
    • 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_ContentAnalysisRatingDistributionLiveTaskInfo
        • 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ů

          • max
            Typ: number | null

            maximální hodnocení na škále rozložení

          • metrics
            Typ: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo

            obsahuje metriky rozložení hodnocení

            • 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

          • min
            Typ: number | null

            minimální hodnocení na škále rozložení

          • 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
Request Example for post/v1/beta/dataforseo/content_analysis/rating_distribution/live
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/rating_distribution/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "logitech",
    "search_mode": "as_is",
    "internal_list_limit": 10
  }
]'

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

Úspěšná operace

Content Analysis – Rating Distribution API