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.


GET/bloquinhos2025/agenda

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

GET
/bloquinhos2025/agenda
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

GET
/bloquinhos2025/agenda?city=Rio%20de%20Janeiro
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

GET
/bloquinhos2025/agenda?date=2025-03-01
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

GET
/bloquinhos2025/agenda?sort=asc
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

GET
/bloquinhos2025/agenda com múltiplos filtros
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.