courts.tjrj.client.TJRJScraper

courts.tjrj.client.TJRJScraper(sleep_time=1.0)

Scraper for the Court of Justice of Rio de Janeiro.

The TJRJ search form displays a reCAPTCHA widget, but the backend does not validate it — the entire flow works without solving anything.

Methods

Name	Description
cjsg	Busca jurisprudencia (acordaos + monocraticas) no TJRJ.
cjsg_download	Baixa as paginas de resultado da busca de jurisprudencia do TJRJ.
cjsg_parse	Transform raw TJRJ payloads into a DataFrame.
cpopg	Stub: first degree case search not implemented for TJRJ.
cposg	Stub: second degree case search not implemented for TJRJ.

cjsg

courts.tjrj.client.TJRJScraper.cjsg(pesquisa=None, paginas=None, **kwargs)

Busca jurisprudencia (acordaos + monocraticas) no TJRJ.

Submete o form ASPX em ConsultarJurisprudencia.aspx e segue a chamada XHR para ProcessarConsJurisES.aspx que entrega os documentos em JSON.

Parameters

Name	Type	Description	Default
pesquisa	str	Termo de busca livre.	None
paginas	int | list | range | None	Paginas 1-based; None baixa todas. Default None.	None
**kwargs		Filtros aceitos pelo schema :class:InputCJSGTJRJ (todos opcionais; None = sem filtro): * ano_inicio / ano_fim (str | int): Ano de julgamento. Granularidade anual e o unico filtro de data exposto pelo backend ASPX — use estes em vez de data_julgamento_*. Backend: cmbAnoInicio / cmbAnoFim. * competencia (str | int): "1" civel / "2" criminal / "3" ambos. Default "1". Backend: cmbCompetencia. * origem (str | int): "1" 2o grau (default). Backend: cmbOrigem. * tipo_acordao (bool): Inclui acordaos. Default True. Backend: chkAcordao. * tipo_monocratica (bool): Inclui decisoes monocraticas. Default True. Backend: chkDecMon. * magistrado_codigo (str): IDs internos do magistrado, separados por virgula. Backend: hfCodMags. * orgao_codigo (str): IDs internos do orgao julgador, separados por virgula. Backend: hfCodOrgs.	{}

Aliases deprecados (popados com DeprecationWarning antes do pydantic): * query / termo -> pesquisa

Raises

Name	Type	Description
	TypeError	Quando um kwarg desconhecido e passado, incluindo data_julgamento_inicio / data_julgamento_fim / data_publicacao_inicio / data_publicacao_fim — o backend ASPX do TJRJ nao expoe esses filtros; use ano_inicio / ano_fim (granularidade anual apenas).
	ValidationError	Quando um filtro tem formato invalido.

Returns

Name	Type	Description
	pd.DataFrame	pd.DataFrame: DataFrame com colunas processo, classe,
	pd.DataFrame	orgao_julgador, relator, data_julgamento,
	pd.DataFrame	data_publicacao, ementa, alem de cod_documento,
	pd.DataFrame	numero_antigo e tipo_documento.

Exemplo

import juscraper as jus tjrj = jus.scraper(“tjrj”) df = tjrj.cjsg(“dano moral”, ano_inicio=2024, ano_fim=2024, … paginas=range(1, 3))

See also

— schema pydantic e a fonte da verdade dos filtros aceitos.

cjsg_download

courts.tjrj.client.TJRJScraper.cjsg_download(
    pesquisa=None,
    paginas=None,
    ano_inicio=None,
    ano_fim=None,
    competencia='1',
    origem='1',
    tipo_acordao=True,
    tipo_monocratica=True,
    magistrado_codigo=None,
    orgao_codigo=None,
    **kwargs,
)

Baixa as paginas de resultado da busca de jurisprudencia do TJRJ.

Aceita os mesmos filtros de :meth:cjsg; veja la a lista completa. Retorna a lista bruta de payloads JSON, sem parser.

See also

— schema pydantic e a fonte da verdade dos filtros aceitos. — versao high-level que ja parseia para DataFrame.

cjsg_parse

courts.tjrj.client.TJRJScraper.cjsg_parse(raw_pages)

Transform raw TJRJ payloads into a DataFrame.

cpopg

courts.tjrj.client.TJRJScraper.cpopg(id_cnj)

Stub: first degree case search not implemented for TJRJ.

cposg

courts.tjrj.client.TJRJScraper.cposg(id_cnj)

Stub: second degree case search not implemented for TJRJ.