---
title: "Embed URL content"
method: POST
path: "/ai/embeddings/url"
tags: ["Embeddings"]
---

# Embed URL content

`POST /ai/embeddings/url`

Embed website content from a specified URL, including child pages up to 5 levels deep within the same domain. The process crawls and loads content from the main URL and its linked pages into a Telnyx Cloud Storage bucket. As soon as each webpage is added to the bucket, its content is immediately processed for embeddings, that can be used for [similarity search](https://developers.telnyx.com/api-reference/embeddings/search-for-documents) and [clustering](https://developers.telnyx.com/docs/inference/clusters).

## Request body

- EmbeddingUrlRequest
  - `url` string, required — The URL of the webpage to embed
  - `bucket_name` string, required — Name of the bucket to store the embeddings. This bucket must already exist.

## Response `200`

Successful Response

- EmbeddingResponse
  - `data` object, required
    - `task_id` string, uuid
    - `task_name` string
    - `status` string
    - `created_at` string
    - `finished_at` string, nullable
    - `user_id` string, uuid

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/versions/8f5f4e537994/schema)