Anndromeda RoyaleAPI, also known as Royale High API or RHAPI, is a powerful Quart + Puppeteer API designed to fetch the names of items from the popular Roblox game Royale High and their associated community values from Traderie. The API returns results in JSON format, making it easy to integrate and use for various applications or analysis.
This API was created to interact with the Traderie website, a platform where the Royale High community buys and sells in-game items. With the API, you can easily access the most up-to-date information on item names and their community values, providing the necessary data for further processing or for custom interfaces.
-
Item Fetching: Retrieve a list of Royale High items and their respective values directly from Traderie, providing real-time data for developers, analysts, and users tracking item trends. The API supports fetching the values of specific items using query parameters for more targeted searches.
-
Program Integration: Seamlessly integrate API responses into various programs like Excel, Google Sheets, and other data processing tools, enabling real-time data retrieval, analysis, and automation without manual entry.
-
JSON Output: Returns data in JSON format, making it easy to parse and manipulate in various programming environments, including Python, JavaScript, and Power Query.
-
Bulk Data Retrieval: Supports fetching full lists of items at once, reducing the number of API calls needed and optimizing performance for large-scale data analysis.
-
Automated Data Analysis: Easily integrate with data visualization tools like Power BI or Google Sheets, enabling dynamic price tracking and trend analysis.
The application has been tested on Windows 11 but should be compatible with Linux and macOS systems as well. While it has been primarily tested in a Windows environment, the code should work across these platforms with minor adjustments (if any). For optimal results, it’s recommended to use a system with Python 3.x and Node.js installed.
Before running the application, you’ll need the following:
- Google Chrome (required for Puppeteer browser automation)
- Node.js (with npm)
- Download Node.js (We'll verify that it's installed later)
- Python 3.x
- Pip (Python package manager, usually comes with Python)
We'll install these dependencies later during installation:
- Puppeteer (for browser automation)
- Quart (Python web framework)
- Quart-CORS (to handle CORS for the Quart API)
📌 Note: See provision/ for automatic provisioning (You'll still need to manually install Google Chrome, Node.js, Python 3.x, and Pip beforehand.). Download setup.bat
and setup.bat.ps1
. Running setup.bat
will automatically clone the repository and install dependencies (Windows only). Alternatively, you can install the program manually:
git clone https://github.com/Xelvanta/Anndromeda-RoyaleAPI
cd Anndromeda-RoyaleAPI
Make sure you have Node.js installed. If not, follow these steps:
To check if Node.js and npm are installed:
-
Open your terminal or command prompt.
-
Run the following commands to check their versions:
node -v npm -v
These should return version numbers for both Node.js and npm. If they do, you’re good to go!
If you see an error like 'node' is not recognized
or 'npm' is not recognized
, then Node.js (and npm) is not installed.
- Go to the official Node.js website.
- Download and install the LTS version (Recommended for most users).
Make sure to add Node.js to your PATH during installation (usually added by default during the setup wizard).
Before running your script, make sure you have all required dependencies:
-
Open your terminal.
-
Navigate to the directory containing
fetchData.js
:cd Anndromeda-RoyaleAPI
-
Run the following command to install dependencies:
npm install puppeteer puppeteer-extra puppeteer-extra-plugin-stealth
This will install Puppeteer and related modules, which are required for your script to function correctly.
Install the necessary Python dependencies:
pip install -r requirements.txt
-
Open a new terminal.
-
Navigate to the directory containing
fetchData.js
. -
Run the following command (the
<number>
represents the page number):node fetchData.js <number>
For example:
node fetchData.js 0
will fetch page 0.node fetchData.js 1
will fetch page 1.
If successful, this indicates that the JavaScript side of things is working.
To run the Quart app:
-
Open a terminal and navigate to the directory where your app resides.
cd Anndromeda-RoyaleAPI
-
Run the following:
quart run
-
Access the API:
Open any browser or an API client (like Insomnia) and navigate to:
http://127.0.0.1:5000/items
This will start the Quart server and start fetching the Traderie API for all pages starting from 0.
📌 IMPORTANT: See docs/general_api_guide.md for more information.
Here are some common issues you may encounter during setup:
- Node.js not recognized: Ensure Node.js is installed and properly added to your system's PATH. If you encounter this issue, the instructions to fix it are covered in the Troubleshooting section.
- Puppeteer not working: Make sure you have Google Chrome installed on your system, as Puppeteer requires it to run.
- Missing Python dependencies: Ensure you have installed
quart
andquart-cors
usingpip install -r requirements.txt
.
If you encounter issues, follow the troubleshooting steps below:
If node
or npm
is not recognized, it may be a PATH issue.
- Search for "Environment Variables" in the Start Menu.
- Click "Edit the system environment variables".
- Click "Environment Variables...".
- In the "System variables" section, find a variable named
Path
. - Select
Path
and click "Edit...". - Click "New" and add the path to your Node.js installation directory. Common locations include:
C:\Program Files\nodejs\
C:\Program Files (x86)\nodejs\
- Click OK on all dialogs to save the changes.
Important: You may need to restart your computer for the PATH changes to take effect.
-
Open your shell configuration file (e.g.,
~/.bashrc
,~/.zshrc
). -
Add this line to the end of the file, replacing
/path/to/nodejs
with the correct path to your Node.js executable:export PATH="/path/to/nodejs:$PATH"
-
Use
which node
to find the correct path. -
Save and run:
source ~/.bashrc # or source ~/.zshrc
If running npm -v
results in an error like:
npm : File C:\Program Files\nodejs\npm.ps1 cannot be loaded because running scripts is disabled on this system.
You can resolve this by changing your PowerShell execution policy.
- Search for "PowerShell" in the Start menu.
- Right-click "Windows PowerShell" and choose "Run as administrator".
Run the following command to allow scripts to run:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Confirm the change by typing Y
and pressing Enter.
Close the PowerShell window and open a new one. Then try running:
npm -v
This should work now! 🎉
Feel free to fork the project and submit a pull request to help improve Anndromeda RoyaleAPI. Your contributions are welcome! See CONTRIBUTING.md for more information.
Anndromeda RoyaleAPI is open source and available under the GPL-3.0 license. See the LICENSE for more details.
By Anndromeda
A sister company to Xelvanta Group Systems
For support or inquiries, please contact us at Xelvanta@proton.me.
GitHub: https://github.com/Xelvanta