---
title: "Learn From Url"
method: POST
path: "/api/products/{product_id}/learn-url"
tags: ["Products"]
---

# Learn From Url

`POST /api/products/{product_id}/learn-url`

## Request

- Base URL: `https://api.soeru.biz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.soeru.biz/api/products/{product_id}/learn-url`
- Auth: none declared. Required headers: `authorization`

商品ページURLを取得し raw_data に格納する (PL-P7: 取り込みのみ・cost0)。

事実抽出は BYO-AI (MCP) が行うため soeru は LLM を呼ばない。よって月間 quota は撤去
(取得は API/HTTP だけで安価)。取得後は learning_status='pending' になり、商品お手入れ
カード / compose_message のインライン学習で店主の AI が学ぶ。

## Path parameters

- `product_id` string, required

## Headers

- `x-shop-id` string, nullable: Optional shop ID
- `authorization` string, required: Bearer <token>

## Request body

- URLLearnRequest: Request to learn product knowledge from a URL.
  - `url` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/soeru/apis/soeru-api.md) · [All operations](https://skmtc.dev/soeru/apis/soeru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/soeru/apis/soeru-api/revisions/63f8d371abed?raw)