pyfipe 0.0.2

A python package to make requests to fipe api

pyfipe

Install

pip install pyfipe

How to use

import pandas as pd

from pyfipe.core import ConsultaFipe
from pyfipe.tabelas import consulta_tabela_referencia, consulta_tabela_marcas, consulta_tabela_modelos

fipe = ConsultaFipe(
    mes = 'agosto/2022',
    tipo_veiculo = 'carro',
    marca = 'VW - VolksWagen',
    modelo = 'T-Cross Sense 1.0 TSI Flex 5p Aut.',
    ano_modelo = 2021,
    combustivel = 'Gasolina'
)

fipe.preco()

<style scoped> .dataframe tbody tr th:only-of-type { vertical-align: middle; }

.dataframe tbody tr th {
    vertical-align: top;
}

.dataframe thead th {
    text-align: right;
}

</style>

	Valor	Marca	Modelo	AnoModelo	Combustivel	CodigoFipe	MesReferencia	Autenticacao	TipoVeiculo	SiglaCombustivel	DataConsulta
0	R$ 101.120,00	VW - VolksWagen	T-Cross Sense 1.0 TSI Flex 5p Aut.	2021	Gasolina	005520-4	agosto de 2022	f4wq6m4pj4djf	1	G	quarta-feira, 24 de agosto de 2022 12:04

meses = ['janeiro/2022', 'fevereiro/2022', 'março/2022', 'abril/2022', 'maio/2022', 'junho/2022', 'julho/2022', 'agosto/2022']

df = pd.DataFrame()
for mes in meses:
    fipe.mes = mes
    fipe.update_codigo_tabela_referencia()
    df = pd.concat([df, fipe.preco()])

df

<style scoped> .dataframe tbody tr th:only-of-type { vertical-align: middle; }

.dataframe tbody tr th {
    vertical-align: top;
}

.dataframe thead th {
    text-align: right;
}

</style>

	Valor	Marca	Modelo	AnoModelo	Combustivel	CodigoFipe	MesReferencia	Autenticacao	TipoVeiculo	SiglaCombustivel	DataConsulta
0	R$ 94.854,00	VW - VolksWagen	T-Cross Sense 1.0 TSI Flex 5p Aut.	2021	Gasolina	005520-4	janeiro de 2022	cg6gzjs2n29fx	1	G	quarta-feira, 24 de agosto de 2022 12:04
0	R$ 97.518,00	VW - VolksWagen	T-Cross Sense 1.0 TSI Flex 5p Aut.	2021	Gasolina	005520-4	fevereiro de 2022	ch6p797h88mfx	1	G	quarta-feira, 24 de agosto de 2022 12:04
0	R$ 101.478,00	VW - VolksWagen	T-Cross Sense 1.0 TSI Flex 5p Aut.	2021	Gasolina	005520-4	março de 2022	f49rk6kznldjf	1	G	quarta-feira, 24 de agosto de 2022 12:04
0	R$ 102.808,00	VW - VolksWagen	T-Cross Sense 1.0 TSI Flex 5p Aut.	2021	Gasolina	005520-4	abril de 2022	f6v25c4673djf	1	G	quarta-feira, 24 de agosto de 2022 12:04
0	R$ 101.988,00	VW - VolksWagen	T-Cross Sense 1.0 TSI Flex 5p Aut.	2021	Gasolina	005520-4	maio de 2022	f5w868197ydjf	1	G	quarta-feira, 24 de agosto de 2022 12:04
0	R$ 101.854,00	VW - VolksWagen	T-Cross Sense 1.0 TSI Flex 5p Aut.	2021	Gasolina	005520-4	junho de 2022	f5rd7r84hvdjf	1	G	quarta-feira, 24 de agosto de 2022 12:04
0	R$ 102.021,00	VW - VolksWagen	T-Cross Sense 1.0 TSI Flex 5p Aut.	2021	Gasolina	005520-4	julho de 2022	f5yhd01kc3djf	1	G	quarta-feira, 24 de agosto de 2022 12:04
0	R$ 101.120,00	VW - VolksWagen	T-Cross Sense 1.0 TSI Flex 5p Aut.	2021	Gasolina	005520-4	agosto de 2022	f4wq6m4pj4djf	1	G	quarta-feira, 24 de agosto de 2022 12:04

Caso queira consultar apenas a tabela de referência da fipe:

consulta_tabela_referencia()

<style scoped> .dataframe tbody tr th:only-of-type { vertical-align: middle; }

.dataframe tbody tr th {
    vertical-align: top;
}

.dataframe thead th {
    text-align: right;
}

</style>

	codigo_mes	mes
0	288	agosto/2022
1	287	julho/2022
2	286	junho/2022
3	285	maio/2022
4	284	abril/2022
...	...	...
255	69	maio/2001
256	68	abril/2001
257	67	março/2001
258	63	fevereiro/2001
259	62	janeiro/2001

260 rows × 2 columns

Caso não saiba qual o código da marca do seu carro, poderá fazer uma busca na tabela de marcas:

tabela_marcas = consulta_tabela_marcas(mes='agosto/2022', tipo_veiculo='carro')
tabela_marcas

<style scoped> .dataframe tbody tr th:only-of-type { vertical-align: middle; }

.dataframe tbody tr th {
    vertical-align: top;
}

.dataframe thead th {
    text-align: right;
}

</style>

	marca	codigo_marca	mes
0	Acura	1	agosto/2022
1	Agrale	2	agosto/2022
2	Alfa Romeo	3	agosto/2022
3	AM Gen	4	agosto/2022
4	Asia Motors	5	agosto/2022
...	...	...	...
87	Troller	57	agosto/2022
88	Volvo	58	agosto/2022
89	VW - VolksWagen	59	agosto/2022
90	Wake	163	agosto/2022
91	Walk	120	agosto/2022

92 rows × 3 columns

tabela_marcas[fipe.tabela_marcas['marca'].str.contains('vw', case=False)]

<style scoped> .dataframe tbody tr th:only-of-type { vertical-align: middle; }

.dataframe tbody tr th {
    vertical-align: top;
}

.dataframe thead th {
    text-align: right;
}

</style>

	marca	codigo_marca	mes
89	VW - VolksWagen	59	agosto/2022

Caso não saiba qual o código e descrição do seu modelo, pode consultar na tabela de modelos

tabela_modelos = consulta_tabela_modelos(mes='agosto/2022', tipo_veiculo='carro', codigo_marca=59)
tabela_modelos

<style scoped> .dataframe tbody tr th:only-of-type { vertical-align: middle; }

.dataframe tbody tr th {
    vertical-align: top;
}

.dataframe thead th {
    text-align: right;
}

</style>

	modelo	codigo_modelo
0	AMAROK CD2.0 16V/S CD2.0 16V TDI 4x2 Die	5585
1	AMAROK CD2.0 16V/S CD2.0 16V TDI 4x4 Die	5586
2	AMAROK Comfor. 3.0 V6 TDI 4x4 Dies. Aut.	9895
3	AMAROK Comfor. CD 2.0 TDI 4x4 Dies. Aut.	8531
4	AMAROK CS2.0 16V/S2.0 16V TDI 4x2 Diesel	5748
...	...	...
516	VOYAGE SELEÇÃO 1.6 I MOTION T.Flex 8V 4p	6672
517	VOYAGE SELEÇÃO 1.6 Total Flex 8V 4p	6673
518	VOYAGE TREND 1.6 Mi Total Flex 8V 4p	4755
519	VOYAGE Trendline 1.0 T.Flex 12V 4p	7524
520	VOYAGE Trendline 1.6 T.Flex 8V 4p	6809

521 rows × 2 columns

tabela_modelos[tabela_modelos['modelo'].str.contains('t-cross', case=False)]

<style scoped> .dataframe tbody tr th:only-of-type { vertical-align: middle; }

.dataframe tbody tr th {
    vertical-align: top;
}

.dataframe thead th {
    text-align: right;
}

</style>

	modelo	codigo_modelo
450	T-Cross 1.0 TSI Flex 12V 5p Aut.	8641
451	T-Cross 1.0 TSI Flex 12V 5p Mec.	8642
452	T-Cross Comfortline 1.0 TSI Flex 5p Aut.	8643
453	T-Cross Highline 1.4 TSI Flex 16V 5p Aut	8644
454	T-Cross Sense 1.0 TSI Flex 5p Aut.	9564