# Semrush Version 4 (v4) API documentation

> Guides, API references, tutorials, and release notes for Semrush API Version 4: SEO API (Backlinks, Keyword reports), Projects API (folder management), and Local API (Listing Management, Map Rank Tracker).

**Version 4 (v4)** is recommended for new integrations. For Version 3 (v3), see the [v3 documentation index](https://developer.semrush.com/api/v3/llms.txt).

## Quick start

- [Documentation home (v4)](https://developer.semrush.com/api/v4/)
- [Quick start (v4)](https://developer.semrush.com/api/v4/get-started/quick-start/)
- [API overview](https://developer.semrush.com/api/v4/introduction/semrush-api-overview/)
- [API versions](https://developer.semrush.com/api/v4/introduction/api-versions/)
- [Glossary](https://developer.semrush.com/api/v4/introduction/glossary/): definitions of API unit, API request and request parameter, endpoint, HTTP method, line, response, and status code
- [Release notes](https://developer.semrush.com/api/v4/introduction/release-notes/): dated entries announcing new API versions, keys, and endpoints, plus deprecation notices

## Authentication & access

- [API access](https://developer.semrush.com/api/v4/get-started/api-access/)
- [Authorization (v4)](https://developer.semrush.com/api/v4/get-started/authorization/) – API keys, permissions, TTL, OAuth
- [API unit balance](https://developer.semrush.com/api/v4/get-started/api-units-balance/)
- [API usage restrictions](https://developer.semrush.com/api/v4/introduction/api-usage-restrictions/)
- [Available data](https://developer.semrush.com/api/v4/introduction/available-data/)

## API guides and reference

Every method page includes a copyable request example, the full parameter list, the API unit cost, and a response sample.

### SEO API

- [SEO API overview (v4)](https://developer.semrush.com/api/v4/seo/overview/): overview of the v4 SEO API, including CSV and JSON response formats, authentication, column reference, error messages and HTTP status codes, filtering
- [Backlinks API (v4)](https://developer.semrush.com/api/v4/seo/backlinks/): backlinks, referring domains and IPs, indexed pages, anchors, authority score, competitors, domain comparison
- [Keyword reports API (v4)](https://developer.semrush.com/api/v4/seo/keyword-reports/): search volume, keyword difficulty, CPC, competitive density, search intent, SERP features, 12-month trend

### Projects API

- [Projects overview (v4)](https://developer.semrush.com/api/v4/projects/overview/): access requirements, authorization, JSON response structure, error messages, how to find your project ID
- [Project API methods (v4)](https://developer.semrush.com/api/v4/projects/projects/): create, get, list, update, and delete projects

### Local API

- [Local API overview](https://developer.semrush.com/api/v4/local/overview/): access and authorization per API (API key or OAuth 2.0), JSON response format, status codes, error responses
- [Listing Management API](https://developer.semrush.com/api/v4/local/listing-management/): create, get, update, and delete locations, manage images, enable and disable listings, get listings, categories, payment options, and hour types
- [Map Rank Tracker API](https://developer.semrush.com/api/v4/local/map-rank-tracker/): create, update, and delete campaigns, collect data, metrics, heatmap, keyword statuses, top competitors, user limits (OAuth 2.0)
- [Resources (v4)](https://developer.semrush.com/api/v4/local/resources/): Location object and other request and response object schemas

### Deprecated

Still operational, but not recommended for new integrations. Use the replacement listed for each.

- [Projects API (OAuth 2.0)](https://developer.semrush.com/api/v4/deprecated/projects-oauth/projects/) → [Project API methods (v4)](https://developer.semrush.com/api/v4/projects/projects/) with API key authorization
- [Listing Management API (deprecated)](https://developer.semrush.com/api/v4/deprecated/local/listing-management/) → [Listing Management API](https://developer.semrush.com/api/v4/local/listing-management/); see the [migration guide](https://developer.semrush.com/api/v4/local/tutorials/listing-management-api/#migrate-from-deprecated-listing-management-api)

## Tutorials, use cases, and examples

- [Use cases (v4)](https://developer.semrush.com/api/v4/introduction/use-cases/): SEO/PPC ROI, competitive analysis, market growth, local presence
- [Listing Management API tutorial](https://developer.semrush.com/api/v4/local/tutorials/listing-management-api/)

## FAQ and troubleshooting

- [Semrush API overview FAQ](https://developer.semrush.com/api/v4/introduction/semrush-api-overview/#faq)
- [Available data FAQ](https://developer.semrush.com/api/v4/introduction/available-data/#faq)
- [API usage restrictions FAQ](https://developer.semrush.com/api/v4/introduction/api-usage-restrictions/#faq)
- [API access FAQ](https://developer.semrush.com/api/v4/get-started/api-access/#faq)
- [API unit balance FAQ](https://developer.semrush.com/api/v4/get-started/api-units-balance/#faq)
- [SEO API FAQ (v4)](https://developer.semrush.com/api/v4/seo/overview/#faq)
- [Local API FAQ](https://developer.semrush.com/api/v4/local/overview/#faq)
- [Troubleshooting](https://developer.semrush.com/api/v4/get-started/troubleshooting/): error codes and their causes