Bloquinhos de Carnaval 2025 API
A API de Bloquinhos de Carnaval 2025 do Codante.io é uma API que fornece informações sobre os blocos de carnaval nas principais cidades brasileiras para o Carnaval de 2025. A API responde com um código de status 200 para solicitações bem-sucedidas, fornecendo recursos de blocos no formato JSON, cada um contendo informações detalhadas como ID do bloco, título, descrição, data e hora, endereço, cidade, bairro, preço e URL do evento.
Para solicitações inválidas, a API retorna um código de status 422, garantindo um feedback claro sobre erros nos parâmetros fornecidos.
Vale lembrar que a base de dados é resetada a cada quatro horas - então os dados não serão persistentes por muito tempo.
Autenticação
A API de Bloquinhos de Carnaval 2025 do Codante.io não requer autenticação para acessar os dados.
Rate Limit
A API de Bloquinhos de Carnaval 2025 do Codante.io possui um limite de taxa de 100 solicitações por minuto. Se você exceder esse limite, receberá um código de status 429. O uso indiscriminado também poderá levar ao bloqueio do seu IP.
Base URL
A URL base para a API de Bloquinhos de Carnaval 2025 do Codante.io é https://apis.codante.io/api/bloquinhos2025
.
O model Bloquinho
O model Bloquinho
contém todas as informações sobre um bloco de carnaval.
Propriedades
- Name
id
- Type
- integer
- Description
Identificador único do bloco.
- Name
title
- Type
- string
- Description
Nome do bloco de carnaval.
- Name
description
- Type
- string
- Description
Descrição detalhada do bloco.
- Name
date_time
- Type
- timestamp
- Description
Data e hora do evento.
- Name
address
- Type
- string
- Description
Endereço principal do evento.
- Name
complete_address
- Type
- string
- Description
Endereço completo, incluindo bairro, cidade e estado.
- Name
city
- Type
- string
- Description
Cidade onde o bloco acontecerá.
- Name
neighborhood
- Type
- string
- Description
Bairro onde o bloco acontecerá.
- Name
price
- Type
- string
- Description
Preço do evento (ou "Grátis" se for gratuito).
- Name
event_url
- Type
- string
- Description
URL para mais informações ou compra de ingressos.
Listagem de Blocos
Este endpoint retorna uma lista paginada de todos os blocos de carnaval disponíveis. Por padrão, retorna 10 blocos por página. Você pode usar diversos parâmetros para filtrar os resultados.
Atributos opcionais
- Name
date
- Type
- date
- Description
Filtra os blocos por data específica.
- Name
search
- Type
- string
- Description
Filtra os blocos por um termo de busca textual (título, descrição).
- Name
city
- Type
- string
- Description
Filtra os blocos por cidade. Cidades disponíveis: São Paulo, Rio de Janeiro, Belo Horizonte, Salvador, Recife e Olinda, Brasília, Fortaleza, Porto Alegre.
- Name
sort
- Type
- string
- Description
Ordena os resultados. Valores aceitos: 'asc' (mais antigos primeiro) ou 'desc' (mais recentes primeiro).
- Name
page
- Type
- integer
- Description
Número da página desejada (padrão: 1).
Request
curl -G https://apis.codante.io/api/bloquinhos2025/agenda
Response
{
"data": [
{
"id": 1,
"title": "9º Ensaio da Bateria Emilias e Viscondes",
"description": "Juntos, vamos fazer do Carnaval 2025 uma festa inesquecível para a criançada! Com muita música, dança, fantasia e alegria, vamos celebrar a magia do Carnaval e criar memórias que vão durar para sempre!",
"date_time": "2025-02-28T18:00:00.000Z",
"address": "Rua General Jardim, 485",
"complete_address": "Rua General Jardim, 485, Vila Buarque - São Paulo - SP",
"city": "São Paulo",
"neighborhood": "Vila Buarque",
"price": "Grátis",
"event_url": "https://www.instagram.com/p/DFGibHlxQVr/?igsh=dzlpdHNvM29uNzNi"
},
{
"id": 2,
"title": "Banda do Trem Elétrico",
"description": "Desde 1984 O Bloco Banda do Trem Elétrico eletrifica as ruas de São Paulo com seu desfile carnavalesco. O Bloco arrasta foliões em um verdadeiro show de alegria O Bloco está previsto para desfilar em Consolação, dia 28/02/25 com início da concentração às 18:00 e dispersão às 23:00. O trajeto será: R. Augusta, R. Luiz Coelho, R. Martins Fontes, R. Cel. Xavier de Toledo, Praça Ramos de Azevedo.",
"date_time": "2025-02-28T21:00:00.000Z",
"address": "R. Augusta",
"complete_address": "R. Augusta, Consolação - São Paulo - SP",
"city": "São Paulo",
"neighborhood": "Consolação",
"price": "Grátis",
"event_url": ""
}
// ... mais blocos ...
],
"links": {
"first": "https://apis.codante.io/api/bloquinhos2025/agenda?page=1",
"last": "https://apis.codante.io/api/bloquinhos2025/agenda?page=210",
"prev": null,
"next": "https://apis.codante.io/api/bloquinhos2025/agenda?page=2"
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 210,
"links": [
{"url": null, "label": "« Anterior", "active": false},
{"url": "https://apis.codante.io/api/bloquinhos2025/agenda?page=1", "label": "1", "active": true},
{"url": "https://apis.codante.io/api/bloquinhos2025/agenda?page=2", "label": "2", "active": false},
// ... mais links de paginação ...
{"url": "https://apis.codante.io/api/bloquinhos2025/agenda?page=2", "label": "Próximo »", "active": false}
],
"path": "https://apis.codante.io/api/bloquinhos2025/agenda",
"per_page": 10,
"to": 10,
"total": 2097
}
}
Exemplos de Uso
Filtrando por Cidade
Você pode filtrar os blocos por cidade usando o parâmetro city
. As cidades disponíveis são:
- São Paulo
- Rio de Janeiro
- Belo Horizonte
- Salvador
- Recife e Olinda
- Brasília
- Fortaleza
- Porto Alegre
Request
curl -G https://apis.codante.io/api/bloquinhos2025/agenda?city=Rio%20de%20Janeiro
Filtrando por Data
Você pode filtrar os blocos por data específica usando o parâmetro date
no formato YYYY-MM-DD.
Request
curl -G https://apis.codante.io/api/bloquinhos2025/agenda?date=2025-03-01
Ordenando Resultados
Você pode ordenar os resultados usando o parâmetro sort
. Os valores aceitos são:
asc
: Ordena por data e hora (mais antigos primeiro)desc
: Ordena por data e hora (mais recentes primeiro)
Request
curl -G https://apis.codante.io/api/bloquinhos2025/agenda?sort=asc
Combinando Filtros
Você pode combinar múltiplos parâmetros para refinar sua busca.
Request
curl -G https://apis.codante.io/api/bloquinhos2025/agenda?city=Salvador&date=2025-03-02&sort=asc
Créditos e Fontes
Os dados fornecidos por esta API são baseados em informações coletadas do site Blocos de Rua, a maior plataforma de conteúdo sobre carnaval de rua do Brasil. O site original oferece informações detalhadas sobre blocos de carnaval em diversas cidades brasileiras, incluindo São Paulo, Rio de Janeiro, Belo Horizonte, Salvador, Florianópolis, Recife e Olinda, Brasília, Porto Alegre e Fortaleza.
Agradecemos à equipe do Blocos de Rua por disponibilizar essas informações que enriquecem a experiência dos foliões durante o Carnaval 2025.
Para acessar a fonte original dos dados e obter informações adicionais sobre os blocos de carnaval, visite blocosderua.com.