# Authenticate with an API key

> Base URL, Bearer-token and query-parameter authentication for the ShopSavvy Data API, where to create keys, and where to find the OpenAPI spec.

*Source: https://shopsavvy.com/data/documentation/authentication* · Part of the [ShopSavvy Data API documentation](https://shopsavvy.com/data/documentation.md)

---

- First you'll need to [subscribe to one of our plans](https://shopsavvy.com/data#pricing).
- Once you've subscribed, you'll be redirected to your [Data API Dashboard](https://shopsavvy.com/data/dashboard).
- Go to [API Keys](https://shopsavvy.com/data/api-keys) to create and manage your API keys.
- Use your API keys to authenticate with the API.

**Base URL:** `https://api.shopsavvy.com/v1`

**Authentication:** Include your API key in the `Authorization` header as a Bearer token, or as an `api_key` query parameter.

**Authentication Examples:**

**Header (Recommended):**
```
Authorization: Bearer ss_live_abc123...
```

**Query Parameter:**
```
GET /v1/products?ids=123&api_key=ss_live_abc123...
```

That's it. You're now ready to start requesting data from the API. The [Quick Start Guide](https://shopsavvy.com/data/documentation/quickstart) walks through a first request.

**OpenAPI spec:** the full API description is at [`https://api.shopsavvy.com/v1/openapi.json`](https://api.shopsavvy.com/v1/openapi.json) (OpenAPI 3.0). Import it into Postman, Insomnia or a client generator. See [OpenAPI Specification](https://shopsavvy.com/data/documentation/openapi).