Overview

Jump to AboutAbout

It’s a group of products with SEO reports including:

• Backlink Analytics
• Keyword Gap Analysis
• Keyword Analytics

Jump to AuthenticationAuthentication

Request authentication is provided via API keys. SEO API in Version 4 requires a Version 4 API key which is assigned to each user after subscribing to Semrush.

You’ll find your API key in the API keys section of your Semrush profile. If your API key is unavailable there, refer to API access.

Jump to Response formatResponse format

SEO API report endpoints return responses in both CSV and JSON formats.

Jump to ColumnsColumns

Each Semrush SEO API method supports a set of response fields that determine the data returned in CSV and JSON responses.

For v4 methods that support the fields query parameter, you can use these field names to include only the data relevant to your analysis.

Jump to Error messagesError messages

When a request fails, the API returns a structured error response.

{
  "meta": {
    "success": false,
    "status_code": 403,
    "request_id": "a29952029c10a47e5876d86256e59455"
  },
  "error": {
    "code": 403,
    "message": "Forbidden",
    "retryable": false,
    "details": {}
  }
}

Jump to Response fieldsResponse fields

Jump to HTTP status codesHTTP status codes

Jump to Advanced filteringAdvanced filtering

Most API endpoints provide standard query parameters for filtering and sorting results.

Use the filter parameter when standard parameters are insufficient, and you need non-equality operators such as >, LIKE, or logical disjunction such as OR.

Jump to SyntaxSyntax

The filter parameter uses the following format: Field Operator Value.

?filter=volume > 500 AND (keyword CONTAINS "best" OR keyword STARTS_WITH "top")

Jump to Supported operatorsSupported operators

• Comparison: >, >=, <, <=
• Pattern: LIKE, CONTAINS, STARTS_WITH, ENDS_WITH, WORD_MATCH
• Set: IN, NOT_IN
• Logical: AND, OR
• Array: HAS, HAS_ANY, HAS_ALL

Jump to Data typesData types

• Strings: Always wrap in double quotes.
• Numbers: Use raw integers or floats.
• Booleans: true or false, case-insensitive.
• Lists or arrays: Use parentheses and separate items with commas.