---
title: "Returns the content of the web pages"
method: POST
path: "/v1/contents"
---

# Returns the content of the web pages

`POST /v1/contents`

Returns the HTML or Markdown of a target webpage.

## Request body

- object
  - `urls` string[] — Array of URLs to fetch the contents from.
  - `formats` string[] — Array of content formats to return. All included formats are returned in the response. Include "metadata" to get JSON-LD and OpenGraph information, if available.
  - `crawl_timeout` integer — Maximum time in seconds to wait for page content. Must be between 1 and 60 seconds. Default is 10 seconds.
  - `max_age` integer, nullable — Maximum allowed age of cached content in seconds. When set, cached content older than this threshold is ignored and the page is re-fetched. Must be 0 or greater. Default is null (no age limit, cached content is returned regardless of age).

## Response `200`

An array of JSON objects containing the page content of each web page

- object[]
  - `url` string, uri — The webpage URL whose content has been fetched.
  - `title` string — The title of the web page.
  - `html` string, nullable — The retrieved HTML content of the web page.
  - `markdown` string, nullable — The retrieved Markdown content of the web page.
  - `metadata` ContentsMetadata, nullable — Metadata about the web page. Only returned when 'metadata' is included in the formats array.
    - `site_name` string, nullable — The OpenGraph site name of the web page.
    - `favicon_url` string — The URL of the favicon of the web page's domain.

## Other responses

- `401` — Unauthorized. Problems with API key.
- `403` — Forbidden. API key lacks scope for this path.
- `500` — Internal Server Error during authentication/authorization middleware.

## Changes

- **2026-07-31** `6dc77679480a` — 1 info
  - added the new optional request property `max_age`

[Change history](https://skmtc.dev/you/apis/you-com-contents-api/changes/v1/contents/post.md)

---

[API](https://skmtc.dev/you/apis/you-com-contents-api.md) · [All operations](https://skmtc.dev/you/apis/you-com-contents-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/you/you-com-contents-api/revisions/62c62fde85ba/schema)