---
title: "Index a list of URLs into AskNews"
method: POST
path: "/v1/news/index_urls"
tags: ["index_urls"]
---

# Index a list of URLs into AskNews

`POST /v1/news/index_urls`

Index a list of news article URLs.

## Request body

- URLIndexingRequest
  - `start_time` string, date-time, required
  - `end_time` string, date-time, required
  - `urls` ScrapedURLItem[], required
    - `url` string, required
    - `data` ScrapeDataItem
      - `scrapes` ScrapeItem[], required
        - `user_agent` string, required
        - `count` integer, required
      - `referrals` ReferralItem[], required
        - `site` string, required
        - `count` integer, required
    - `skip_dedupe` boolean
    - `metadata` object, nullable
    - `enrichments` object, nullable

## Response `200`

Job ID and status

- IndexUrlsResponse
  - `status` string, required
  - `job_id` string, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `405` — Method Not Allowed
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

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