Hyper Chirp API

A Twitter-like API for Hyper Island students to build class projects with. Send chirps, like posts, and monitor status in real time.

Checking...

Quick Start

Fetch chirps

fetch('https://hyperchirp.vercel.app/api/chirps?limit=10')
  .then(res => res.json())
  .then(data => console.log(data));

Create a chirp

fetch('https://hyperchirp.vercel.app/api/chirps', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    author_name: 'Your Name',
    content: 'My first chirp! 🎉',
    tag: 'test',
    sentiment: 'Positive'
  })
}).then(res => res.json());

Like a chirp

fetch('https://hyperchirp.vercel.app/api/chirps/{id}/like', {
  method: 'POST'
}).then(res => res.json());

Endpoints

GET/api/chirps
Query params:
tag, limit (1-100), search
Body:
—
Response:
200: Array of chirps | 400: Error message
POST/api/chirps
Query params:
—
Body:
author_name, content, author_avatar?, tag?, sentiment?, is_anonymous?
Response:
201: Created chirp | 400: Validation error
POST/api/chirps/[id]/like
Query params:
—
Body:
—
Response:
200: Updated chirp | 404: Chirp not found
GET/api/health
Query params:
—
Body:
—
Response:
200: Status and latency

Example Responses

Success response (201 Created)

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-10-17T10:30:00Z",
  "author_name": "Anna Svensson",
  "author_avatar": "https://api.dicebear.com/7.x/avataaars/svg?seed=Anna",
  "content": "My first chirp! 🎉",
  "tag": "test",
  "likes": 0,
  "sentiment": "Positive",
  "is_anonymous": false
}

Error response (400 Bad Request)

{
  "error": "content can be at most 280 characters (you sent 312)",
  "field": "content"
}

Sentiment Values

  • Positive — Joy, enthusiasm
  • Negative — Frustration, dissatisfaction
  • Neutral — Factual, informative
  • Chaotic — Deadline panic, complete chaos

Build something cool with Hyper Chirp and share it with the class.

View source code