API Reference
Complete documentation for all OpenGraph.io API endpoints. Each endpoint supports authentication via App ID and offers various options for caching, rendering, and proxy usage.
Base URL
All API requests are made to:
https://opengraph.io/api/1.1/Endpoints
Site (Unfurl)
Extract OpenGraph metadata, Twitter Cards, and HTML meta tags from any URL.
Scrape
Fetch raw HTML from any website with JavaScript rendering and proxy support.
Screenshot
Capture high-quality screenshots of any webpage programmatically.
Extract
Extract specific HTML elements in a structured format for AI/LLM pipelines.
Query
Ask questions about any webpage and get structured answers powered by AI.
oEmbed
Get embeddable representations of URLs following the oEmbed specification.
Common Parameters
These parameters work across most endpoints:
| Parameter | Type | Description |
|---|---|---|
| app_id | string | Required. Your API key from the dashboard. |
| cache_ok | boolean | Allow cached results. Default: true |
| max_cache_age | number | Maximum cache age in seconds. |
| full_render | boolean | Enable JavaScript rendering. Default: false |
| use_proxy | boolean | Use standard proxy. Default: false |
| use_premium | boolean | Use residential proxy. Default: false |
| use_superior | boolean | Use mobile proxy. Default: false |
| accept_lang | string | Preferred language header (e.g., "en-US") |
Authentication
All requests require an app_id parameter. Get your free API key at dashboard.opengraph.io.
See the Authentication guide for details.
URL Encoding
Important: URLs passed in the path must be URL-encoded. For example, https://github.com becomes https%3A%2F%2Fgithub.com.
See the URL Encoding guide for language-specific examples.
Rate Limits
| Plan | Concurrent Requests |
|---|---|
| Free | 1 |
| Developer | 5 |
| Production | 25 |
| Enterprise | 100 |
See Rate Limits for more details.
MCP Integration
All API endpoints are also available through the OpenGraph MCP Server for AI assistants like Claude, Cursor, and VS Code.