Quickstart

This guide will get you all set up and ready to use the Spot Thought API. We'll cover how to make your first HTTP request and how to inspect the response. We'll also look at where to go next to find all the information you need to take full advantage of our powerful REST API.

Prepare your HTTP client

Before making your first API request, make sure you have a way to send HTTP requests. We'll use cURL throughout this guide because it is available on every major platform, but you can use any tool or HTTP library you prefer.

# cURL is most likely already installed on your machine
curl --version

Making your first API request

After confirming that you can issue HTTP requests, you are ready to make your first call to the Spot Thought API. Below, you can see how to send a GET request to the Particiapnts endpoint to get a list of all your participants. In the cURL example, results are limited to ten participants, the default page length for the API.

  curl https://api.spot-thought.com/participants \
  -H "X-Spot-Api-Key: acct_123" \
  -H "X-Spot-Api-Secret: sk_live_abcd"

What's next?

Great, you're now set up to make HTTP requests and have made your first call to the API. Here are a few links that might be handy as you venture further into the Spot Thought API:

• Grab your API key from the Spot Thought console
• Check out the Screeners endpoint
• Learn about the different error messages in Spot Thought