Web API Tutorial | Intrinio

API Tutorial

Making your first API call

Welcome to the Intrinio API. Through our Intrinio Data Marketplace, we offer a wide selection of financial data feeds sourced by our own proprietary processes as well as from many data vendors. The primary application of the Intrinio API is for use in third-party applications and integrations or for end-users utilizing the Excel add-in.

The Intrinio API uses HTTPS verbs and a RESTful endpoint structure, which makes it easy to request data from Intrinio. Authentication is administered over URL Parameter Authentication. Responses are delivered in JSON format.

Now, let's get started on making your first API call.

Via Browser

The easiest way to test out the Intrinio API is by using your browser.

  1. Paste your request into the address bar. Be sure to include your API Key by specifying an api_key URL parameter set to the value of your API Key. For example:

    https://api.intrinio.com/companies?ticker=AAPL&api_key={YOUR_API_KEY}
    To view your access key, click here to log in.
  2. The request response (in JSON) format should appear in your browser viewport.

Via Command Line

You can also test the Intrinio API using the cURL command line utility.

curl https://api.intrinio.com/companies?ticker=AAPL&api_key={YOUR_API_KEY}

Via Code

Authentication

The Intrinio API uses URL Parameter Authentication over HTTPS. Append your API Key to your request URL to gain access to your feeds.

To view your access key, click here to log in.

Response Formats

All Intrinio API responses are in JSON format. The HTTP Response Status Code of 200 indicates that a request is well formed and valid. A Status Code of 401 indicates that API Authorization is not authenticated, due to being invalid. The Response Status Code of 403 indicates that you have reached a usage limit, such as your subscription’s 10 minute call limit or daily call limit. The Response message will give further indication to the reason for the error.

Ruby Example

require "http"
require "json"

request_url = "https://api.intrinio.com/companies?ticker=AAPL&api_key={YOUR_API_KEY}"

response = HTTP.get(request_url).body

company = JSON.parse(response)
puts company

JavaScript (Node) Example

var https = require("https");

var request = https.request({
    method: "GET",
    host: "api.intrinio.com",
    path: "/companies?ticker=AAPL&api_key={YOUR_API_KEY}"
}, function(response) {
    var json = "";
    response.on('data', function (chunk) {
        json += chunk;
    });
    response.on('end', function() {
        var company = JSON.parse(json);
        console.log(company);
    });
});

request.end();

Go Forth and Build

We can't wait to see what you will build using the Intrinio API.

Documentation

For a detailed reference, see our Documentation site.

Developer Program

If you are interested in getting 6 months of extended access to all of our data feeds, take a look at the Developer Program.

We Are Here to Help

If you run into any trouble feel free to chat with us.

Go to my Account