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

# Read URL

> POST /v1/search/url — Fetch and extract content from a URL.

<ParamField body="url" type="string" required>
  URL to read
</ParamField>

<ParamField body="extract" type="string">
  Optional question to answer from the content (AI-powered extraction)
</ParamField>

<RequestExample>
  ```bash theme={"theme":"css-variables"}
  curl -X POST https://api.usenaive.ai/v1/search/url \
    -H "Authorization: Bearer nv_sk_live_..." \
    -H "Content-Type: application/json" \
    -d '{
      "url": "https://example.com/article",
      "extract": "What are the main points?"
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":"css-variables"}
  {
    "url": "https://example.com/article",
    "title": "",
    "content": "Extracted text content...",
    "extracted": "The main points are: 1) ...",
    "credits_used": 0.05,
    "credits_remaining": 989.95
  }
  ```
</ResponseExample>

<Info>
  The `title` field may be empty — title extraction depends on the provider. The `extracted` field only appears when an `extract` question is provided and AI extraction is configured.
</Info>

**Cost:** 0.05 credits