---
title: "Executes a query and returns a paginated response"
method: POST
path: "/analyses/{username}/{project_slug}/{analysis_slug}/urls"
tags: ["Analysis"]
---

# Executes a query and returns a paginated response

`POST /analyses/{username}/{project_slug}/{analysis_slug}/urls`

Executes a query and returns a paginated response

## Query parameters

- `area` 'current' | 'disappeared' | 'new' | 'search_engines_orphans'
- `page` integer
- `size` integer

## Request body

- UrlsQuery
  - `fields` string[]
  - `filters` object
  - `sort` object[]

## Response `200`

Successful operation

- object
  - `count` integer
  - `results` UrlDetail[]
  - `next` string
  - `previous` string
  - `page` integer
  - `size` integer

## Other responses

- `default` — error payload

## Changes

- **2026-07-13** `babe177600aa` — 1 breaking, 1 info
  - removed the success response with the status `201`
  - added the success response with the status `200`
- **2016-01-11** `62465db12f9c` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `201`

[Change history](https://skmtc.dev/botify-labs/apis/botify-api/changes/analyses/:username/:project_slug/:analysis_slug/urls/post.md)

---

[API](https://skmtc.dev/botify-labs/apis/botify-api.md) · [All operations](https://skmtc.dev/botify-labs/apis/botify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/botify-labs/botify-api/revisions/babe177600aa/schema)