APILab

Documentation

API V1

Overview

Endpoints

API V1: Overview

V1 Gateway

https://api.api-lab.xyz

Rate-Limiting

The POST API's are rate-limited to 10 requests per minute per IP address while the GET API's are rate-limited to 25 requests per minute per IP address. If you exceed these limits, you will receive a 429 Too Many Requests response and a temporary ban.

API V1: Endpoints

News & Weather

/news/current - GET

Returns top news stories from around the world.

/news/historical - GET

Returns cached top news stories from around the world by search.

Parameters:

type - string (headline|content|source|date)
query - string

/weather/current - GET

Returns current weather data for a given location query.

Parameters:

location - string
system - string (imperial|metric) (optional, defaults to imperial)

/weather/forecast - GET

Returns weather forecast data for a given location query.

Parameters:

location - string
system - string (imperial|metric) (optional, defaults to imperial)

AI-Assisted Tools

/ai/ocr - POST - image bytes

Returns text from an image.

Parameters (URL):

lang_in - string (Language Codes - In) (optional, required for that recognizing characters that are not English, French, Italian, German, Spanish, Brazilian Portuguese, or Dutch)

lang_out - string (Language Codes - Out) (optional, triggers translator)

/ai/text2speech - POST - JSON

Returns a speech file from text.

Parameters:

text - string

/ai/sentiment - POST - JSON

Returns a sentiment analysis score from text.

Parameters:

text - string

Fun Tools

/fun/dankmeme - GET

Returns a random meme from r/dankmemes.

Image Tools

/image/grayscale - POST - image bytes

Returns a grayscale version of an image.

/image/wasted - POST - image bytes

Returns a version of an image overlayed with the death screen of the popular videogame Grand-Theft Auto.

/image/people_who_know - POST - image bytes

Returns an image formatted into the "People Who Know" meme.

/image/invert - POST - image bytes

Returns an inverted version of an image.

/image/laser_eyes - POST - image bytes

Returns an image with laser eyes. (Face detection required)

About APILab

APILab is a personal project of mine and is a work-in-progress. I provide free-to-use* API endpoints that developers can integrate into their own applications and bots without all the overhead. The service is currently in development and will constantly be updated with new features and improvements. Feel free to use APILab for your own projects, but please provide attribution to APILab and the specific API endpoint you are using.

For any questions, comments, or concerns, please contact me via email at [email protected].

If you would like to show your support for APILab with a donation, my CashApp is cash.app/$aerolabs.

A project by Chad Groom.

* - APILab is a free service, but I do ask that you provide attribution to APILab (api-lab.xyz) and the specific API endpoint you are using.
* - While APILab is currenlty free to use, some endpoints/rate-limits may require a paid subscription in the future.