> ## Documentation Index
> Fetch the complete documentation index at: https://docs.factagora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crawl

> URL을 받아 본문을 정리된 Markdown으로 돌려줍니다.

페이지를 받아 군더더기를 걷어낸 본문을 Markdown으로 돌려줍니다. 다른 API에 넣기 전에 직접 가공하고 싶을 때 씁니다.

기본으로 제목, 작성자, 발행일, 설명도 함께 반환합니다. 특정 부분만 뽑고 싶으면 `prompt`를 보내세요.

## 요청 본문

<ParamField body="url" type="string" required>
  크롤링할 URL.
</ParamField>

<ParamField body="prompt" type="string">
  추출 지시문. 이 값을 보내면 지시에 맞는 평문이 반환되고, 메타데이터 필드는 전부 `null`이 됩니다.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.factagora.com/api/v1/crawl" \
    -H "Authorization: Bearer fa_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://www.reuters.com/business/example-article"}'
  ```
</RequestExample>

## 응답

<ResponseField name="url" type="string">
  크롤링한 URL.
</ResponseField>

<ResponseField name="title" type="string">
  페이지 제목. `prompt`를 보낸 경우 `null`.
</ResponseField>

<ResponseField name="markdown" type="string">
  추출된 본문. 기본은 Markdown이고, `prompt`를 보낸 경우 지시에 맞는 평문입니다.
</ResponseField>

<ResponseField name="publishedAt" type="string">
  발행일(ISO 8601). `prompt`를 보냈거나 페이지에 발행일이 없으면 `null`.
</ResponseField>

<ResponseField name="author" type="string">
  작성자. `prompt`를 보냈거나 페이지에 작성자가 없으면 `null`.
</ResponseField>

<ResponseField name="description" type="string">
  페이지 설명. `prompt`를 보낸 경우 `null`.
</ResponseField>

<ResponseField name="fetchedAt" type="string">
  페이지를 가져온 시각(ISO 8601).
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "url": "https://www.reuters.com/business/example-article",
    "title": "ECB raises rates by 25 basis points",
    "markdown": "The European Central Bank raised interest rates by 25 basis points on Thursday...",
    "publishedAt": "2026-06-15T08:00:00Z",
    "author": "Jane Editor",
    "description": "The ECB cited persistent core inflation in the eurozone.",
    "fetchedAt": "2026-06-15T09:12:04.221Z"
  }
  ```
</ResponseExample>

## 특정 부분만 뽑기

페이지 일부만 필요하면 `prompt`를 씁니다. 메타데이터 필드는 `null`이 되고 `markdown`에 평문이 담깁니다.

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.factagora.com/api/v1/crawl" \
    -H "Authorization: Bearer fa_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://example.com/pricing",
      "prompt": "FAQ 섹션만 추출해줘."
    }'
  ```
</RequestExample>