---
title: "URL Metadata: Title, Open Graph, Canonical, Favicon, Feeds"
method: GET
path: "/v1/url-metadata"
tags: ["URL metadata"]
---

# URL Metadata: Title, Open Graph, Canonical, Favicon, Feeds

`GET /v1/url-metadata`

## Request

- Base URL: `https://api.ambolt.dev`
- URL: `https://api.ambolt.dev/v1/url-metadata`
- Auth: none required

Link-preview data for one or many public URLs: title, description, canonical URL, Open Graph and Twitter card fields, favicon, language, hreflang alternates, feed links and JSON-LD types. Respects robots.txt, refuses private addresses, no JavaScript rendering. Each page is one result; failed pages are listed with the reason and not charged.

## Query parameters

- `url` string: One public http(s) URL. Use this or urls.
- `urls` string[]: Up to 20 public http(s) URLs; every page that returns metadata is one billable result.
- `free` '1'

## Response `200`

Result (JSON). Every result names its source and the time it was read.

- object

## Other responses

- `400`: Invalid input; not charged.
- `402`: Payment required: 0.003 USD in USDC (x402 v2).

---

[API](https://skmtc.dev/ambolt/apis/ambolt-data-tools.md) · [All operations](https://skmtc.dev/ambolt/apis/ambolt-data-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/ambolt/apis/ambolt-data-tools/revisions/8397885dd82f?raw)