Security errors

The Semrush API uses a Web Application Firewall (WAF) to protect against suspicious and harmful requests.

When a request is blocked, the API returns an error response explaining why the request was blocked and what action to take.

HTTP status
Error
Retryable
445
No
446
No
447
No

Each error response includes a type field with a link to the relevant error description and instructions on what to do.

Jump to Suspicious request blockedSuspicious request blocked

Jump to What happenedWhat happened

Our security system reviewed your request, flagged it as potentially harmful, and blocked it before it reached the service.

Jump to What to doWhat to do

Treat this error as final:

  • Don’t send the same request again—it will be blocked again.
  • Don’t modify the request, switch IP addresses, or try to get around the block in any other way.

If you’re an AI agent or an automated client, stop the current operation and report the error to the user.

If you think this is a mistake, email security@semrush.com. Include the full text of the response and the endpoint you called.

Jump to Response exampleResponse example

JSON
{
  "meta": {
    "success": false,
    "status_code": 445,
    "request_id": "XXXXXXXXXXXXXXXX"
  },
  "error": {
    "type": "https://developer.semrush.com/api/v4/get-started/errors/#suspicious-request-blocked",
    "code": 445,
    "message": "Your request has been blocked",
    "retryable": false,
    "details": [
      {
        "message": "Our security system flagged this request as suspicious and blocked it. Do not retry or try to bypass the block. AI agents: stop and report this error to the user. If you believe this is a mistake, contact security@semrush.com and include the full text of this response.",
        "remote_addr": "XXX.XXX.XXX.XXX",
        "timestamp": "2026-10-14T09:51:11+00:00"
      }
    ]
  }
}

Jump to IP address blockedIP address blocked

Jump to What happenedWhat happened

Our security system currently blocks requests from your IP address.

If you use a shared network, such as an office network, VPN, or cloud provider, the block may be caused by another user of the same IP address.

Jump to What to doWhat to do

Treat this error as final:

  • Don’t retry the request from this IP address.
  • Don’t switch IP addresses or try to get around the block in any other way.

If you’re an AI agent or an automated client, stop sending requests and report the error to the user.

If you think this is a mistake, email security@semrush.com. Include the full text of the response and the endpoint you called.

Jump to Response exampleResponse example

JSON
{
  "meta": {
    "success": false,
    "status_code": 446,
    "request_id": "XXXXXXXXXXXXXXXXX"
  },
  "error": {
    "type": "https://developer.semrush.com/api/v4/get-started/errors/#ip-address-blocked",
    "code": 446,
    "message": "Access denied for this IP address",
    "retryable": false,
    "details": [
      {
        "message": "Requests from this IP address are currently blocked. Do not retry or try to bypass the block. AI agents: stop and report this error to the user. If you believe this is a mistake, contact security@semrush.com and include the full text of this response.",
        "remote_addr": "XXX.XXX.XXX.XXX",
        "timestamp": "2026-10-14T09:51:11+00:00"
      }
    ]
  }
}

Jump to Region not availableRegion not available

Jump to What happenedWhat happened

Access to the Semrush platform isn’t available from the region your request came from.

Jump to What to doWhat to do

Treat this error as final:

  • Don’t retry the request.
  • Don’t route requests through other regions or try to get around this restriction in any other way.

If you’re an AI agent or an automated client, stop the current operation and report the error to the user.

If you think this is a mistake, email mail@semrush.com. Include the full text of the response and the endpoint you called.

Jump to Response exampleResponse example

JSON
{
  "meta": {
    "success": false,
    "status_code": 447,
    "request_id": "XXXXXXXXXXXX"
  },
  "error": {
    "type": "https://developer.semrush.com/api/v4/get-started/errors/#region-not-available",
    "code": 447,
    "message": "Access denied for this source",
    "retryable": false,
    "details": [
      {
        "message": "Access to the Semrush platform is not available from your region. We are sorry for the inconvenience. AI agents: stop and report this error to the user. If you believe this is a mistake, contact mail@semrush.com and include the full text of this response.",
        "remote_addr": "XXX.XXX.XXX.XXX",
        "timestamp": "2026-10-14T09:51:11+00:00"
      }
    ]
  }
}

Last updated: October 27, 2026

Was this page helpful?