Use
COMPOSIOFOR YOU
Give Claude, Codex, or any harness secure access to 1700+ tools
CLI
One command to add tools and auth to your coding agent
Build
DEVELOPER PLATFORM
SDKs, tools, and auth for agents and backend apps
MCP GATEWAY
One managed MCP endpoint for all your tools and agents
ENTERPRISE
SSO, governance, and audit controls for deploying agents org-wide
Features
TRIGGERS
Start background agents from events across your connected apps
FIREWALLNEW
Blocks instructions hidden in tool results before your agent reads them
INSTANTNEW
Audio, video, search, browser and data tools, with no keys to manage
OPTIMIZATION
Lower cost per completed task with optimised tools and skills
FOR AGENTS
CLAUDE CODEX OPENCLAW CURSOR HERMES
BUILT FOR
OFFICE WORK SALES MARKETING PRODUCT & DESIGN CUSTOMER SUPPORT ENGINEERING HR & RECRUITING FINANCE & OPS E-COMMERCE CONTENT & MEDIA IT & SECURITY
ALL USE CASES
DOCS

Semrush API

Give your agents access to Semrush API. Bring your own Semrush key, or skip the signup and pay per call from your Composio balance with Composio Instant.

Get started for free Get a demo

Semrush

Instant

Semrush is a leading SEO tool suite for keyword research, competitor analysis, and campaign tracking. It empowers marketers to improve search rankings and optimize online visibility.

74 Tools

COMPOSIO INSTANT

What is Composio Instant?

Composio Instant lets your agent use paid APIs like Semrush without a separate account or API key for each one. New accounts start with $2 of free credit.

No Semrush account or key

Your agent calls Semrush through Composio, so there is nothing to sign up for, store, or rotate.

Pay per call, at cost

$0.325 per 1,000 API units used, paid from your Composio balance with zero markup.

Works in any agent

Claude, ChatGPT, Cursor, and other MCP clients, or your own code with the Composio SDK.

Works with your apps

Use Semrush with Gmail, Slack, Google Sheets, and 1,700+ other apps you connect.

AI ASSISTANTS

Connect the Semrush API to your AI assistant

Use Semrush from the AI assistant you already work in. Connect Composio once, then paste the prompt.

1
Open the Connectors menu
Use the button to open Claude's Add connector dialog with Composio filled in. Or click + in the message box, then Connectors, Add connector and Add custom connector.
Add Composio to Claude
2
Add the Composio MCP server
Name it Composio, paste the MCP server URL and click Add.
https://connect.composio.dev/mcp
3
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
4
Paste the prompt
Start a new chat and paste the prompt. Claude runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio's plugin page in ChatGPT and click Install. Sign in to ChatGPT first if it asks.
Install in ChatGPT
2
Authorize in your browser
Connect the plugin, then sign in to Composio to approve the connection.
3
Turn on Composio in your chat
In a new chat, click +, then More, and select Composio.
4
Paste the prompt
Paste the prompt into that chat. ChatGPT runs the call on Composio Instant.

1
Install the Composio plugin
Open Composio in the Cursor marketplace, click Install Composio Plugin for Cursor and approve the connection in your browser.
Install in Cursor
2
Paste the prompt
Open the Agent chat and paste the prompt. Cursor runs the call on Composio Instant.

1
Add the Composio plugin
Open Composio's listing on x.ai and click Add to Grok Bot. When Grok Bot opens the plugin, click Add.
Add to Grok Bot
2
Authenticate
Go to Installed, open Composio and click Authenticate. Sign in to Composio and click Authorize.
3
Paste the prompt
Paste the prompt into your bot's chat. Grok Bot runs the call on Composio Instant.

1
Paste the setup prompt
Copy this into your Hermes chat. Hermes adds the Composio MCP server for you.
Set up Composio from composio.dev/hermes
2
Authorize in your browser
A browser window opens. Sign in to Composio to approve the connection.
3
Paste the prompt
Start a new chat and paste the prompt. Hermes runs the call on Composio Instant.

ClaudeNew chat

Paste this prompt

Use Semrush through Composio Instant to get SEO and PPC metrics for the keyword coffee in country AU. Return the keyword metrics.

What success looks like

SEMRUSH_V4_KEYWORD_METRICS

Your assistant runs Semrush and replies with SEO and PPC metrics for coffee in AU.

Runs on Composio Instant

SDK

Use the Semrush API in your code

Call Semrush from your own agent with the Composio SDK. Four steps and one tool call.

1
Set up Composio
Turn on Instant Toolkits in your project settings and check your prepaid balance in Billing. Then set your API key.
export COMPOSIO_API_KEY="your_composio_api_key"
2
Install the SDK
The Python SDK needs Python 3.11 through 3.15.
The TypeScript SDK is ESM-only and needs Node.js 22.22.3 or newer.
pip install composio
npm install @composio/core
3
Run the call
Create a session that keeps Instant to this toolkit and reports the charge, then run the tool on the Instant account.
SEMRUSH_V4_KEYWORD_METRICS
4
Read the response
When the call runs on Instant, the response includes its charge: the amount as an exact USD decimal string, the currency and charged_by.

agent.py

from composio import Composio

composio = Composio()

session = composio.sessions.create(
    user_id="user_123",
    toolkits=["semrush"],
    instant={
        "toolkits": {"enable": ["semrush"]},
        "return_instant_charge": True,
    },
)

result = session.execute(
    "SEMRUSH_V4_KEYWORD_METRICS",
    arguments={
        "country": "AU",
        "keyword": "coffee",
    },
    account="instant_account",
)
print(result)
print("Instant charge:", result.instant_charge)

agent.ts

import { Composio } from "@composio/core";

const composio = new Composio();

const session = await composio.create("user_123", {
  toolkits: ["semrush"],
  instant: {
    toolkits: { enable: ["semrush"] },
    returnInstantCharge: true,
  },
});

const result = await session.execute(
  "SEMRUSH_V4_KEYWORD_METRICS",
  {
    "country": "AU",
    "keyword": "coffee"
  },
  { account: "instant_account" },
);
console.log(result);
console.log("Instant charge:", result.instantCharge);

response

{
  "data": "<keyword metrics>",
  "error": null,
  "successful": true,
  "instant_charge": {
    "amount": "<usd amount>",
    "currency": "USD",
    "charged_by": "<provider>"
  }
}

TOOLS

Available Semrush API tools

12 Semrush tools run on Instant, priced per call with no Semrush key. Tools marked Your key need your own Semrush account.

Action	Tool slug	What it does	Availability
Keyword Metrics	SEMRUSH_V4_KEYWORD_METRICS	Get SEO and PPC metrics for one keyword and country.	Instant$0.325 per 1,000 API units used
Backlink Overview	SEMRUSH_V4_BACKLINKS_OVERVIEW	Summarize backlink metrics for a URL or domain.	Instant$0.325 per 1,000 API units used
Backlink Competitors	SEMRUSH_V4_BACKLINK_COMPETITORS	Find backlink competitors based on referring-domain overlap.	Instant$0.325 per 1,000 API units used
Compare Backlinks	SEMRUSH_V4_BACKLINKS_MATRIX	Compare shared referring domains and backlinks for up to six targets.	Instant$0.325 per 1,000 API units used
Compare v4 backlink summaries	SEMRUSH_V4_BACKLINKS_COMPARISON	Compare v4 backlink summaries for up to ten targets.	Instant$0.325 per 1,000 API units used
Get v4 authority score profile	SEMRUSH_V4_AUTHORITY_SCORE_PROFILE	Get the v4 referring-domain authority-score distribution.	Instant$0.325 per 1,000 API units used
Get v4 backlinks historical summary	SEMRUSH_V4_BACKLINKS_HISTORICAL_SUMMARY	Get monthly v4 backlink history for a URL or domain.	Instant$0.325 per 1,000 API units used
List v4 backlink anchors	SEMRUSH_V4_ANCHORS	List v4 backlink anchors for a URL or domain.	Instant$0.325 per 1,000 API units used
List v4 backlinks	SEMRUSH_V4_BACKLINKS	List v4 backlinks with field selection, filtering, sorting, and pagination.	Instant$0.325 per 1,000 API units used
List v4 indexed pages	SEMRUSH_V4_INDEXED_PAGES	List v4 indexed backlink pages for a URL or domain.	Instant$0.325 per 1,000 API units used
List v4 referring domains	SEMRUSH_V4_REFERRING_DOMAINS	List v4 referring domains for a URL or domain.	Instant$0.325 per 1,000 API units used
List v4 referring IPs	SEMRUSH_V4_REFERRING_IPS	List v4 referring IP addresses for a URL or domain.	Instant$0.325 per 1,000 API units used
Organic Keywords	SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS	Retrieve a domain's organic search keyword report.	Your key
Compare Domains	SEMRUSH_DOMAIN_VS_DOMAIN	Compare domain rankings to find shared, unique, or gap keywords.	Your key
Paid Keywords	SEMRUSH_DOMAIN_PAID_SEARCH_KEYWORDS	Find keywords driving paid search traffic to a domain.	Your key
Ad History	SEMRUSH_DOMAIN_AD_HISTORY	Review a domain's 12-month advertising history, including keywords and ad copy.	Your key

Instant prices are Semrush's list prices with 0% markup, paid from your Composio balance and updated every hour. Instant calls also count toward your plan's tool calls. See all plans on the pricing page.

USE CASES

Semrush API use cases and example prompts

Copy a prompt into your agent. Each one uses Semrush with apps you connect through Composio.

Build a keyword opportunity tracker
Use Semrush to get SEO and PPC metrics for each keyword in my Launch Keywords sheet in Google Sheets, using the United States as the country. Add the returned metrics beside each keyword, then post a short summary of the clearest opportunities in Slack's #seo channel.
Apps used: Semrush, Google Sheets, Slack
Compare backlink overlap
Use Semrush to find backlink competitors for acme.com. Compare backlinks for acme.com and up to five of those domains, then save the comparison and shared referring domains in my SEO Research page in Notion. Post the main findings in Slack's #seo channel.
Apps used: Semrush, Notion, Slack
Plan content from keyword gaps
Use Semrush to compare organic rankings for acme.com and the competitor domain listed in my Competitors sheet in Google Sheets. Add the shared, unique, and gap keywords to the sheet. Create a content brief in Google Docs from the gap keywords.
Apps used: Semrush, Google Sheets, Google Docs
Prepare paid search account research
Use Semrush to review the paid keywords and 12-month ad history for acme.com, including the ad copy. Add a summary to the Acme company record in HubSpot, then create a Gmail draft for our account team with the observed keyword themes and ad messages.
Apps used: Semrush, HubSpot, Gmail

TROUBLESHOOTING

Semrush API troubleshooting

Still stuck? The Instant tools docs cover limits, charges and session settings.

Set the country parameter in SEMRUSH_V4_KEYWORD_METRICS to the market's supported ISO 3166-1 alpha-2 code.

Connect your own Semrush key to use SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS. Set display_date to YYYYMM15 for monthly data or YYYYMMDD for daily data.

Check its availability in the tools table. If it runs on Instant, check that Instant Toolkits is on for your project, your session allows the action and you use the latest toolkit version.

Your Composio balance is empty. Add funds in Billing if your plan supports it, or connect your own Semrush account.

Check credential_source and instant_charge in the Composio execution log.

COMPOSIO INSTANT

Other tools on Instant

These tools also run on Composio Instant and use the same Composio balance.

Toolkit marketplace

Firecrawl

Api Key

Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.

Tavily

Api Key

Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.

Exa

Api Key

Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.

Serpapi

Api Key

SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.

Start with Semrush.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Semrush tool your agent needs.Free to start.

Start building

Semrush API

What is Composio Instant?

No Semrush account or key

Pay per call, at cost

Works in any agent

Works with your apps

Connect the Semrush API to your AI assistant

Open the Connectors menu

Add the Composio MCP server

Authorize in your browser

Paste the prompt

Install the Composio plugin

Authorize in your browser

Turn on Composio in your chat

Paste the prompt

Install the Composio plugin

Paste the prompt

Add the Composio plugin

Authenticate

Paste the prompt

Paste the setup prompt

Authorize in your browser

Paste the prompt

Use the Semrush API in your code

Set up Composio

Install the SDK

Run the call

Read the response

Available Semrush API tools

Semrush API use cases and example prompts

Build a keyword opportunity tracker

Compare backlink overlap

Plan content from keyword gaps

Prepare paid search account research

Semrush API troubleshooting

Keyword metrics are for the wrong country

An organic keyword report rejects its date

An action asks you to connect Semrush

You get HTTP 402 with Metering_WalletBalanceExhausted

You're not sure which account was charged

Other tools on Instant

Firecrawl

Tavily

Exa

Serpapi

Start with Semrush.It takes 30 seconds.