How To Connect Outbrain To Google Sheets [API Tutorial]

How to connect the Outbrain API to Google Sheets

Outbrain Is the Leading Content Discovery Platform on the Web. We can use the Outbrain API to import data from Outbrain into Google Sheets. In this tutorial, we’ll show you how to connect the Outbrain REST API to Google Sheets in 5 steps:

Install the Apipheny add-on
Obtain an access token
Choose an Outbrain API endpoint
Enter your Outbrain API request into Apipheny
Run the Outbrain API request in your Google Sheet

Step 1.) Install and open the Apipheny add-on for Google Sheets

Apipheny is an API connector for Google Sheets. You can use Apipheny to connect your Google Sheets to unlimited API data sources, make unlimited API requests, and more. There is a 30 day free trial included.

1.) Install Apipheny by opening the following link on desktop and then clicking the Install button in the Google Marketplace: https://apipheny.io/install

2.) After you’ve installed Apipheny, open a Google Sheet and then click on the Extensions dropdown in the menu at the top.

In the dropdown list you should see Apipheny. Click Apipheny then click Import API to open the Apipheny sidebar in your Google Sheet.

Tip: you can open a new Google Sheet by entering this URL in your browser: sheet.new

Step 2.) Obtain an access token

After logging into your Outbrain account go to https://my.outbrain.com/create-token to generate a token. Type in your password, then click the Generate button:

Your token is now generated:

Copy your token to a safe location, because you’ll need it later.

Step 3.) Choose an Outbrain API endpoint

In this section, we’ll show you how to browse the Outbrain API documentation to find an endpoint that retrieves the information you need from Outbrain. If you already know your API URL, or you want to use the same example URL as us, just skip to Step 4.

First, open the Outbrain API documentation page: https://amplifyv01.docs.apiary.io/#reference/marketers/marketer/list-marketers?console=1

The menu on the left contains general information about the Outbrain/Amplify API and a list of categorized endpoints:

If we click the Budgets category for example, a description of this category will be displayed, along with a list of its endpoints:

Scrolling down, we will find the Budgets endpoints. An example endpoint is Retrieve a single Budget, which retrieves a single budget’s information by its ID:

https://private-anon-f5bbebe79c-amplifyv01.apiary-mock.com/budgets/budget_id

If you use this endpoint/URL, don’t forget to replace budget_id with a real ID.

The endpoint’s documentation contains a short description of the endpoint’s purpose, its HTTP method (GET), the URI, the query parameters, an example cURL request and example parameters, responses and headers:

Retrieve a single Budget endpoint documentation — **Retrieve a single Budget** endpoint documentation

Step 4.) Enter your Outbrain API request into Apipheny

Now go back to your Google Sheet and make sure that the Apipheny add-on is open on the Import tab. With the Import tab open, enter these details into the add-on:

Method: At the top of the Apipheny sidebar, select the HTTP method (GET or POST) required by your API endpoint. For this example, we are using the GET method.

API URL: In Step 3, we explained how you can find the Outbrain REST API endpoint that you need. Now copy and paste your complete Outbrain API URL into the Apipheny add-on, where it says API URL Path, followed by any parameters required for your query (if applicable).

For this example, we are using the List Marketers endpoint which retrieves all Marketers associated with the current user. This is what the whole URL looks like:

https://private-anon-f5bbebe79c-amplifyv01.apiary-mock.com/marketers

Headers: In the Headers section of Apipheny, add one row with the following key and value:

Key:
OB-TOKEN-V1

Value:
token

token is the token you previously obtain in Step 2.

Outbrain API request entered into Apipheny

Step 5.) Run the Outbrain API request in your Google Sheet

Finally, the last step is to click the Run button at the bottom of the Apipheny add-on and then wait for the Outbrain API data to be imported into your Google Sheet. Here’s what our request looked like when completed:

Outbrain data imported into Google Sheets

That’s it! You’ve successfully connected your Outbrain account to Google Sheets using the Outbrain API, Google Sheets API, and the Apipheny add-on. Now that you know how to connect Outbrain to your Google Sheets, try some other endpoints!