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

Live: Google AI Mode SERP HTML

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

Live: Google AI Mode SERP HTML

​

Restituisce in modo sincrono la risposta AI Mode di Google per una query, con le fonti che cita su Google. Sorgente grezza della pagina anziché risultati analizzati. Racchiuso nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code – una richiesta rifiutata restituisce comunque HTTP 200.

Riferimento prezzi

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

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

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

      tipo di dispositivo
      campo facoltativo
      restituisce i risultati per un tipo di dispositivo specifico
      può assumere i valori:desktop, mobile
      valore predefinito: desktop

    • keyword
      Tipo: string

      keyword
      campo obbligatorio
      è possibile specificare fino a 700 caratteri nel campo keyword
      tutti i %## verranno decodificati (inoltre il carattere '+' verrà decodificato in uno spazio)
      se è necessario usare il carattere '%' per il keyword, specificarlo come '%25';
      se è necessario usare il carattere '+' per il keyword, specificarlo come '%2B';

    • language_code
      Tipo: string

      codice lingua del motore di ricerca
      campo obbligatorio se non si specifica language_name;
      se si usa questo campo, non è necessario specificare language_name;
      è possibile ricevere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_code effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/google/ai_mode/languages

    • language_name
      Tipo: string

      nome completo della lingua del motore di ricerca
      campo obbligatorio se non si specifica language_code;
      se si usa questo campo, non è necessario specificare language_code;
      è possibile ricevere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_name effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/google/ai_mode/languages;

    • location_code
      Tipo: integer

      codice posizione del motore di ricerca
      campo obbligatorio se non si specifica location_name o location_coordinate
      se si usa questo campo, non è necessario specificare location_name o location_coordinate
      è possibile ricevere l'elenco delle posizioni disponibili dei motori di ricerca con il relativo location_code effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      esempio:
      2840

    • location_coordinate
      Tipo: string

      coordinate GPS di una località
      campo obbligatorio se non si specifica location_name o location_code
      se si usa questo campo, non è necessario specificare location_name o location_code
      il parametro location_coordinate deve essere specificato nel formato "latitude,longitude,radius"
      numero massimo di cifre decimali per "latitude" e "longitude": 7
      valore minimo per "radius": 199.9 (mm)
      valore massimo per "radius": 199999 (mm)
      esempio:
      53.476225,-2.243572,200

    • location_name
      Tipo: string

      nome completo della posizione del motore di ricerca
      campo obbligatorio se non si specifica location_code o location_coordinate
      se si usa questo campo, non è necessario specificare location_code o location_coordinate
      è possibile ricevere l'elenco delle posizioni disponibili del motore di ricerca con il relativo location_name effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      esempio:
      London,England,United Kingdom

    • os
      Tipo: string | null

      sistema operativo del dispositivo
      campo facoltativo
      se si specifica desktop nel campo device, scegliere tra i seguenti valori: windows, macos
      valore predefinito: windows
      se si specifica mobile nel campo device, scegliere tra i seguenti valori: android, ios
      valore predefinito: android

    • 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_SerpGoogleAiModeLiveHtmlResponseInfo
    • 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_SerpGoogleAiModeLiveHtmlTaskInfo
        • 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

          • datetime
            Tipo: string | null

            data e ora di ricezione del risultato
            nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            esempio:
            2019-11-15 12:57:46 +00:00

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

            elementi dei risultati di ricerca trovati nella SERP

            • date
              Tipo: string | null

              data e ora in cui la pagina HTML è stata scansionata
              nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              esempio:
              2019-11-15 12:57:46 +00:00

            • html
              Tipo: string | null

              pagina HTML

            • page
              Tipo: integer | null

              numero di serie della pagina HTML restituita

          • items_count
            Tipo: integer | null Formato: int64

            il numero di risultati restituiti nell'array items

          • keyword
            Tipo: string | null

            keyword ricevuta in un array POST
            la keyword viene restituita decodificata (%##; il carattere '+' viene decodificato in uno spazio)

          • language_code
            Tipo: string | null

            codice lingua in un array POST

          • location_code
            Tipo: integer | null

            codice posizione in un array POST

          • se_domain
            Tipo: string | null

            dominio del motore di ricerca in un array POST

          • 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/serp/google/ai_mode/live/html
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/live/html \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

{
  "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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Live Google Ai Mode SERP HTML