---
title: "API"
description: "Public HTTP API, TypeScript SDK, and OpenAPI 3.1 contract for Nuxt SEO Pro."
canonical_url: "https://nuxtseo.com/docs/nuxt-seo-pro/guides/api"
last_updated: "2026-09-23T04:45:25.814Z"
---

Nuxt SEO Pro exposes a versioned HTTP interface under `/api/v1`.

[View the OpenAPI 3.1 document](/docs/api/openapi.json) for the exact paths, request schemas, responses, scopes, and errors shipped by the current API.

Authenticate with a Team API token. Mint one under Settings, then API tokens, and send it as `Authorization: Bearer <token>`{lang="html"}:

```sh
curl -H "Authorization: Bearer nsp_your_token" \
  https://nuxtseo.com/api/v1/sites
```

`GET /api/v1/account/token` describes the credential on the request: the Team, the role, the granted scopes, and the expiry. Read it before a write call, so a missing scope surfaces before the request that needs it.

Use `@nuxtseo/sdk` when you call the API from TypeScript. It reads the executable descriptors from `@nuxtseo/protocol`, validates requests and responses, and supports browser sessions or bearer tokens through explicit transports.

Those same descriptors generate the OpenAPI file. CI checks the hosted copy and the file shipped with `@nuxtseo/protocol` byte for byte.

For terminal and script use, the [CLI](/docs/nuxt-seo-pro/guides/cli) wraps the SDK and adds exit codes.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.