Felo API PlatformFelo API Platform
Tutti gli endpoint di DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Content Analysis: distribuzione delle valutazioni

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

DataForSEO

​

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

DataForSEO Operazioni

Content Analysis: distribuzione delle valutazioni

​

Suddivide le citazioni di una keyword in fasce di valutazione e riporta per ciascuna l'intero set di metriche. Restituisce una voce per fascia con min, max e un oggetto metrics che contiene total_count, rank, top_domains (ciascuno con domain e count), sentiment_connotations (anger, happiness, love, sadness, share, fun), connotation_types (positive, negative, neutral), text_categories, page_categories, page_types, countries e languages. rank_scale sceglie la suddivisione in fasce. Per le stesse metriche senza fasce usare post_dataforseo_content_summary_live; per il solo sentiment, post_dataforseo_content_sentiment_analysis_live.

Riferimento prezzi

  • Misurazione: costo della risposta riportato.
  • Stima di riferimento per richiesta: USD 0.0276.
  • Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo cliente già addebitato.

Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Corpo
application/json
  • Tipo: array (object | null)[]
    • initial_dataset_filters
      Tipo: array (object | null)[] | null

      parametri di filtro del dataset iniziale
      campo facoltativo
      parametri di filtro iniziali applicati ai campi dell'endpoint Search
      è possibile aggiungere più filtri contemporaneamente (massimo 8 filtri)
      tra le condizioni impostare un operatore logico and o or
      sono supportati i seguenti operatori:
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not, match, not_match
      con l'operatore % in like e not_like è possibile trovare corrispondenze con qualsiasi stringa di zero o più caratteri
      esempio:
      ["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]]]
      per ulteriori informazioni sui filtri, fare riferimento a Content Analysis API - Filters
      scopri di più sui filtri del dataset iniziale in questo articolo del Help Center.

      Oggetto vuoto
    • internal_list_limit
      Tipo: integer | null

      numero massimo di elementi negli array interni
      campo facoltativo
      è possibile usare questo campo per limitare il numero di elementi nei seguenti array:
      top_domains
      text_categories
      page_categories
      countries
      languages
      valore predefinito: 1
      valore massimo: 20

    • keyword
      Tipo: string

      keyword di destinazione
      campo obbligatorio
      codifica UTF-8
      le keyword vengono convertite in minuscolo;
      Nota: per trovare una frase esatta invece di una singola keyword, usare doppi apici e barre rovesciate;
      esempio:
      "keyword": ""tesla palo alto""

      scopri di più su regole e limiti dei campi keyword e keywords nelle API DataForSEO in questo articolo del Help Center

    • keyword_fields
      Tipo: object | null

      campi delle keyword di destinazione e keyword di destinazione
      campo facoltativo
      usare questo parametro per filtrare il dataset in base alle keyword che determinati campi devono contenere;
      campi specificabili: title, main_title, previous_title, snippet
      è possibile indicare più campi;
      Nota: per trovare una frase esatta invece di una singola keyword, usare doppi apici e barre rovesciate;
      esempio:
      "keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}

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

      tipi di pagina di destinazione
      campo facoltativo
      usare questo parametro per filtrare il dataset per tipi di pagina
      valori possibili:
      "ecommerce", "news", "blogs", "message-boards", "organization"

    • positive_connotation_threshold
      Tipo: number | null

      soglia di connotazione positiva
      campo facoltativo
      specificata come soglia dell'indice di probabilità per il sentiment positivo relativo al contenuto della citazione
      se si specifica questo campo, l'oggetto connotation_types nella risposta conterrà solo i dati delle citazioni con probabilità di sentiment positive maggiore o uguale al valore specificato
      valori possibili: da 0 a 1
      valore predefinito: 0.4

    • rank_scale
      Tipo: string | null

      definisce la scala utilizzata per calcolare e visualizzare i valori rank
      campo facoltativo

      con questo parametro si sceglie se i valori di rank vengono presentati su una scala 0–100 o 0–1000

      valori possibili:
      one_hundred — i valori di rank vengono visualizzati su una scala 0–100
      one_thousand — i valori di rank vengono visualizzati su una scala 0–1000

      valore predefinito: one_thousand

      scopri di più sul funzionamento di questo parametro in questo articolo del Help Center

    • search_mode
      Tipo: string | null

      tipo di raggruppamento dei risultati
      campo facoltativo
      tipi di raggruppamento possibili:
      as_is - restituisce tutte le citazioni per la keyword di destinazione
      one_per_domain - restituisce una citazione della keyword per dominio
      valore predefinito: as_is

    • sentiments_connotation_threshold
      Tipo: number | null

      soglia di connotazione del sentiment
      campo facoltativo
      specificata come soglia dell'indice di probabilità per le connotazioni del sentiment relative al contenuto della citazione
      se si specifica questo campo, l'oggetto sentiment_connotations nella risposta conterrà solo i dati delle citazioni in cui la probabilità per ciascun sentiment è maggiore o uguale al valore specificato
      valori possibili: da 0 a 1
      valore predefinito: 0.4

    • tag
      Tipo: string | null

      identificatore dell'attività definito dall'utente
      campo facoltativo
      il limite di caratteri è 255
      puoi usare questo parametro per identificare l'attività e associarla al risultato
      il valore tag specificato si trova nell'oggetto data della risposta

Risposte
  • 200
    Tipo: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveResponseInfo
    • cost
      Tipo: number | null Formato: double

      Costo totale delle attività, USD

    • status_code
      Tipo: integer | null

      codice di stato generale l'elenco completo dei codici di risposta è disponibile qui

    • status_message
      Tipo: string | null

      messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui

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

      array di attività

      • Tipo: object | null · Response36Afe1097B20_ContentAnalysisRatingDistributionLiveTaskInfo
        • cost
          Tipo: number | null Formato: double

          Costo totale delle attività, USD

        • data
          Tipo: object | null

          Contiene gli stessi parametri specificati nella richiesta POST

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

          identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID

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

          Percorso URL

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

          array di risultati

          • max
            Tipo: number | null

            valutazione massima su una scala di distribuzione

          • metrics
            Tipo: object | null · Response36Afe1097B20_ContentAnalysisSummaryInfo

            contiene metriche di distribuzione delle valutazioni

            • connotation_types
              Tipo: object | null

              tipi di connotazione
              contiene i tipi di sentiment (polarità del sentiment) relativi alla citazione della keyword e il numero di citazioni per ogni tipo di sentiment
              tipi di connotazione del sentiment possibili: positive, negative, neutral

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • countries
              Tipo: object | null

              paesi
              contiene i paesi e il numero di citazioni in ciascun paese
              per ottenere un elenco completo dei paesi disponibili, fai riferimento all'endpoint Locations

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • languages
              Tipo: object | null

              lingue
              contiene le lingue e il numero di citazioni in ciascuna lingua
              per ottenere un elenco completo delle lingue disponibili, fai riferimento all'endpoint Languages

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

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

              categorie di pagina
              contiene oggetti con le categorie di pagina e il numero di citazioni in ciascuna categoria di pagina
              per ottenere un elenco completo delle categorie disponibili, fai riferimento all'endpoint Categories

              • category
                Tipo: array (integer | null)[] | null
              • count
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • page_types
              Tipo: object | null

              tipi di pagina
              contiene i tipi di pagina e il numero di citazioni per ciascun tipo di pagina

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • rank
              Tipo: integer | null

              posizione di tutti gli URL che citano la keyword
              somma normalizzata delle posizioni di tutti gli URL che citano la keyword di destinazione

            • sentiment_connotations
              Tipo: object | null

              connotazioni del sentiment
              contiene i sentiment (reazioni emotive) relativi alla citazione della keyword di destinazione e il numero di citazioni per ogni sentiment
              possibili connotazioni del sentiment: anger, happiness, love, sadness, share, fun

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

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

              categorie di testo
              contiene oggetti con le categorie di testo e il numero di citazioni in ciascuna categoria di testo
              per ottenere un elenco completo delle categorie disponibili, fai riferimento all'endpoint Categories

              • category
                Tipo: array (integer | null)[] | null
              • count
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

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

              domini principali che citano la keyword di destinazione
              contiene oggetti con i domini principali che citano la keyword di destinazione e il numero di citazioni per ogni dominio

              • count
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

              • domain
                Tipo: string | null
            • total_count
              Tipo: integer | null Formato: int64

              quantità totale di risultati nel nostro database pertinenti alla tua richiesta

            • type
              Tipo: string | null

              tipo di elemento

          • min
            Tipo: number | null

            valutazione minima su una scala di distribuzione

          • type
            Tipo: string | null

            tipo di elemento

        • result_count
          Tipo: integer | null Formato: int64

          Numero di elementi nell'array dei risultati

        • status_code
          Tipo: integer | null

          codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui

        • status_message
          Tipo: string | null

          messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui

        • time
          Tipo: string | null

          Tempo di esecuzione in secondi

    • tasks_count
      Tipo: integer | null Formato: int64

      Il numero di attività nell'array tasks

    • tasks_error
      Tipo: integer | null Formato: int64

      Il numero di attività nell'array tasks restituite con un errore

    • time
      Tipo: string | null

      tempo di esecuzione totale, secondi

    • version
      Tipo: string | null

      La versione corrente dell'API

    application/json
  • 400

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    Risposta di errore; le risposte passthrough upstream possono usare formati del provider

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

Operazione riuscita

Content Analysis – Rating Distribution API