---
title: "Data extraction"
method: POST
path: "/extract"
tags: ["extract"]
---

# Data extraction

`POST /extract`

Performs data extraction using LLM based on the specified data source, filter conditions, and JSON schema.
Retrieves chunked data and uses the schema to extract and return the result as JSON via LLM.

## Request body

- ExtractRequest
  - `tags` string[]
  - `tag_ids` string[]
  - `source_types` SourceType[]
  - `file_types` FileType[]
  - `date_from` integer — Start date for content search (Unix timestamp in seconds)
  - `date_to` integer — End date for content search (Unix timestamp in seconds)
  - `domains` string[]
  - `limit` integer
  - `offset` integer
  - `schema` object, required — JSON Schema for the data to be extracted.
  - `prompt` string — Additional prompt for the LLM (optional, if not specified, a default prompt in Japanese will be used).

## Response `200`

Successful extraction

- Extract200Response
  - `created` integer, required — 抽出実行時刻（Unix timestamp）
  - `result` ExtractResult, required — Extraction result as a JSON object conforming to the provided schema.

## Other responses

- `400` — Bad Request - The request was malformed or invalid
- `401` — Unauthorized - Authentication failed
- `403` — Forbidden - Insufficient permissions
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal Server Error

## Changes

- **2025-10-10** `0feb3dbefc85` — 1 breaking
  - removed the required property `id` from the response with the `200` status

[Change history](https://skmtc.dev/qlonolink/apis/qaip-apis/changes/extract/post.md)

---

[API](https://skmtc.dev/qlonolink/apis/qaip-apis.md) · [All operations](https://skmtc.dev/qlonolink/apis/qaip-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qlonolink/qaip-apis/revisions/0feb3dbefc85/schema)