Projects

Jump to ProjectsListProjectsList

This request allows you to get a list of all projects.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/projects/v0
Response exampleJSON
{
  "projects": [
    {
      "url": "mysite.com",
      "domain_unicode": "mysite.com",
      "tools": [
        
      ],
      "project_id": 643526670,
      "project_name": "myproject",
      "owner_id": 123456780,
      "permission": [
        "OWNER"
      ]
    }
  ]
}

Jump to GetProjectGetProject

This request allows you to get information regarding a project.

Jump to EndpointEndpoint

GEThttps://api.semrush.com/apis/v4/projects/v0/:project_id

Request Parameters

project_idRequired

An automatically generated unique identifier for the project. Learn how to get your project ID ›

Value/Type: uint64

Request example
project_id=643526670283248
Response exampleJSON
{
  "url": "mysite.com",
  "domain_unicode": "mysite.com",
  "tools": [
    {
      "tool": "tracking"
    }
  ],
  "project_id": 643526670283248,
  "project_name": "myproject",
  "owner_id": 123456780,
  "permission": [
    "OWNER"
  ]
}

Jump to CreateProjectCreateProject

This request allows you to create a new project, which includes naming the project and choosing a domain.

Jump to EndpointEndpoint

POSThttps://api.semrush.com/apis/v4/projects/v0

Request Parameters

project_name

The name the project will have. Cannot contain the following special symbols: ~`!#%’^&*=[]\/|”:<>?

Value/Type: string

url

The domain the project will be set up for.

Value/Type: string

Request example
{"project_name":"","url":""}
Response exampleJSON
{
  "url": "mysite.com",
  "domain_unicode": "mysite.com",
  "tools": [
    
  ],
  "project_id": 643526670283248,
  "project_name": "myproject",
  "owner_id": 123456780,
  "permission": [
    "OWNER"
  ]
}

Jump to UpdateProjectUpdateProject

This request allows you to update or change a project’s name.

Jump to EndpointEndpoint

PUThttps://api.semrush.com/apis/v4/projects/v0

Request Parameters

project_idRequired

An automatically generated unique identifier for the project. Learn how to get your project ID ›

Value/Type: uint64

project_nameRequired

The new project name. Cannot contain the following special symbols: ~`!#%'^&*=[]\/{}|":<>?

Value/Type: string

tools

This field is used for backward compatibility. Сan be ignored.

Value/Type: object

Request example
{"project_id":643526670283248,"project_name":"myproject"}
Response exampleJSON
{
  "url": "mysite.com",
  "domain_unicode": "mysite.com",
  "tools": [
    {
      "tool": "tracking"
    }
  ],
  "project_id": 643526670283248,
  "project_name": "myproject",
  "owner_id": 123456780,
  "permission": [
    "OWNER"
  ]
}

Jump to RemoveProjectRemoveProject

This request allows you to delete a project from your user account.

Jump to EndpointEndpoint

DELETEhttps://api.semrush.com/apis/v4/projects/v0/:project_id

Request Parameters

project_idRequired

An automatically generated unique identifier for the project. Learn how to get your project ID ›

Value/Type: uint64

Request example
project_id=0
Response exampleJSON
{
  "result": true
}

Last updated: January 26, 2026

Was this page helpful?