> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# BuzzSumo Connector

## Intro

BuzzSumo discovers the content that performs best for any topic or competitor and finds the key influencers to promote the content. Use the Domo BuzzSumo connector to receive details about most shared content, top influencers, trending content, and more. To learn more about the BuzzSumo API, visit their page ([http://buzzsumo.com/knowledge/buzzsumo-api/](http://buzzsumo.com/knowledge/buzzsumo-api/ "http://buzzsumo.com/knowledge/buzzsumo-api/") ).

You connect to your BuzzSumo account in the Data Center. This topic discusses the fields and menus that are specific to the BuzzSumo connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274).

## Prerequisites

To connect to your BuzzSumo account and create a DataSet, you must have a BuzzSumo API key. For information about obtaining an API key, reach out to your BuzzSumo account representative.

## Connecting to Your BuzzSumo Account

This section enumerates the options in the **Credentials** and **Details** panes in the BuzzSumo Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your BuzzSumo account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> API Key </p></td><td colspan="1" rowspan="1"><p> Enter your BuzzSumo API key. </p></td></tr></tbody></table>

Once you have entered valid BuzzSumo credentials, you can use the same account any time you go to create a new BuzzSumo DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the BuzzSumo report you want to run. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> Article Sharers </p></td><td colspan="1" rowspan="1"><p> Returns a sampling of the people who have shared a given article on Twitter. This is the same data you see when you click <b> View Sharers </b> in the top content search. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Links Shared </p></td><td colspan="1" rowspan="1"><p> Returns recent links shared by a given Twitter user, ordered by most recent first. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Most Shared </p></td><td colspan="1" rowspan="1"><p> Returns the most shared content for a specific domain or topic/keyword. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Top Influencers </p></td><td colspan="1" rowspan="1"><p> Returns influencers for a given topic. These are the same results you see in BuzzSumo's <b> Influencer Search </b> area. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Trending </p></td><td colspan="1" rowspan="1"><p> Returns the most popular content over the last 24 hours. </p></td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Search Query </p></td><td colspan="1" rowspan="1"><p> Enter a search query to retrieve data filtered to that query. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Result Type </p></td><td colspan="1" rowspan="1"><p> Select a social network to filter your data by. If you select <b> Total </b>, data is returned for all social networks. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Article Type </p></td><td colspan="1" rowspan="1"><p> Select an article type to filter your data by. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Language (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the language you want to filter results by. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search Type </p></td><td colspan="1" rowspan="1"><p> Select whether you want to sort results by trending score or total shares. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Topic (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the topic you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> TLD (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the TLD (top-level domain) you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Domain (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the domain you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Person Types </p></td><td colspan="1" rowspan="1"><p> Select the person types you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Ignore Broadcasters? </p></td><td colspan="1" rowspan="1"><p> Check the box if you do not want broadcasters to be shown in your data. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Option to Select Article IDs </p></td><td colspan="1" rowspan="1"><p> Select whether you want to collect data for all articles for a specified search query or only for a specified article. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Article ID </p></td><td colspan="1" rowspan="1"><p> Select the ID of the article you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Blocked Domains (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the names of blocked domains you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Username </p></td><td colspan="1" rowspan="1"><p> Enter the username you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Hours (Optional) </p></td><td colspan="1" rowspan="1"><p> Enter the number of hours you want to retrieve data for. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Duration </p></td><td colspan="1" rowspan="1"><p> Select whether you want to pull data for a specific date or a date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Report Date </p></td><td colspan="1" rowspan="1"><p> Select whether the report data is for a specific date or for a relative number of days back from today. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Date </p></td><td colspan="1" rowspan="1"><p> Select the date for the report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back </p></td><td colspan="1" rowspan="1"><p> Enter the number of past days that should appear in the report. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the first date in your date range is a specific or relative date. You select the last date in your range in <b> End Date </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Date </p></td><td colspan="1" rowspan="1"><p> Specify whether the second date in your date range is a specific or relative date. You select the first date in your range in <b> Start Date </b>. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Start Date </p></td><td colspan="1" rowspan="1"><p> Select the first date in your date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific End Date </p></td><td colspan="1" rowspan="1"><p> Select the second date in your date range. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to Start From </p></td><td colspan="1" rowspan="1"><p> Enter the number of the farthest day back that should be represented in the report. Combine with <b> Days Back to End At </b> to create a range of represented days. </p><p> For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Days Back to Start From </b> and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to End At </p></td><td colspan="1" rowspan="1"><p> Enter the number of the most recent day back that should be represented in the report. Combine with <b> Days Back to Start From </b> to create a range of represented days. </p><p> For example, if you entered <span class="mt-font-courier-new"> 10 </span> for <b> Days Back to Start From </b> and <span class="mt-font-courier-new"> 5 </span> for <b> Days Back to End At </b>, the report would contain data for 10 days ago up until 5 days ago. </p></td></tr></tbody></table>

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Data Connector](/s/article/360042926274).
