# Qloo Developer Guide

[**Qloo**](https://qloo.com) **is the cultural AI, and we produce deep data science for the largest verticals of culture and entertainment. As experts in people’s taste, we uniquely find connections across over a dozen categories and use that knowledge to generate high quality recommendations at scale. For this hackathon, we’re giving you access to a limited version of our enterprise API.**<br>

**Challenge: Discover music by its relation to any combination of locations, books, restaurants, fashion, film, music or tV.**<br>

### **Overview**

**You, hackathoner, can use Qloo’s API to:**

* **Search through ≈ 5.5 million entities spanning books, restaurants, fashion, film, music, travel destinations and TV.**
* **Use any combination of entities to get recommendations in the category of your choice.**

### **Important Information**

* **Each team will be given a token to access the API.**
* **You need to add the following parameters to all API requests:**
  * &#x20;     **"Content-Type": "application/json"**
  * &#x20;     **"Authorization": \<token>**

### **Quickstart**

**Javascript (es6)**<br>

| <p><strong>const fetch = require('node-fetch');</strong><br><strong>const token = '...';</strong><br><strong>const url = '<https://gfqb4seej7.execute-api.us-east-1.amazonaws.com/production>';</strong><br><br><strong>const qlooApi = async (path, params) => {</strong><br>  <strong>const paramString = new URLSearchParams(params).toString();</strong><br>  <strong>const results = await fetch(`${url}/${path}?${paramString}`, {</strong><br>    <strong>method: "GET",</strong><br>    <strong>headers: {</strong><br>      <strong>"Content-Type": "application/json",</strong><br>      <strong>"Authorization": token,</strong><br>    <strong>},</strong><br>  <strong>});</strong><br>  <strong>return await results.json();</strong><br><strong>}</strong><br><br><strong>(async () => {</strong><br>    <strong>console.log(await qlooApi('/search', { query: 'beyonce' }));</strong><br>    <strong>console.log(await qlooApi('/recs', { sample: \['id', 'id'] }));</strong><br><strong>})()</strong></p> |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

### **API Endpoints**

**Our documentation for this project lives at:**<br>

**<http://docs-a07d0e4aa.qloo.com/>**<br>
