---
title: "List suggested keywords"
method: GET
path: "/v2/cv/keywords"
tags: ["computer_vision"]
---

# List suggested keywords

`GET /v2/cv/keywords`

This endpoint returns a list of suggested keywords for a media item that you specify or upload.

## Query parameters

- `asset_id` union, required
  - string, asset-upload-id
  - string, asset-id

## Response `200`

OK

- object — List of keywords
  - `data` string[] — Keywords
  - `errors` object[] — Error list; appears only if there was an error
    - `code` string — The error code of this error
    - `data` string — Debugging information about the error
    - `items` object[] — A list of items that produced the error
    - `message` string, required — Specific details about this error
    - `path` string — Internal code reference to the source of the error
  - `message` string — Server-generated message, if any

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `415` — Unsupported Media Type

---

[API](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer.md) · [All operations](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shutterstock/shutterstock-api-explorer/revisions/d2e03e7f655d/schema)