# Histórico

> Acesse dados passados de previsão do tempo, essenciais para análises de tendências e comparações de desempenho ao longo do tempo.

Você pode obter dados históricos de previsão do tempo utilizando parâmetros que filtram por data.

<tip>

Esse método necessita de um plano que tenha suporte à dados históricos.

</tip>

## Requisição

As requisições tem como base o seguinte endpoint:

<endpoint endpoint="/weather/historical">



</endpoint>

Você pode obter dados históricos de previsão do tempo para uma localizadade através de um dos seguintes métodos:

- [Obter pelo nome da cidade](/docs/weather/finding#obter-pelo-nome-da-cidade);
- [Obter pelo código WOEID da cidade](/docs/weather/finding#obter-pelo-c%C3%B3digo-woeid-da-cidade);
- [Obter por coordenadas de latitude e longitude](/docs/weather/finding#obter-por-coordenadas-de-latitude-e-longitude);
- [Obter por geolocalização IP](/docs/weather/finding#obter-por-geolocaliza%C3%A7%C3%A3o-ip).

Para definir o intervalo de dados a serem consultados, você pode utilizar um dos seguintes métodos:

### Por intervalo de datas

<field-group>
<field name="start_date" type="string">

Data de inicio no formato `yyyy-mm-dd`.

</field>

<field name="end_date" type="string">

Data de término no formato `yyyy-mm-dd`.

</field>
</field-group>

### Por uma data específica

<field-group>
<field name="date" type="string">

Data no formato `yyyy-mm-dd`.

</field>
</field-group>

### Por número de dias atrás

<field-group>
<field name="days_ago" type="number">

Número de dias atrás.

</field>
</field-group>

### Modos

Juntamente com uma das datas, é possível definir o modo de retorno dos dados:

<field-group>
<field name="mode" type="string">

As opções são `all`, `hourly` (apenas os registros por hora) ou `summary` (apenas o resumo).

</field>
</field-group>

### Exemplo

Logo, você provavelmente irá utilizar um endpoint como o seguinte:

<endpoint endpoint="/weather/historical?woeid=455903&days_ago=3&mode=all">



</endpoint>

<request-example endpoint="/weather/historical?woeid=455903&days_ago=3&mode=all">



</request-example>

## Resposta

<response-json endpoint="/weather/historical?woeid=455903&days_ago=3&mode=all">



</response-json>