diff --git a/README.md b/README.md
new file mode 100644
index 0000000..71bd0aa
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# rap-names-api
+
+This is a basic api which shows the birth name, birth location and age of your favourite rappers.
+
+To run the api locally:
+1. Clone the repo
+2. run `npm install`
+3. Go to http://localhost/8000/api
+
+**Link to api:** https://rapper-api-100Devs-class39.herokuapp.com
+
+## How It's Made:
+**Tech used:** Node.js, Express, Javascript
+This api was made with just the basics of Node and Express. 
+
+## Lessons Learned:
+Learned how to implement a basic api with Node and Express. 
+We have unlocked new powers!
+Learned that we can literally build the app of our dreams!