---
title: "Read a product from its page link"
method: POST
path: "/personas/{id}/shots/product"
tags: ["Personas"]
---

# Read a product from its page link

`POST /personas/{id}/shots/product`

## Request

- Base URL: `https://api.cut.pro/api/v1`
- URL: `https://api.cut.pro/api/v1/personas/{id}/shots/product`
- Auth: API key in header `X-Api-Key`

Free. Reads a product page (most online stores, Shopee and Amazon Brazil) and returns its name, description, price and brand, and keeps up to 3 of its photos, whose ids go in `product.photo_ids` of `POST /personas/{id}/shots`. `partial` is `true` when the price or the photos did not come. `PRODUCT_NOT_READABLE` means the page could not be read (Mercado Livre and TikTok Shop never are): upload the photos with `POST /personas/{id}/shots/photos` and write the fields yourself. Up to 5 reads per minute.

## Path parameters

- `id` string, required

## Request body

- object
  - `url` string, required: Link to the product page.

## Response `200`

Response for status 200

- object
  - `product` object, required
    - `name` string, required
    - `description` string, required
    - `price` string, required
    - `brand` string, nullable, required
  - `photo_ids` string[], required
  - `partial` boolean, required

## Other responses

- `400`: Response for status 400
- `404`: Response for status 404
- `422`: Response for status 422
- `429`: Response for status 429

---

[API](https://skmtc.dev/cut/apis/cutpro-api.md) · [All operations](https://skmtc.dev/cut/apis/cutpro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cut/apis/cutpro-api/revisions/89d0bafe529c?raw)