---
title: "List URL Content Versions"
method: POST
path: "/sources/urls/content/versions"
tags: ["Reports"]
---

# List URL Content Versions

`POST /sources/urls/content/versions`

## Request

- Base URL: `https://api.peec.ai/customer/v1`
- URL: `https://api.peec.ai/customer/v1/sources/urls/content/versions`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `api_key`
  - HTTP bearer

List the stored content versions of a source URL. Peec re-scrapes a URL when it is cited again and its last scrape is several days old, so how many versions a URL has varies, and history starts in July 2026.

## Query parameters

- `project_id` string: Required if using a company api key

## Request body

- object
  - `project_id` string: Required if using a company api key
  - `url` string, uri, required: Full URL of a source, as returned by the URLs report or Get URL Content.
  - `limit` integer
  - `offset` integer

## Response `200`

Success

- object: Success
  - `data` object, required
    - `versions` object[], required: Stored content versions, newest first. A new version is stored only when a re-scrape finds changed content.
      - `version` integer, required: Version number. Higher is newer. Pass it to Get URL Content or Get URL Content Diff.
      - `scraped_at` string, required: ISO timestamp of the scrape that produced it.
    - `total_count` integer, required: Number of stored versions for the URL.

## Other responses

- `404`: Response for status 404

## Changes

- **2026-11-03** `9fdffdff48a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/peec/apis/peec-ai-customer-api/changes/sources/urls/content/versions/post.md)

---

[API](https://skmtc.dev/peec/apis/peec-ai-customer-api.md) - [All operations](https://skmtc.dev/peec/apis/peec-ai-customer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/peec/apis/peec-ai-customer-api/revisions/9d774600c8eb?raw)