Getting Started

The GiraffeSpot API

The GiraffeSpot API is amongst the largest in the market, containing thousands of endpoints.

At GiraffeSpot we collect data from hundreds of thousands of sources and then refine, classify and segment everything into categories and vertically specific datasets. Our goal to is make it easier for companies, partners and developers to integrate, enhance and make use of data in their own applications

Our restful API is easy to learn, consistent and always return standard JSON data types. JavaScript Object Notation or JSON is an open-standard file format that uses human-readable text to transmit data objects consisting of attribute–value pairs and array data types (or any other serializable value).

Setup and Prequisites

To get up and running, you will need the following:

  • A basic understanding of how to make an API request in your language of choice
  • A review of our documentation
  • An API key in order to make authorized requests

Step 1 - Get an API Key

To use the GiraffeSpot API you will need to get a free API key, which basically means making a free account.

Step 2 - Make your first request

Now that you have an API key, you are ready to make your first request.

Example request using cURL

Following is an example, using curl and a Linux command prompt to get the current price of the crypto currency bitcoin.

$ BASE=''
$ curl "$BASE/api/finance/crypto/bitcoin/last?apikey=$KEY"

Example request using Node.js

This code fragment demonstrates how to make a request and use the reponse of a GiraffeSpot API.

(Note: this code sample assumes you are using the latest version of Node with async/await support along with the request-promise NPM.)

let request = require('request-promise')

let key = 'YOUR_KEY_HERE'
let url = `${key}`

let res  = await request(url)
let data = JSON.parse(res)


Step 3 - Parse and Process the Response

By default the GiraffeSpot API always responds to requests back with JSON.

  "category" : "crypto",
  "period" : "last",
  "entity" : "bitcoin",
  "data" : [ {
    "timestamp" : 1575273600,
    "value" : 7320.71,
    "date" : "2019-12-02"
  } ]