Embed data using REST APIs

You can use the REST APIs to programmatically query pinboard and visualization data from the ThoughtSpot application.

To query ThoughtSpot objects and embed them in a web page, portal, or application, you can use the data REST APIs. The data REST APIs return data as JSON (JavaScript Object Notation) objects.

Embed pinboard or visualization data

To construct the URL for making a REST API call for embedding a pinboard or visualization:

Log in to ThoughtSpot.
Navigate to the pinboard from which you want to get data.
Find the ID number of the object from which you want to fetch data.

To embed a pinboard, click the ellipses icon, and then select Copy embed link.

To embed a visualization:
a. Navigate to the table or chart.
b. Click the ellipses icon in the upper right corner of the table or chart.
c. Click Copy embed link icon.
Copy the ID number from the link. Paste it somewhere so that you can use it later to construct the URL for the REST API call.

If the object is a pinboard, copy the identifier that appears after viz/.

For visualizations (table or chart), copy the IDs that appear after viz/.

Construct the URL.

For a pinboard, the URL is as follows:

https://<ThoughtSpot-host>/callosum/v1/tspublic/v1/pinboarddata?id=<pinboard_id>

For a visualization, the URL is as follows:

https://<ThoughtSpot-host>/callosum/v1/tspublic/v1/pinboarddata?id=<pinboard_id>&vizid=%5B<visualization_id>%5D

To apply filters to the data, use runtime filters.

For example, to sort values equal to red in the Color column for a visualization in a pinboard, you can pass the runtime filter in the URL query parameters as shown here:
```
https://<ThoughtSpot-host>/callosum/v1/tspublic/v1/pinboarddata
?id=<pinboard_id>&vizid=%5B<visualization_id>%5D
&col1=color&op1=EQ&val1=red
```
After you construct the URL, send a POST request to get data from ThoughtSpot.

The Data REST API returns the data formatted as JSON.
Retrieve the data from the JSON and embed it in your Web page, Web portal, or application.