In This Guide

The SEMrush integration displays recommended terms to use in your content based on popular search keywords.

Overview of SEMrush

One strategy for improving your rankings in search results is to incorporate common search keywords into your content. For example, visitors searching for nearby farmers markets most likely use the familiar terms lettuce and carrot instead of the scientific terms Lactuca sativa and Daucus carota. If you use the familiar terms, then visitors searching for lettuce and carrot have a higher chance of seeing a link to your farmers market in the search results.

When you apply tags to an item, Brightspot sends the tags to SEMrush and displays the resulting keywords. You can then incorporate those keywords into your content.

The SEMrush integration requires you to have an SEMrush account. For your SEMrush budgeting purposes, consider that Brightspot uses the following API calls:

These calls occur at the following times:

Configuring SEMrush

To configure SEMrush:

  1. Click menu > Admin > Sites & Settings > Global. The Edit Global widget appears.
  2. Click Main, under SEMrush, enter the API Key. You can find the API key in your SEMrush console.
  3. From the Content Types list, select the content types for which you want to receive keywords from SEMrush.
  4. Click Save.

Retrieving keywords associated with a tag

Brightspot retrieves SEMrush keywords associated with your tags.

To retrieve keywords associated with a tag:

  1. Create or open a tag in the content edit page.
  2. Click save or Publish.
  3. Under more_horiz > SEMrush, review the retrieved keywords. Brightspot sorts the keywords in order of popularity.
  4. Click visibility to view details about the keyword.

See also:

Fields in SEMrush Keyword widget

The following table describes detailed information provided with retrieved keywords.



Search term or phrase.
Search volume
Average number of times per month keyword is searched over the past 12 months.
Cost per click
Average price in U.S. dollars advertisers pay to Google AdWords when a searcher clicks on an ad containing this keyword.
Competitive density of advertisers using the keyword for their ads. One (1) means the highest competition.
Number of results
Number of items on the Internet associated with the keyword.
Share of traffic driven to your site when searchers click on a result for the keyword. Results are for the last 12 months. For example, if this field shows 0.04, 0.05, 0.07, 0.05, 0.05, 0.05, 0.06, 0.06, 0.06, 0.07, 0.06, 0.05, then during the first previous month 4% of the traffic for the keyword salad went to your site, for the second previous month 5% went to your site, and so on.
Related relevance
Indicates how closely related the keyword is to your tags.

Viewing Retrieved Keywords

To view retrieved keywords:

  1. Create or open a custom dashboard that includes the SEMrush Data widget. (For details about creating a custom dashboard, see Shared dashboards or One-off dashboards.) The widget displays the keywords and associated tags.
    Viewing retrieved keywords.png
    SEMRush data showing retrieved keywords
  2. Filter the keywords by entering text in the search field.
  3. In the SEMrush Data widget, click one of the keywords. An SEMrush Keyword widget appears, providing details about the keyword.

The entries in the SEMrush Data widget are those satisfying the following conditions:

  • Have a search volume > 0
  • Are associated with tags owned by the current site
  • Contain text appearing in the search field (if any)

Incorporating keywords into content

Incorporating high-volume keywords into your items improves the chances of those items appearing in search results.

To incorporate keywords into content:

  1. Create a new item in the content edit page. The item must be one of the content types you configured as described in Configuring SEMrush
  2. Apply a tag to the item.
  3. Click save to save a draft. The SEMrush Keywords widget appears in the right rail. The widget lists popular keywords associated with the tag.
    If you are not seeing the SEMrush widget in the right rail, make sure you have the SEMrush integration enabled and that you have a tag applied to your asset.
  4. Incorporate the keywords into the item.
  5. Complete your site's workflow and publish the item.

In the following example, the tag is headless. SEMrush retrieved several keywords associated with the term headless, and the editor incorporated those keywords into an article to improve the article's ranking on search results.

SEMrush keywords displayed.png
Incorporating keywords into your Brightspot content

See also:

Refreshing a tag's SEMrush keywords

To refresh a tag's SEMrush keywords:

  1. Search for and open the tag in the content edit page.
  2. Select more_horiz > SEMrush.
  3. Toggle on Force Refresh.