---
title: "Fetch a URL and extract all metadata (SEO research)"
method: POST
path: "/url-metadata.php"
tags: ["data"]
---

# Fetch a URL and extract all metadata (SEO research)

`POST /url-metadata.php`

## Request

- Base URL: `https://mate.tools/api/v1`
- URL: `https://mate.tools/api/v1/url-metadata.php`
- Auth: none declared

Fetches a URL over HTTPS and extracts: title, description, keywords, author, language, charset, canonical URL, OpenGraph tags, Twitter Card tags, hreflang alternates, JSON-LD structured data, favicon, response headers (server, cache-control, etag), and element counts. SSRF-protected: refuses private, loopback, link-local and cloud-metadata IPs across DNS and every redirect hop. Designed for SEO research, link-preview generation, and competitor analysis agents.

## Request body

- object
  - `url` string, required

## Response `200`

Success

## Other responses

- `400`: Malformed request
- `429`: Rate limit exceeded (60/min, 600/hour per IP). Includes Retry-After header.
- `502`: Fetch failed

---

[API](https://skmtc.dev/mate/apis/mate-tools-api.md) · [All operations](https://skmtc.dev/mate/apis/mate-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mate/apis/mate-tools-api/revisions/874670b78962?raw)