# Google Finance Explore Advanced en vivo

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/serp/google/finance_explore/live/advanced`

**Tags:** DataForSEO

Devuelve los instrumentos que Google Finance agrupa bajo un tema, de forma síncrona. Devuelve `keyword`, `type`, `se_domain`, `location_code`, `language_code`, `check_url`, `datetime`, `spell`, `refinement_chips`, `item_types`, `items_count` e `items`. `advanced` es la opción predeterminada; usa `regular` cuando solo importe la lista clasificada y `html` solo para comprobar qué descartó el analizador. Envuelto en el sobre de DataForSEO: los datos en `tasks[0].result`, el resultado en `tasks[0].status_code`; una solicitud rechazada sigue devolviendo HTTP 200.

### Referencia de precios

- Medición: Costo de respuesta reportado.
- Estimación de referencia por solicitud: USD 0.02.
- Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "location_code": {
            "type": "integer",
            "description": "<p><em>código de ubicación del motor de búsqueda</em><p><strong>campo obligatorio si no especificas <code>location_name</code></strong><p><strong>si usas este campo, no necesitas especificar <code>location_name</code></strong><p>puedes obtener la lista de ubicaciones disponibles de los motores de búsqueda con su <code>location_code</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/serp/google/locations</code><p>ejemplo:<p><code class=\"long-string\">2840</code></p>"
          },
          "language_code": {
            "type": "string",
            "description": "<p><em>código de idioma del motor de búsqueda</em><p><strong>campo obligatorio si no especificas <code>language_name</code></strong><p><strong>si usas este campo, no necesitas especificar <code>language_name</code></strong><p>puedes obtener la lista de idiomas disponibles del motor de búsqueda con su <code>language_code</code>&nbsp;haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/serp/google/languages</code><em><p></em>ejemplo:<em><p></em><code class=\"long-string\">en</code></p>"
          },
          "device": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>tipo de dispositivo</em><p>campo opcional<p>devuelve resultados para un tipo específico de dispositivo<p>valor posible: <code>desktop</code></p>"
          },
          "location_name": {
            "type": "string",
            "description": "<p><em>nombre completo de la ubicación del motor de búsqueda</em><p><strong>campo obligatorio si no especificas <code>location_code</code></strong><p><strong>si usas este campo, no necesitas especificar <code>location_code</code></strong><p>puedes obtener la lista de ubicaciones disponibles del motor de búsqueda con su <code>location_name</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/serp/google/locations</code><p>ejemplo:<p><code class=\"long-string\">London,England,United Kingdom</code></p>"
          },
          "language_name": {
            "type": "string",
            "description": "<p><em>nombre completo del idioma del motor de búsqueda</em><p><strong>campo obligatorio si no especificas <code>language_code</code></strong><p><strong>si usas este campo, no necesitas especificar <code>language_code</code></strong><p>puedes obtener la lista de idiomas disponibles del motor de búsqueda con su <code>language_name</code> haciendo una solicitud independiente a <code>https://api.dataforseo.com/v3/serp/google/languages</code><p>ejemplo:<p><code class=\"long-string\">English</code></p>"
          },
          "os": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>sistema operativo del dispositivo</em><p>campo opcional<p>valores posibles: <code>windows</code></p>"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>identificador de tarea definido por el usuario</em><p>campo opcional<p><em>el límite de caracteres es 255</em><p>puedes usar este parámetro para identificar la tarea y emparejarla con el resultado<p>encontrarás el valor <code>tag</code> especificado en el objeto <code>data</code> de la respuesta</p>"
          },
          "news_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "<p><em>filtros de noticias financieras</em><p>campo opcional<p>valores posibles: <code>top_stories</code>, <code>local_market</code>, <code>world_markets</code><p>valor predeterminado: <code>top_stories</code><p><strong>Nota:</strong> si especificas <code>local_market</code> o <code>world_markets</code>, la tarifa por tarea se multiplicará por 2</p>"
          }
        },
        "example": [
          {
            "location_code": 2840,
            "language_name": "English"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "location_code": 2840,
      "language_name": "English"
    }
  ]
}
```

## Responses

### 200 — Operación correcta

Headers:
- `X-Request-Id` (string) — Identificador de la solicitud que se debe incluir al contactar con el soporte de Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceExploreLiveAdvancedResponseInfo"
    }
  ]
}
```

### 400 — No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.

### 401 — Se requiere una clave de API de Felo válida.

### 402 — La solicitud no puede continuar porque no se cumple un requisito de facturación.

### 403 — La cuenta no tiene permiso para realizar esta operación.

### 429 — Se ha alcanzado un límite de solicitudes o de gasto.

### 502 — El servicio no pudo completar la solicitud.

### 503 — La API o el servicio de facturación no están disponibles temporalmente.

### 504 — El servicio agotó el tiempo de espera al procesar la solicitud.

### default — Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AmazonLabelElement

`#/components/schemas/Response36Afe1097B20_AmazonLabelElement`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "título del elemento"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL de búsqueda con parámetros de refinamiento"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "dominio en la SERP"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "la versión actual de la API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado general\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo general\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo total de ejecución, en segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "el número de tareas en el array de tareas devueltas con un error",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "identificador de la tarea\nidentificador único de la tarea en nuestro sistema en formato UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "código de estado de la tarea\ngenerado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000\npuedes encontrar la lista completa de los códigos de respuesta aquí"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "mensaje informativo de la tarea\npuedes encontrar la lista completa de los mensajes informativos generales aquí"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "tiempo de ejecución, segundos"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "costo total de las tareas, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "número de elementos en el array de resultados",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "ruta de la URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "contiene los mismos parámetros que especificaste en la solicitud POST"
    }
  }
}
```

### Response36Afe1097B20_BaseSerpApiGoogleFinanceElementItem

`#/components/schemas/Response36Afe1097B20_BaseSerpApiGoogleFinanceElementItem`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    }
  },
  "additionalProperties": false,
  "discriminator": {
    "propertyName": "type",
    "mapping": {
      "google_finance_asset_pair_element": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceAssetPairElementElementItem",
      "google_finance_market_index_element": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceMarketIndexElementElementItem",
      "google_finance_market_instrument_element": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceMarketInstrumentElementElementItem",
      "google_finance_hero_groups": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceHeroGroupsElementItem",
      "google_finance_interested": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceInterestedElementItem",
      "google_finance_news": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceNewsElementItem",
      "google_finance_earnings_calendar": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceEarningsCalendarElementItem",
      "google_finance_most_followed": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceMostFollowedElementItem",
      "google_finance_market_trends": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceMarketTrendsElementItem",
      "google_finance_people_also_search": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinancePeopleAlsoSearchElementItem",
      "google_finance_explore_market_trends": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceExploreMarketTrendsElementItem",
      "google_finance_quote": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceQuoteElementItem",
      "google_finance_compare_to": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceCompareToElementItem",
      "google_finance_financial": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceFinancialElementItem",
      "google_finance_futures_chain": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceFuturesChainElementItem",
      "google_finance_details": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceDetailsElementItem",
      "google_finance_about": "#/components/schemas/Response36Afe1097B20_SerpApiGoogleFinanceAboutElementItem"
    }
  }
}
```

### Response36Afe1097B20_RefinementChipsElement

`#/components/schemas/Response36Afe1097B20_RefinementChipsElement`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "title": {
      "type": [
        "string",
        "null"
      ],
      "description": "título del elemento"
    },
    "url": {
      "type": [
        "string",
        "null"
      ],
      "description": "URL de búsqueda con parámetros de refinamiento"
    },
    "domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "dominio en la SERP"
    },
    "options": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_AmazonLabelElement"
          }
        ]
      },
      "description": "más opciones de refinamiento de búsqueda"
    }
  }
}
```

### Response36Afe1097B20_RefinementChipsInfo

`#/components/schemas/Response36Afe1097B20_RefinementChipsInfo`

```json
{
  "type": "object",
  "properties": {
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "xpath": {
      "type": [
        "string",
        "null"
      ],
      "description": "el XPath del elemento"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsElement"
          }
        ]
      },
      "description": "items del elemento"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleFinanceExploreLiveAdvancedResponseInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceExploreLiveAdvancedResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceExploreLiveAdvancedTaskInfo"
              }
            ]
          },
          "description": "<em>array de tareas</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SerpGoogleFinanceExploreLiveAdvancedResultInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceExploreLiveAdvancedResultInfo`

```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>palabra clave recibida en un array POST</em><br><strong>la palabra clave se devuelve con %## decodificado (el carácter '+' se decodificará como un espacio)</strong>"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de elemento"
    },
    "se_domain": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>dominio del motor de búsqueda en un array POST</em>"
    },
    "location_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>código de ubicación en un array POST</em>"
    },
    "language_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>código de idioma en un array POST</em>"
    },
    "check_url": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>URL directa a los resultados del motor de búsqueda</em><br>puedes usarla para asegurarte de que proporcionamos resultados precisos"
    },
    "datetime": {
      "type": [
        "string",
        "null"
      ],
      "description": "<em>fecha y hora en que se recibió el resultado</em><br>en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”<br>ejemplo:<br><code class=\"long-string\">2019-11-15 12:57:46 +00:00</code>"
    },
    "spell": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_SpellInfo"
        }
      ],
      "description": "<em>autocorrección del motor de búsqueda</em><br>si el motor de búsqueda proporcionó resultados para una palabra clave corregida, indicaremos la palabra clave corregida por el motor de búsqueda y el tipo de autocorrección"
    },
    "refinement_chips": {
      "type": [
        "object",
        "null"
      ],
      "oneOf": [
        {
          "$ref": "#/components/schemas/Response36Afe1097B20_RefinementChipsInfo"
        }
      ],
      "description": "<em>chips de refinamiento de búsqueda</em><br>en este caso, el valor será <code>null</code>"
    },
    "item_types": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "<em>tipos de resultados de búsqueda en el SERP</em><br>contiene los tipos de resultados de búsqueda (<code>items</code>) encontrados en el SERP;<br>tipos de elementos posibles: google_finance_hero_groups, google_finance_interested, google_finance_news, google_finance_earnings_calendar, google_finance_most_followed, google_finance_market_trends, google_finance_people_also_search"
    },
    "se_results_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>número total de resultados en el SERP</em>",
      "format": "int64"
    },
    "items_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "<em>el número de resultados devueltos en el array <strong><code>items</code></strong></em>",
      "format": "int64"
    },
    "items": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "object",
          "null"
        ],
        "oneOf": [
          {
            "$ref": "#/components/schemas/Response36Afe1097B20_BaseSerpApiGoogleFinanceElementItem"
          }
        ]
      },
      "description": "<em>elementos de resultados de búsqueda encontrados en el SERP</em>"
    }
  }
}
```

### Response36Afe1097B20_SerpGoogleFinanceExploreLiveAdvancedTaskInfo

`#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceExploreLiveAdvancedTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_SerpGoogleFinanceExploreLiveAdvancedResultInfo"
              }
            ]
          },
          "description": "<em>array de resultados</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_SpellInfo

`#/components/schemas/Response36Afe1097B20_SpellInfo`

```json
{
  "properties": {
    "keyword": {
      "type": [
        "string",
        "null"
      ],
      "description": "palabra clave obtenida como resultado de la autocorrección del motor de búsqueda\n los resultados se proporcionarán para la palabra clave corregida"
    },
    "type": {
      "type": [
        "string",
        "null"
      ],
      "description": "tipo de autocorrección\n valores posibles:\n did_you_mean, showing_results_for, no_results_found_for, including_results_for\n nota: Yahoo y Yandex solo admiten el siguiente tipo de autocorrección:\n including_results_for"
    }
  }
}
```
