courts.tjpa.client.TJPAScraper

courts.tjpa.client.TJPAScraper()

Scraper for the Tribunal de Justica do Estado do Para.

Methods

Name	Description
cjsg	Fetches jurisprudence from TJPA in a simplified way (download + parse).
cjsg_download	Downloads raw results from the TJPA jurisprudence search (multiple pages).
cjsg_parse	Extracts relevant data from the raw results returned by TJPA.
cpopg	Stub: first instance case consultation not implemented for TJPA.
cposg	Stub: second instance case consultation not implemented for TJPA.

cjsg

courts.tjpa.client.TJPAScraper.cjsg(
    pesquisa=None,
    paginas=None,
    relator=None,
    orgao_julgador_colegiado=None,
    classe=None,
    assunto=None,
    origem=None,
    tipo=None,
    data_julgamento_inicio=None,
    data_julgamento_fim=None,
    data_publicacao_inicio=None,
    data_publicacao_fim=None,
    sort_by='datajulgamento',
    sort_order='desc',
    query_type='free',
    query_scope='ementa',
    **kwargs,
)

Fetches jurisprudence from TJPA in a simplified way (download + parse). Returns a ready-to-analyze DataFrame.

Parameters

Name	Type	Description	Default
pesquisa	Optional[str]	Search term.	None
paginas	int, list, range, or None	Pages to download (1-based).	None
relator	Optional[str]	Filter by relator name.	None
orgao_julgador_colegiado	Optional[str]	Filter by collegiate judging body.	None
classe	Optional[str]	Filter by procedural class.	None
assunto	Optional[str]	Filter by subject.	None
origem	Optional[list]	List of origins.	None
tipo	Optional[list]	List of decision types.	None
data_julgamento_inicio	Optional[str]	Start date for judgment filter (YYYY-MM-DD).	None
data_julgamento_fim	Optional[str]	End date for judgment filter (YYYY-MM-DD).	None
data_publicacao_inicio	Optional[str]	Start date for publication filter (YYYY-MM-DD).	None
data_publicacao_fim	Optional[str]	End date for publication filter (YYYY-MM-DD).	None
sort_by	str	Sort field (default: “datajulgamento”).	'datajulgamento'
sort_order	str	Sort order (default: “desc”).	'desc'
query_type	str	Query type (default: “free”).	'free'
query_scope	str	Query scope (default: “ementa”).	'ementa'

cjsg_download

courts.tjpa.client.TJPAScraper.cjsg_download(
    pesquisa=None,
    paginas=None,
    relator=None,
    orgao_julgador_colegiado=None,
    classe=None,
    assunto=None,
    origem=None,
    tipo=None,
    data_julgamento_inicio=None,
    data_julgamento_fim=None,
    data_publicacao_inicio=None,
    data_publicacao_fim=None,
    sort_by='datajulgamento',
    sort_order='desc',
    query_type='free',
    query_scope='ementa',
    **kwargs,
)

Downloads raw results from the TJPA jurisprudence search (multiple pages). Returns a list of raw JSON responses.

Parameters

Name	Type	Description	Default
pesquisa	Optional[str]	Search term. query and termo are accepted as deprecated aliases.	None
paginas	int, list, range, or None	Pages to download (1-based). int: paginas=3 downloads pages 1-3. range: range(1, 4) downloads pages 1-3. None: downloads all available pages.	None
relator	Optional[str]	Filter by relator name.	None
orgao_julgador_colegiado	Optional[str]	Filter by collegiate judging body.	None
classe	Optional[str]	Filter by procedural class.	None
assunto	Optional[str]	Filter by subject.	None
origem	Optional[list]	List of origins (default: [“tribunal de justica do estado do para”]).	None
tipo	Optional[list]	List of decision types (default: [“acordao”, “decisao monocratica”]).	None
data_julgamento_inicio	Optional[str]	Start date for judgment filter (YYYY-MM-DD).	None
data_julgamento_fim	Optional[str]	End date for judgment filter (YYYY-MM-DD).	None
data_publicacao_inicio	Optional[str]	Start date for publication filter (YYYY-MM-DD).	None
data_publicacao_fim	Optional[str]	End date for publication filter (YYYY-MM-DD).	None
sort_by	str	Sort field (default: “datajulgamento”).	'datajulgamento'
sort_order	str	Sort order, “asc” or “desc” (default: “desc”).	'desc'
query_type	str	Query type, “free” or “any” (default: “free”).	'free'
query_scope	str	Query scope, “ementa” or “inteiroteor” (default: “ementa”).	'ementa'

cjsg_parse

courts.tjpa.client.TJPAScraper.cjsg_parse(resultados_brutos)

Extracts relevant data from the raw results returned by TJPA. Returns a DataFrame with the decisions.

cpopg

courts.tjpa.client.TJPAScraper.cpopg(id_cnj)

Stub: first instance case consultation not implemented for TJPA.

cposg

courts.tjpa.client.TJPAScraper.cposg(id_cnj)

Stub: second instance case consultation not implemented for TJPA.