senator: Extract data of Brazilian senatorial polls.

In voltdatalab/pollingbr: Extract Data of Brazilian Electoral Pools

Description

senator() extracts data of Brazilian senatorial polls from the Poder 360's poll agreggator API (https://www.poder360.com.br/pesquisas-de-opiniao/api/). The function returns a data.frame where each observation corresponds to a candidate's estimate in a poll.

Usage

senator(year, state = "ALL", type = c(1, 2, 3))

Arguments

year	Election year (integer). The available years are 2006, 2010, 2014, 2018.
state	Initials in capital letters (character) of the state election polled. Default returns all senatorial polls for the corresponding election year.
type	Number (character) indicating if the user wants the spontaneous (1), estimulated (2), or rejection (3) estimations of polls. Default returns all poll results.

Value

data.frame with results from polls conducted for senatorial elections in Brazil, for the year specified, with the following variables:

• pesquisa_id: id number for each poll.

• ano: election year to which the poll corresponds to.

• unidades_federativas_id: id number for the federative unit where the poll was conducted.

• unidade_federativa_nome: the name of the federative unit where the poll was conducted (if the poll was conducted on national-level, this variable assumes the value of "BRASIL").

• cargos_id: id number for the position polled.

• cargo: name of the position polled.

• tipo_id: id number for type of poll.

• tipo: type of poll.

• turno: indicates if election polled was a 1st round or 2nd round one.

• data_pesquisa: poll date ("YYYY-MM-DD").

• instituto_id: id number for the institute which conducted the poll.

• instituto: name of the institute which conducted the poll.

• voto_tipo: indicates if the estimate relates to total votes ("Votos Totais") or valid votes ("Votos Válidos").

• cenario_id: id number for the candidates' scenario that was polled.

• cenario_descricao: description of the candidates' scenario that was polled.

• candidatos_id: candidate's id number.

• candidato_partido: candidate's name and party affiliation.

• candidato: candidate's name.

• ano_default: indicates the year-position that the candidate ran.

• condicao: indicate if it's a candidate (0) or a broad category (such as null and/or blank vote, would vote for all, etc.)

• percentual: vote estimate for the candidate in the poll, in percentage points.

• data_referencia: poll's reference date ("DD-DD.MM.YYYY")

• margem_mais: estimate of the poll's margin of error upper limit.

• margem_menos: estimate of the poll's margin of error lower limit.

• contratante: indicates who hired the poll.

• num_registro: poll's register number in the Brazilian Electoral Courts.

• orgao_registro: Brazilian Electoral Court where the poll was registered.

• qtd_entrevistas: number of interviews conducted in the poll (poll's sample size).

• partidos_id: candidate's party id number.

• partido: candidate's party abbreviated name.

• cidade: city where the poll was conducted.

Examples

# returns a data.frame with the results for all senatorial polls conducted
# in the 2018 elections
df <- senator(2018)

# returns a data.frame with results for all polls for the first round of 2014
# Pernambuco's senatorial elections with candidates' rejection estimates
df <- senator(2014, state = "PE", type = 3)

voltdatalab/pollingbr documentation built on April 1, 2021, 4:38 a.m.