Random API

Introduction

Random API is a free and open API designed to make your development easier. It offers a collection of simple, useful endpoints that you can integrate into your projects without hassle. Whether you're building a bot, a web app, or a hobby project, you'll find ready-to-use data and tools gathered in one place.

Default path: https://random.ozelot.fyi/api/

Rate limits

To ensure fair use and maintain service stability, each endpoint is limited to 15 requests per minute. This means you can make up to 15 queries per minute per individual endpoint.

If you require a higher limit, please contact us to request an API key. The API key can be provided either via the key query parameter or in the Authorization header as Bearer YOUR_API_KEY.

Deprecated

Some endpoints are marked as deprecated, meaning they are outdated and may be removed or stop working without notice. These endpoints are provided only for backward compatibility and should not be used in production environments. Please update your projects to use newer alternatives whenever possible.

Libraries

    Coming soon...

Weather forecast

GET /api/weather

Returns 5 day / 3 hour weather forecast for specified place. Provides detailed information about temperature, pressure, humidity, cloudiness, rain, snow, wind.

  • Queries:
  • place - city name (e.g. London, Madrid), use this or lat and lon
  • lat and lon - latitude and longitude, use this or place
  • lang - language (default is en), optional
  • units - use metric for Celsius and meter/sec or imperial for Fahrenheit and miles/hour (default is metric), optional
  • group - use true to group items by days or false to not group (default is false), optional
  • Examples:
  • https://random.ozelot.fyi/api/weather/?place=London
  • https://random.ozelot.fyi/api/weather/?lat=40&lon=-4&units=imperial
  • https://random.ozelot.fyi/api/weather/?place=Frankfurt&lang=de&group=true

Moon phase

GET /api/moon

Returns current or specified date information about the Moon, including its phase, phase icon URL, age (in days), distance from Earth (in kilometers), ecliptic coordinates (latitude and longitude), trajectory (ascendent or descendent), and the constellation the Moon is currently in.

  • Queries:
  • timestamp - unix timestamp for specified date, optional
  • Examples:
  • https://random.ozelot.fyi/api/moon
  • https://random.ozelot.fyi/api/moon?timestamp=1051653600

News feed

GET /api/news

Returns news articles from Google News, including titles, links, publication dates, and source information.

  • Queries:
  • lang - language code, e.g. en, es, de etc (default is en), optional
  • country - country code, e.g. us, gb, br etc (default is us), optional
  • topic - article topic - ALL, WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH (default is ALL), optional
  • q - query for search in articles, optional
  • Examples:
  • https://random.ozelot.fyi/api/news
  • https://random.ozelot.fyi/api/news?lang=pt&country=br
  • https://random.ozelot.fyi/api/news?topic=TECHNOLOGY&q=nvidia

RSS feed parser

GET /api/feed

Returns articles from given RSS feed channel.

  • Queries:
  • url - full url for RSS feed (xml)
  • Examples:
  • https://random.ozelot.fyi/api/feed?url=https://ozelot.fyi/rss.xml
  • https://random.ozelot.fyi/api/feed?url=http://rss.cnn.com/rss/cnn_latest.rss

Memes generator

GET /api/canvas/meme/:template

Generates a meme image based on the provided template and text.

  • Parameters:
  • template - meme template (see list below)
  • Template list with queries:
  • stonks - queries: img
  • not-stonks - queries: img
  • drake - queries: line1, line2
  • brain - queries: line1, line2, line3
  • gru - queries: line1, line2, line3
  • always-has-been - queries: line1, line2
  • balloon - queries: person1, person2, balloon
  • bell-curve - queries: line1, line2
  • boyfriend-looking-back - queries: man, woman, anotherwoman
  • couple-in-bed - queries: woman, man2
  • disappointed-guy - queries: line1, line2
  • drift - queries: line1, line2, line3
  • grim-reaper - queries: door1, door2, door3, door4, reaper
  • then-vs-now - queries: title1, title2, desc1, desc2
  • disaster-girl - queries: line1, line2
  • epic-handshake - queries: arm1, arm2, handshake
  • mother-ignoring-kid - queries: kid1, kid2, mother, skeleton
  • trade-offer - queries: line1, line2, line3
  • train-hitting-bus - queries: bus, train
  • tuxedo-winnie-the-pooh - queries: line1, line2
  • two-paths - queries: path1, path2, boy
  • Examples:
  • https://random.ozelot.fyi/api/canvas/meme/brain?line1=use meme generator for making memes&line2=use paint for making memes&line3=use canvas for making memes
  • https://random.ozelot.fyi/api/canvas/meme/always-has-been?line1=Klonba is a good bot&line2=always has been
  • https://random.ozelot.fyi/api/canvas/meme/boyfriend-looking-back?man=average discord server admin&woman=mee6 and other bots with paid options&anotherwoman=klonba
  • https://random.ozelot.fyi/api/canvas/meme/drift?line1=some large and popular bots&line2=Klonba discord bot&line3=me

Profile image

GET /api/canvas/profile-image

Generates a dynamic profile image (e.g. for welcome messages) based on provided parameters such as background URL, avatar URL, username, top text, bottom text, text color, and username color — ideal for Discord bots.

  • Queries:
  • username - user name
  • toptext - top text (max 30 characters), optional
  • bottomtext - bottom text, optional
  • usernamecolor - username text color (HEX without "#" or color name, example: 00FF00, red), optional
  • textcolor - top and bottom text color (HEX without "#" or color name, example: 00FF00, red), optional
  • avatar - user avatar image url, optional
  • background - custom background image url, optional
  • Examples:
  • https://random.ozelot.fyi/api/canvas/profile-image?username=Clyde
  • https://random.ozelot.fyi/api/canvas/profile-image?toptext=Welcome to our city!&username=Ozelot&bottomtext=You are member 20&usernamecolor=C43AFA&textcolor=DBDBDB&avatar=https://avatars.githubusercontent.com/u/29740364&background=https://i.imgur.com/l19yvN4.jpeg

Random nickname

GET /api/nickname

Generates and returns a random nickname consisting of uppercase letters (A–Z), lowercase letters (a–z), digits (0–9), and underscores (_).

The nickname is constructed by combining a random adjective, a random noun, and an optional suffix.

  • Queries:
  • count - nickname count (1-50), optional
  • Examples:
  • https://random.ozelot.fyi/api/nickname
  • https://random.ozelot.fyi/api/nickname?count=8