IGUANA

API

Um novo jeito de obter notícias para análise

FGV|IBRE NMEC - Núcleo de Métodos  Estatísticos e Computacionais

Desenvolvedores

Pedro Grilherme 

Jonatha Azevedo

Henrique Almeida

Fernando Ormonde

[Autor/Criador]
[Autor/Colaborador]
[Autor/Colaborador]
[Autor/Coordenador]

Rodrigo Targino

[Colaborador]
[Colaborador]
[Colaborador]

Yuri Saporito

Angel Arroyo

SUMÁRIO

  • O QUE É?
  • JORNAIS DISPONÍVEIS
  • DOCUMENTAÇÃO
  • ESTRUTURA
  • ACESSO
  • PACOTES
  • FORMAS DE REQUISIÇÃO
  • CONSIDERAÇÕES FINAIS

O que é?

As APIs são um tipo de “ponte” que conectam aplicações podendo ser utilizadas para os mais variados tipos de negócio.

A Iguana é uma API que disponibiliza dados, mais precisamente, notícias capturadas online. De uma forma simples, segura, rápida e prática, a Iguana fornece acesso direto a notícias.

Jornais disponíveis

Jornais disponíveis

Documentação

A API tem uma documentação para auxiliar o usuário a extrair as notícias e o  como é possível customizar as requisições. Na documentação a detalhes sobre os tipos de requisição, cuidados a serem tomados e além de explicar o processo de obtenção do token de acesso.

Acesso

Por conter dados que não são de domínio público, a utilização da iguana precisa ser controlada e distribuída internamente na FGV. Com isso, o acesso a API é dada através de um token!

Para ter acesso, basta inserir um email com o sufixo @fgv.br que você tenha acesso

  Pacotes

Cliente para o R que se conecta com a API 

Cliente para o Python que se conecta com a API 

https://github.com/nmecsys/iguanaR

https://github.com/nmecsys/pyguana

import pandas as pd
from pandas.io.json import json_normalize
import requests


token = 'token'
url = "http://iguana.incertezalab.com/api/jornais?token="


url_extract = url + token
req = requests.get(url_extract)
if(req.ok):
    data = req.json()
    result = json_normalize(data['data'])

Forma básica de usar a API via python

  Formas de requisição

Forma aleatória

Notícias por fonte

Notícias por descrição

Notícias por data

iguana.incertezalab.com/api/jornais?token=tokenfonte=@correio
iguana.incertezalab.com/api/jornais?token=token&descricao=Dilma
iguana.incertezalab.com/api/jornais?token=token&datainicio=2017-01-01&datafim=2017-06-01

iguana.incertezalab.com/api/jornais?token=token&datainicio=2017-01-01

iguana.incertezalab.com/api/jornais?token=token&datafim=2017-01-01
iguana.incertezalab.com/api/rand/jornais?token=token&descricao=Lula

  Pacote R

# Para instalar o pacote para o R

if(require(devtools)){
    install_github(nmecsys/)
}else{
    install.packages("devtools")
    devtools::install_github("nmecsys/")
}


require(iguanaR)


noticias_do_correio <- GetNews(token = token,fonte = "@correio")
#para ver a lista de fontes disponíveis, utilize a função iguanaSources()

Devido a questões de direitos autorais, não podemos publicar o pacote para o R no repositório oficial, CRAN. Porém é possível obter o pacote com o código abaixo:

iguanaR

  Pacote Python

Para obter o pacote para o Python, basta utilizar o código abaixo:

pyguana

#Para utilizar

import pyguana

requisicao = pyguana.Iguana(toke = 'token_valido')

noticias = requisicao.get(fonte = 'Estadao')
print(noticias)

# Para instalar o pacote para o python
# abra o console execute o comando:

pip install git+https://github.com/nmecsys/pyguana.git

  Considerações finais

A Api é um projeto relativamente novo, e sua estrutura está sendo constantemente melhorada. O feedback é importante para acelerar o processo de melhoria.

O site com mais informações e o guia de uso completo da Iguana se encontra em:

http://iguana.incertezalab.com

Obrigado!

Iguana

By John Azevedo

Made with Slides.com

Iguana

  • 251

More from John Azevedo