Felo API PlatformFelo API Platform
Alle endpoints van DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Content Analysis: beoordelingsverdeling

Felo API Support
MIT
Server:https://openapi.felo.ai
Clientbibliotheken
Shell Curl

DataForSEO

​

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

DataForSEO Operaties

Content Analysis: beoordelingsverdeling

​

Splitst de citaties van een keyword in beoordelingsklassen en rapporteert voor elke klasse de volledige metriekset. Retourneert één item per klasse met min, max en een metrics-object met total_count, rank, top_domains (elk domain en count), sentiment_connotations (anger, happiness, love, sadness, share, fun), connotation_types (positive, negative, neutral), text_categories, page_categories, page_types, countries en languages. rank_scale bepaalt de indeling in klassen. Voor dezelfde metrieken zonder klassen gebruik je post_dataforseo_content_summary_live; voor alleen sentiment post_dataforseo_content_sentiment_analysis_live.

Prijsreferentie

  • Afrekening: gerapporteerde responskosten.
  • Referentieschatting per verzoek: USD 0.0276.
  • Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body
application/json
  • Type: array (object | null)[]
    • initial_dataset_filters
      Type: array (object | null)[] | null

      filterparameters voor de initiële dataset
      optioneel veld
      initiële filterparameters die van toepassing zijn op velden in het Search-endpoint
      u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
      tussen de voorwaarden zet u een logische operator and of or
      de volgende operators worden ondersteund:
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not, match, not_match
      met de operator % in like en not_like kunt u elke tekenreeks van nul of meer tekens matchen
      voorbeeld:
      ["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]]]
      meer informatie over filters vindt u in Content Analysis API - Filters
      meer over de filters van de initiële dataset leest u in dit Help Center-artikel.

      Leeg object
    • internal_list_limit
      Type: integer | null

      maximaal aantal elementen in interne arrays
      optioneel veld
      met dit veld beperkt u het aantal elementen in de volgende arrays:
      top_domains
      text_categories
      page_categories
      countries
      languages
      standaardwaarde: 1
      maximale waarde: 20

    • keyword
      Type: string

      doelkeyword
      verplicht veld
      UTF-8-codering
      de keywords worden omgezet naar kleine letters;
      Let op: gebruik dubbele aanhalingstekens en backslashes om een exacte zin te matchen in plaats van een los keyword;
      voorbeeld:
      "keyword": ""tesla palo alto""

      meer informatie over regels en beperkingen voor de velden keyword en keywords in DataForSEO-API's vindt u in dit Help Center-artikel

    • keyword_fields
      Type: object | null

      doelvelden en doelkeywords
      optioneel veld
      met deze parameter filtert u de dataset op keywords die in bepaalde velden moeten voorkomen;
      velden die u kunt opgeven: title, main_title, previous_title, snippet
      u kunt meerdere velden opgeven;
      Let op: gebruik dubbele aanhalingstekens en backslashes om een exacte zin te matchen in plaats van een los keyword;
      voorbeeld:
      "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}

      • propertyName
        Type: string | null
    • page_type
      Type: array string[] | null

      doeltypen pagina's
      optioneel veld
      met deze parameter filtert u de dataset op paginatypen
      mogelijke waarden:
      "ecommerce", "news", "blogs", "message-boards", "organization"

    • positive_connotation_threshold
      Type: number | null

      drempelwaarde voor positieve connotatie
      optioneel veld
      opgegeven als drempelwaarde voor de waarschijnlijkheidsindex van positief sentiment in de inhoud van de citatie
      als u dit veld opgeeft, bevat het object connotation_types in de respons alleen gegevens over citaties waarvan de waarschijnlijkheid van positive sentiment groter dan of gelijk aan de opgegeven waarde is
      mogelijke waarden: van 0 tot 1
      standaardwaarde: 0.4

    • rank_scale
      Type: string | null

      bepaalt de schaal die wordt gebruikt voor het berekenen en weergeven van de waarden rank
      optioneel veld

      met deze parameter kiest u of rangwaarden op een schaal van 0–100 of 0–1000 worden weergegeven

      mogelijke waarden:
      one_hundred — rangwaarden worden weergegeven op een schaal van 0–100
      one_thousand — rangwaarden worden weergegeven op een schaal van 0–1000

      standaardwaarde: one_thousand

      lees meer over hoe deze parameter werkt in dit Help Center-artikel

    • search_mode
      Type: string | null

      groeperingstype van de resultaten
      optioneel veld
      mogelijke groeperingstypen:
      as_is - retourneert alle citaties voor het doel-keyword
      one_per_domain - retourneert één citatie van het keyword per domein
      standaardwaarde: as_is

    • sentiments_connotation_threshold
      Type: number | null

      drempelwaarde voor sentimentconnotatie
      optioneel veld
      opgegeven als drempelwaarde voor de waarschijnlijkheidsindex van sentimentconnotaties in de inhoud van de citatie
      als u dit veld opgeeft, bevat het object sentiment_connotations in de respons alleen gegevens over citaties waarbij de waarschijnlijkheid per sentiment groter dan of gelijk aan de opgegeven waarde is
      mogelijke waarden: van 0 tot 1
      standaardwaarde: 0.4

    • tag
      Type: string | null

      door gebruiker gedefinieerde taak-ID
      optioneel veld
      de tekenslimiet is 255
      je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
      de opgegeven waarde tag vind je in het data-object van de respons

Responsen
  • 200
    Type: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResponseInfo
    • cost
      Type: number | null Formaat: double

      Totale kosten van taken, USD

    • status_code
      Type: integer | null

      algemene statuscode de volledige lijst met responscodes vindt u hier

    • status_message
      Type: string | null

      algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

    • tasks
      Type: array (object | null)[] | null

      array van taken

      • Type: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveTaskInfo
        • cost
          Type: number | null Formaat: double

          Totale kosten van taken, USD

        • data
          Type: object | null

          Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

          • propertyName
            Type: object | null
        • id
          Type: string | null

          taak-id eenduidige taak-id in ons systeem in UUID-indeling

        • path
          Type: array (string | null)[] | null

          URL-pad

        • result
          Type: array (object | null)[] | null

          array van resultaten

          • max
            Type: number | null

            maximale beoordeling op een verdelingsschaal

          • metrics
            Type: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo

            bevat metrische gegevens over de beoordelingsverdeling

            • connotation_types
              Type: object | null

              connotatietypen
              bevat typen sentimenten (sentimentpolariteit) met betrekking tot de vermelding van het keyword en het aantal vermeldingen per sentimenttype
              mogelijke typen sentimentconnotatie: positive, negative, neutral

              • propertyName
                Type: integer | null Formaat: int64

                Signed 64-bit integers (long type).

            • countries
              Type: object | null

              landen
              bevat landen en het aantal vermeldingen per land
              raadpleeg het eindpunt Locations voor een volledige lijst met beschikbare landen

              • propertyName
                Type: integer | null Formaat: int64

                Signed 64-bit integers (long type).

            • languages
              Type: object | null

              talen
              bevat talen en het aantal vermeldingen per taal
              raadpleeg het eindpunt Languages voor een volledige lijst met beschikbare talen

              • propertyName
                Type: integer | null Formaat: int64

                Signed 64-bit integers (long type).

            • page_categories
              Type: array (object | null)[] | null

              paginacategorieën
              bevat objecten met paginacategorieën en het aantal vermeldingen per paginacategorie
              raadpleeg het eindpunt Categories voor een volledige lijst met beschikbare categorieën

              • category
                Type: array (integer | null)[] | null
              • count
                Type: integer | null Formaat: int64

                Signed 64-bit integers (long type).

            • page_types
              Type: object | null

              paginatypen
              bevat paginatypen en het aantal vermeldingen per paginatype

              • propertyName
                Type: integer | null Formaat: int64

                Signed 64-bit integers (long type).

            • rank
              Type: integer | null

              rang van alle URL's die het keyword vermelden
              genormaliseerde som van de rangen van alle URL's die het doel-keyword vermelden

            • sentiment_connotations
              Type: object | null

              sentimentconnotaties
              bevat sentimenten (emotionele reacties) met betrekking tot de vermelding van het doelkeyword en het aantal vermeldingen per sentiment
              mogelijke sentimentconnotaties: anger, happiness, love, sadness, share, fun

              • propertyName
                Type: integer | null Formaat: int64

                Signed 64-bit integers (long type).

            • text_categories
              Type: array (object | null)[] | null

              tekstcategorieën
              bevat objecten met tekstcategorieën en het aantal vermeldingen per tekstcategorie
              raadpleeg het eindpunt Categories voor een volledige lijst met beschikbare categorieën

              • category
                Type: array (integer | null)[] | null
              • count
                Type: integer | null Formaat: int64

                Signed 64-bit integers (long type).

            • top_domains
              Type: array (object | null)[] | null

              topdomeinen die het doelkeyword vermelden
              bevat objecten met topdomeinen die het doelkeyword vermelden en het aantal vermeldingen per domein

              • count
                Type: integer | null Formaat: int64

                Signed 64-bit integers (long type).

              • domain
                Type: string | null
            • total_count
              Type: integer | null Formaat: int64

              totaal aantal resultaten in onze database dat relevant is voor uw verzoek

            • type
              Type: string | null

              elementtype

          • min
            Type: number | null

            minimale beoordeling op een verdelingsschaal

          • type
            Type: string | null

            elementtype

        • result_count
          Type: integer | null Formaat: int64

          Aantal elementen in de result-array

        • status_code
          Type: integer | null

          statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

        • status_message
          Type: string | null

          informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

        • time
          Type: string | null

          Uitvoeringstijd in seconden

    • tasks_count
      Type: integer | null Formaat: int64

      Het aantal taken in de tasks-array

    • tasks_error
      Type: integer | null Formaat: int64

      Het aantal taken in de tasks-array dat met een fout is geretourneerd

    • time
      Type: string | null

      totale uitvoeringstijd, seconden

    • version
      Type: string | null

      De huidige versie van de API

    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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

Geslaagde bewerking

Content Analysis – Rating Distribution API