URL Metadata

Extract Open Graph tags, title, description, and favicon from any URL.

GET/v1/meta

Fetches a URL and extracts metadata including Open Graph tags, Twitter Card tags, page title, description, favicon, and more. Useful for building link previews, social cards, and content aggregators.

Authentication

Requires x-api-key header.

Parameters

Name	Type	Required	Default	Description
url	string	Yes	-	The URL to extract metadata from.
follow_redirects	boolean	No	true	Whether to follow HTTP redirects.
timeout	integer	No	10000	Request timeout in milliseconds (1000-30000).

Example Request

-blue-400 font-semibold">curl -X GET -emerald--amber-400">400">"https://api.aicores.io/v1/meta?url=https://github.com" \
  -H -emerald--amber-400">400">"x-api-key: sk_live_your_key_here"

Example Response

{
  400">"url": 400">"https://github.com",
  400">"title": 400">"GitHub: Let's build from here",
  400">"description": 400">"GitHub is where over 100 million developers shape the future of software.",
  400">"favicon": 400">"https://github.githubassets.com/favicons/favicon.svg",
  400">"og": {
    400">"title": 400">"GitHub: Let's build from here",
    400">"description": 400">"GitHub is where over 100 million developers shape the future of software.",
    400">"image": 400">"https://github.githubassets.com/assets/campaign-social.png",
    400">"url": 400">"https://github.com",
    400">"type": 400">"website",
    400">"site_name": 400">"GitHub"
  },
  400">"twitter": {
    400">"card": 400">"summary_large_image",
    400">"site": 400">"@github",
    400">"title": 400">"GitHub: Let's build from here",
    400">"description": 400">"GitHub is where over 100 million developers shape the future of software.",
    400">"image": 400">"https://github.githubassets.com/assets/campaign-social.png"
  },
  400">"charset": 400">"utf-8",
  400">"language": 400">"en"
}

Error Codes

Status	Error	Description
400	invalid_url	The URL is missing, malformed, or uses an unsupported protocol.
401	unauthorized	Missing or invalid API key.
408	timeout	The URL did not respond within the timeout period.
422	unreachable	The URL could not be reached (DNS failure, connection refused).
429	rate_limit_exceeded	Too many requests.