https://github.com/smoke3785/dictionary-proxy-server
This is a proxy server for the Free Dictionary API which allows one app to distribute requests - preventing the API from limited your requests. It comes pre-configured to deploy to Fly.io and shouldn't rack up any charges, even on the hobbyist-tier.
https://github.com/smoke3785/dictionary-proxy-server
api dictionary free freedictionary-api
Last synced: 12 months ago
JSON representation
This is a proxy server for the Free Dictionary API which allows one app to distribute requests - preventing the API from limited your requests. It comes pre-configured to deploy to Fly.io and shouldn't rack up any charges, even on the hobbyist-tier.
- Host: GitHub
- URL: https://github.com/smoke3785/dictionary-proxy-server
- Owner: Smoke3785
- Created: 2022-10-03T20:07:04.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-06-10T20:43:43.000Z (12 months ago)
- Last Synced: 2025-06-10T21:42:20.664Z (12 months ago)
- Topics: api, dictionary, free, freedictionary-api
- Language: JavaScript
- Homepage: https://owenrossikeen.com/docs/dictionary-proxy-server
- Size: 19.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Dictionary Proxy Server
This is a proxy server for the [Free Dictionary API](https://dictionaryapi.dev/) which allows one app to distribute requests - preventing the API from limiting your requests. It comes pre-configured to deploy to [Fly.io](https://fly.io/) and _shouldn't_ rack up any charges, even on the hobbyist-tier.
[GitHub](https://github.com/Smoke3785/dictionary-proxy-server) **|** [View on Website](https://owenrossikeen.com/docs/dictionary-proxy-server) **|** [Donate](https://owenrossikeen.com/donate)
## Deployment
To deploy the proxy server, install the **flyctl** command line tool:
```
iwr https://fly.io/install.ps1 -useb | iex
```
Create an account on their website (or run `flyctl auth signup`) , and then run:
```
flyctl auth login
```
Once you're authenticated, run:
```
flyctl launch
```
**Do not** set up an SQL database, and **do** deploy now. Alternatively, **do not** deploy now and later run:
```
flyctl deploy
```
Should be pretty straightforward.
## Usage
Usage is incredibly straightforward. The api endpoint simulates the [Free Dictionary API](https://dictionaryapi.dev/) endpoint, so all you have to do in your code is run something like:
```js
// Node.js
const axios = require('axios);
const APP_NAME = ``
const WORD = ``
axios.get(`https://${APP_NAME}.fly.dev/api/v2/entries/en/${WORD}`).then((response)=> {
console.log(response)
}).catch(e=> {
console.log(e)
})
```
I have found that three proxies @ 100 requests/second **total** is enough to prevent overload for quite a while, but with five proxies + local requests running @ 100 requests/second **total** I have never been rate limited.
I don't reccommend using this for long periods of time as that's fairly rude, but for an application like mine (where the data needs retrieved in bulk once) this can speed up the rate that you can ingest data dramatically.
---
Made by Owen Rossi-Keen
[GitHub](https://github.com/Smoke3785/) **|** [Website](https://owenrossikeen.com/) **|** [Donate](https://owenrossikeen.com/donate)