# Semrush Version 3 (v3) API documentation

> Guides, API references, and tutorials for Semrush API Version 3: SEO API (Domain, Overview, URL, subdomain, and subfolder reports), Trends API, and Projects API (Position Tracking, Site Audit).

**Version 3 (v3)** is the earlier API version. Use **Version 4 (v4)** unless the required API is available only in v3 — see the [v4 documentation index](https://developer.semrush.com/api/v4/llms.txt).

## Quick start

- [Documentation home (v3)](https://developer.semrush.com/api/v3/)
- [Quick start (v3)](https://developer.semrush.com/api/v3/get-started/quick-start/)

## Authentication & access

- [API access](https://developer.semrush.com/api/v3/get-started/api-access/)
- [Authorization (v3)](https://developer.semrush.com/api/v3/get-started/authorization/)

## 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 (v3)](https://developer.semrush.com/api/v3/seo/overview/): overview of the v3 SEO API, including CSV response format, column reference, regional databases, error messages, filters, sortings, SERP features, historical data
- [Domain reports API](https://developer.semrush.com/api/v3/seo/domain-reports/): organic and paid search keywords, organic pages and subdomains, competitors in organic and paid search, ad copies, PLA keywords, copies and competitors, domain ad history, domain vs. domain
- [Overview reports API](https://developer.semrush.com/api/v3/seo/overview-reports/): domain overview by one database, all databases, and history, Semrush Rank, winners and losers
- [URL reports API](https://developer.semrush.com/api/v3/seo/url-reports/): URL overview by one database, all databases, and history, plus organic and paid search keywords for a single URL — the same reports scoped to a [subdomain](https://developer.semrush.com/api/v3/seo/subdomain-reports/) or [subfolder](https://developer.semrush.com/api/v3/seo/subfolder-reports/)

### Trends API

- [Trends API overview](https://developer.semrush.com/api/v3/trends/overview/): Basic and Premium subscription plans and their endpoint access, how to build a request, response format, FAQ
- [Trends API reference](https://developer.semrush.com/api/v3/trends/api-reference/): traffic summary, traffic rank, daily and weekly traffic, traffic sources and destinations, top pages, subdomains and subfolders, audience insights and interests, demographics (age and sex, education, income, occupation, household), geo distribution, social media, purchase conversion, industry categories, data accuracy
- [Resources (v3)](https://developer.semrush.com/api/v3/trends/resources/): valid `category` values for the Industry Categories report

### Projects API

- [Projects overview (v3)](https://developer.semrush.com/api/v3/projects/overview/): access requirements, authorization, JSON responses, error messages, how to find your project and campaign IDs
- [Position Tracking API](https://developer.semrush.com/api/v3/projects/position-tracking/): create and list campaigns, add and remove keywords, competitors and tags, organic and Ads positions, landing pages, visibility index, overview and competitor discovery reports, campaign dates, universal location search, statistics email settings
- [Site Audit API](https://developer.semrush.com/api/v3/projects/site-audit/): enable the tool, run audits, edit campaigns, campaign and snapshot details, snapshot history, page details and page ID lookup, per-issue reports and issue descriptions

### Deprecated

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

- [Keyword reports API (v3)](https://developer.semrush.com/api/v3/seo/keyword-reports/) → [Keyword reports API (v4)](https://developer.semrush.com/api/v4/seo/keyword-reports/)
- [Backlinks API (v3)](https://developer.semrush.com/api/v3/seo/backlinks/) → [Backlinks API (v4)](https://developer.semrush.com/api/v4/seo/backlinks/)
- [Project API methods (v3)](https://developer.semrush.com/api/v3/projects/projects/) → [Project API methods (v4)](https://developer.semrush.com/api/v4/projects/projects/)

## Tutorials, use cases, and examples

- [SEO API tutorial](https://developer.semrush.com/api/v3/seo/tutorials/analytics-api/)
- [Trends API tutorial](https://developer.semrush.com/api/v3/trends/tutorials/trends-api/)
- [Projects API tutorial](https://developer.semrush.com/api/v3/projects/tutorials/projects-api/)

## FAQ and troubleshooting

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