Hello world !

This is Bonjourr API system. More information in the source code.

Unsplash

This is a proxy of the unsplash endpoints. Read their documentation to learn more: unsplash.com/documentation. When cloning this API, add your key with "UNSPLASH" as an environnement variable.

Endpoint

GET /unsplash/[unsplash-endpoints]

Example

Weather

This is a mostly a proxy of openweathermap that combines their current & forecast endpoints to return data in a One Call format. Use their documentation here: openweathermap.org/one-call-3. You can also specify a city using the 'q=' parameter. Approximate IP location is used when no locations are specified. It also returns the city and country code in this case. When cloning this API, add your key with "WEATHER" as an environnement variable.

Endpoints

GET /weather?[openweathermap-parameters]
GET /weather/current?[openweathermap-parameters]
GET /weather/forecast?[openweathermap-parameters]

Examples

Fonts

Returns the list of available fonts in Fontsource, more info on their docs: fontsource.org/docs/api/fonts. Fonts are sorted by popularity as seen on fonts.google.com and filtered to only allow text fonts, no icons. Also added a more aggressive cache policy than their endpoint.

Endpoint

GET /fonts

Example

Favicon

Fetches the URL of a website's favicon. Add the URL of the website you want (with the protocol!) to the API path.
Source code: favicon-fetcher

Endpoint

GET /favicon/:your-website

Example

Quotes

Serves quotes in different languages, but also inspirobot and kaamelott quotes. For classic quotes, if the language is not available, it defaults to english.
Source code: i18n-quotes

Endpoints

GET /quotes/classic/:lang
GET /quotes/inspirobot
GET /quotes/kaamelott

Examples

Suggestions

This is a scraping tool that returns search suggestions from different providers. It uses websockets, so no live examples.
Source code: search-suggestions

Endpoints

WS /suggestions
GET /suggestions?q=[query]&l=[lang]&with=[provider]

GET examples

WS code example

const socket = new WebSocket('wss://api.bonjourr.lol/suggestions')

socket.onmessage = function (event: MessageEvent) {
  console.log(JSON.parse(event.data))
}

socket.send(JSON.stringify({ q, with, lang }))