Pricing

from $1.94 / 1,000 link previews

Try for free

Go to Apify Store

Link Preview API — Bulk OpenGraph & Metadata Unfurl

Try for free

High-volume link previews: OpenGraph, Twitter Cards, JSON-LD, titles, images, favicons, canonicals, authors, dates, language and feeds. No fixed run timeout, browser or third-party API key.

Pricing

from $1.94 / 1,000 link previews

Rating

0.0

(0)

Developer

Technical Dost Solutions

Actor stats

Bookmarked

Total users

Monthly active users

a day ago

Last modified

Categories

Developer tools

Automation

SEO tools

You can access the Link Preview API — Bulk OpenGraph & Metadata Unfurl programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.2",
    "x-build-id": "HBoDDRtJvfkLlJxvt"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/technicaldost~link-preview-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-technicaldost-link-preview-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/technicaldost~link-preview-api/runs": {
      "post": {
        "operationId": "runs-sync-technicaldost-link-preview-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/technicaldost~link-preview-api/run-sync": {
      "post": {
        "operationId": "run-sync-technicaldost-link-preview-api",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "urls"
        ],
        "properties": {
          "urls": {
            "title": "URLs",
            "type": "array",
            "description": "List of page URLs to unfurl into link-preview metadata.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max URLs",
            "minimum": 0,
            "type": "integer",
            "description": "Optional safety cap. Use 0 to process every supplied URL; the Actor has no arbitrary batch-size cap.",
            "default": 0
          },
          "maxConcurrency": {
            "title": "Concurrent requests",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "Number of URLs fetched in parallel. Increase for fast sites; lower it when targets rate-limit requests.",
            "default": 10
          },
          "requestTimeoutSecs": {
            "title": "Per-URL timeout (seconds)",
            "minimum": 3,
            "maximum": 120,
            "type": "integer",
            "description": "Maximum time for each HTTP request, including response download. This is not an overall run timeout.",
            "default": 20
          },
          "maxRetries": {
            "title": "Retries",
            "minimum": 0,
            "maximum": 3,
            "type": "integer",
            "description": "Retries for timeouts, rate limits, and temporary server errors.",
            "default": 1
          },
          "includeJsonLd": {
            "title": "Include JSON-LD",
            "type": "boolean",
            "description": "Include parsed schema.org JSON-LD blocks and detected schema types.",
            "default": true
          },
          "includeRawTags": {
            "title": "Include all raw meta tags",
            "type": "boolean",
            "description": "Include a normalized metaTags object. Leave off for smaller datasets.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Link Preview API — Bulk OpenGraph & Metadata Unfurl OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Link Preview API — Bulk OpenGraph & Metadata Unfurl from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Link Preview API — Bulk OpenGraph & Metadata Unfurl API in Python

Link Preview API — Bulk OpenGraph & Metadata Unfurl API in JavaScript

Link Preview API — Bulk OpenGraph & Metadata Unfurl API through CLI

Link Preview API — Bulk OpenGraph & Metadata Unfurl API

Metadata & JSON-LD Scraper — OpenGraph, Twitter Cards, SEO

nizantei/schema-extractor-actor

Scrape SEO metadata at scale: JSON-LD structured data, OpenGraph tags, Twitter Cards, titles and descriptions from any list of URLs. One clean JSON record per page.

Nitsan Teichholtz

OpenGraph & Link Preview Scraper

receptional_blender/opengraph-link-preview-scraper

Give it any list of URLs and get back the link-preview metadata each page exposes — OpenGraph and Twitter Card tags, title, description, preview image, favicon, canonical URL, site name and type — as clean JSON. Perfect for building rich link previews. No login required.

Assia Fadli

Structured Data Extractor - JSON-LD, OpenGraph, Meta

piposlab/structured-data-extractor

Extract JSON-LD, OpenGraph, Twitter cards, microdata and meta tags from any URL. For SEO audits, AI dataset building and competitor research. No API key.

Alejandro Bufarini

Webpage Metadata Extractor - OpenGraph, Twitter Cards, JSON-LD

eliai/webpage-metadata-extractor

Extract webpage metadata from any URL. Input a URL, get one JSON record with the page title, meta tags, OpenGraph, Twitter Card, and JSON-LD structured data. $0.02 per page analyzed — for link previews, SEO checks, and AI agent pipelines.

Broke to Built

Website SEO & Metadata Checker — Meta, OpenGraph, JSON-LD

dataquarry/website-seo-metadata-checker

Free SEO & metadata audit for any URL: title, meta description, OpenGraph, Twitter card, JSON-LD types, canonical, hreflang, viewport, robots, and link/image checks. No API key.

Daniel Brenner

Link Preview & OpenGraph Metadata Extractor

thoob/url-metadata-extractor

Reads a page's own public head tags, OpenGraph, Twitter card, title, description, canonical, favicon, and language, for clean link previews and RAG ingestion. Respects robots.txt by default. Billed only per URL successfully read.

Pono Data

OpenGraph & Social Preview Scraper

andok/opengraph-inspector

Extract OpenGraph tags and Twitter Cards to ensure your content looks perfect when shared on social media.

Andok

URL Meta Card Generator — OpenGraph & Twitter Cards

wsgcjj/url-meta-card-generator

Extract OpenGraph, Twitter Card, and standard HTML meta tags from any URL. Get title, description, image, favicon, author, and site name. Batch-process up to 100 URLs per run. Perfect for link previews, social media cards, SEO audits, and content aggregation.

陈俊杰

URL Metadata — OpenGraph, Twitter Card & Favicon

omao/url-metadata

Get clean link-preview metadata for any URL: title, description, OpenGraph image, site name, canonical URL, favicon, Twitter Card and more. Fast, no setup.

Marouane Oulabass

Link Preview & Metadata Extractor

weeknds/link-preview-metadata-extractor

Extract Open Graph, Twitter Cards, meta descriptions, favicons, and all metadata from any URL. Structured link previews with canonical URLs, language detection, HTTP status codes. Pure HTTP, no browser needed. Perfect for SEO audits and content aggregators.