Skip to main content

​
Welcome

Serengo is a location-based social discovery platform where users can share “finds” (posts) at specific locations, connect with friends, and discover new places through ratings and comments. The API provides endpoints for managing finds, locations, friendships, notifications, and more. Documentation is built using an OpenAPI specification.

Serengo API Endpoints

View the OpenAPI specification file

​
Key Concepts

  • Finds: User posts at locations, with media, ratings, likes, and comments
  • Locations: Geographic points with aggregated ratings and find counts
  • Privacy: Finds can be public, private, or friends-only
  • Ratings: 1-5 star ratings for finds and locations
  • Friends: Social connections for sharing private content

​
Authentication

All API endpoints require authentication using Bearer tokens. Include the token in the Authorization header: 
Authorization: Bearer <your_token>

​
Media Uploads

Endpoints for uploading media (images/videos) use multipart/form-data. Supported formats:
  • Images: JPEG, PNG, WebP (max 5MB)
  • Videos: MP4, MOV