v0.2.0-beta

OpenAPI 3.1.0

Live: Google Finance Quote 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

post/v1/beta/dataforseo/serp/google/finance_quote/live/html

Live: Google Finance Quote SERP HTML

Restituisce in modo sincrono la quotazione di un ticker come la mostra Google Finance. HTML grezzo della pagina invece dei 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 riportato.
Stima di riferimento per richiesta: USD 0.02.
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)[]
- device
  Tipo: string | null
  
  tipo di dispositivo
  
  campo facoltativo
  
  restituisce risultati per un tipo di dispositivo specifico
  
  valore possibile: desktop
- keyword
  Tipo: string
  
  ticker o simbolo azionario
  
  campo obbligatorio
  
  in questo campo puoi inserire il simbolo ticker delle azioni quotate pubblicamente di un determinato titolo o strumento su una determinata borsa;
  
  puoi specificare fino a 700 caratteri nel campo keyword;
  
  tutti i %## vengono decodificati (inoltre il carattere ‘+’ viene decodificato in uno spazio)
  
  se devi usare il carattere “%” per la tua keyword, specificalo come “%25”;
  
  se devi usare il carattere “+” per la tua keyword, specificalo come “%2B”;
  
  scopri di più su regole e limiti dei campi keyword e keywords nelle API DataForSEO in questo articolo del Help Center
- language_code
  Tipo: string
  
  codice lingua del motore di ricerca
  
  campo obbligatorio se non specifichi language_name
  
  se usi questo campo, non devi specificare language_name
  
  puoi 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/languages
  
  esempio:
  
  en
- language_name
  Tipo: string
  
  nome completo della lingua del motore di ricerca
  
  campo obbligatorio se non specifichi language_code
  
  se usi questo campo, non devi specificare language_code
  
  puoi 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/languages
  
  esempio:
  
  English
- location_code
  Tipo: integer
  
  codice località del motore di ricerca
  
  campo obbligatorio se non specifichi location_name
  
  se usi questo campo, non devi specificare location_name
  
  puoi ricevere l'elenco delle località disponibili dei motori di ricerca con il relativo location_code effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/google/locations
  
  esempio:
  
  2840
- location_name
  Tipo: string
  
  nome completo della località del motore di ricerca
  
  campo obbligatorio se non specifichi location_code
  
  se usi questo campo, non devi specificare location_code
  
  puoi ricevere l'elenco delle località disponibili del motore di ricerca con il relativo location_name effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/google/locations
  
  esempio:
  
  London,England,United Kingdom
- os
  Tipo: string | null
  
  sistema operativo del dispositivo
  
  campo facoltativo
  
  valori possibili: windows
- tag
  Tipo: string | null
  
  identificatore dell'attività definito dall'utente
  
  campo opzionale
  
  il limite è di 255 caratteri
  
  puoi usare questo parametro per identificare l'attività e associarla al risultato
  
  troverai il valore tag specificato nell'oggetto data della risposta
- window
  Tipo: string | null
  
  intervallo di tempo per il grafico di google_finance_quote
  
  campo facoltativo
  
  valori possibili: 1D, 5D, 1M, 6M, YTD, 1Y, 5Y, MAX
  
  valore predefinito: 1D

Risposte

200
Tipo: object | null · Response36Afe1097B20_SerpGoogleFinanceQuoteLiveHtmlResponseInfo
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_SerpGoogleFinanceQuoteLiveHtmlTaskInfo
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

post/v1/beta/dataforseo/serp/google/finance_quote/live/html

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/finance_quote/live/html \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "NASDAQ-100"
  }
]'

Mostra schema

{
  "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 Finance Quote SERP HTML

AutenticazioneRequired

DataForSEO

Live: Google Finance Quote SERP HTML

Riferimento prezzi