# Social Preview Checker (`zinin/social-preview-checker`) Actor See exactly how your links look when shared on Telegram, WhatsApp, X, LinkedIn, Slack, Facebook & Discord. Bulk-audit Open Graph and Twitter Card tags, validate preview images, and find what breaks your link previews. - **URL**: https://apify.com/zinin/social-preview-checker.md - **Developed by:** [Tim Zinin](https://apify.com/zinin) (community) - **Categories:** SEO tools, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 page checkeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Social Preview Checker — Open Graph & Twitter Card Audit See exactly how a link will look before it goes out. Point this Actor at a list of URLs and get back the headline, description and image each platform pulls when the link is shared on Telegram, WhatsApp, X, LinkedIn, Slack, Facebook and Discord, plus a 0–100 share score and a plain-English list of what's broken. Pure HTML-head parsing — no browser, no login. ### What you get - **Preview likely to render** — the exact headline, text and image any platform will pull, with the Open Graph → Twitter Card → `` fallback chain already resolved. - **Open Graph tags** — `og:title`, `og:description`, `og:image`, `og:url`, `og:type`, `og:site_name`. - **Twitter Card tags** — `twitter:card`, `twitter:title`, `twitter:description`, `twitter:image`. - **Image reachability check** — a live HEAD/GET request confirming the preview image actually loads, with its content type and size. - **Share score (0–100)** across 7 checks: title, description, image, image reachable, Twitter card, site name, favicon. - **Issues list** — concrete problems such as *"og:image is not HTTPS — many platforms silently drop non-HTTPS images"* or *"og:title is 84 chars — may be truncated"*. - Runs on Apify: schedule it, monitor it, call it from the API, export to JSON/CSV/Excel or push straight into your own pipeline. ### Who is this for - **Marketers & content teams** — verify every landing page and blog post renders a real preview card before spending budget driving traffic to it - **SEO & growth teams** — bulk-audit a whole sitemap for missing or broken Open Graph tags - **Agencies** — catch a client site shipping with a blank or broken share card, in a client-facing audit - **Devs & QA** — regression-test Open Graph / Twitter Card tags after a CMS migration or redesign ### How to run it 1. Click **Try for free** — no card needed on the free plan. 2. Paste your pages into **URLs**, one per line — `example.com/article` or a full `https://` URL both work. 3. Press **Start**. Results land in the dataset — read them in the UI, pull them from the API, or have a webhook push them onward. ### Pricing Pay-per-event: **$0.005 per run start + $0.004 per result**. No monthly seat, no minimum. 100 URLs cost about **$0.41**; 1,000 URLs about **$4.01**. A URL that could not be checked is still returned, with `found: false` and the reason — and it is **not** charged for. You pay for answers, not for attempts. ### Input | Field | Required | What it does | |---|---|---| | `urls` | yes | Page URLs to check. Up to 100 per run. | | `maxConcurrency` | no | How many to check at once, 1–50 (default 10). | ```json { "urls": ["apify.com", "github.com", "stripe.com"], "maxConcurrency": 10 } ```` ### Output One row per URL. This is a real row from a real run: ```json { "url": "https://apify.com/", "found": true, "error": null, "httpStatus": 200, "checkedAt": "2026-07-26T13:28:34.426Z", "shareScore": 100, "previewLikely": { "headline": "Apify: The largest marketplace of trusted tools for AI", "text": "Thousands of tools to automate your business. Get real-time web data, track competitors, generate leads, and integrate your apps and AI agents.", "image": "https://apify.com/og-image?title=Thousands+of+tools%0Afor+your+AI", "siteName": "Apify" }, "openGraph": { "title": "Apify: The largest marketplace of trusted tools for AI", "description": "Thousands of tools to automate your business. Get real-time web data, track competitors, generate leads, and integrate your apps and AI agents.", "image": "https://apify.com/og-image?title=Thousands+of+tools%0Afor+your+AI", "url": "https://apify.com", "type": "website", "siteName": "Apify" }, "twitter": { "card": "summary_large_image", "title": "Apify: The largest marketplace of trusted tools for AI", "description": "Thousands of tools to automate your business. Get real-time web data, track competitors, generate leads, and integrate your apps and AI agents.", "image": "https://apify.com/og-image?title=Thousands+of+tools%0Afor+your+AI" }, "htmlTitle": "Apify: The largest marketplace of trusted tools for AI", "metaDescription": "Thousands of tools to automate your business. Get real-time web data, track competitors, generate leads, and integrate your apps and AI agents.", "canonical": "https://apify.com", "favicon": "https://apify.com/favicon.ico?favicon.2653ilt32bing.ico?dpl=cf81ad0233", "imageCheck": { "exists": true, "status": 200, "contentType": "image/png", "sizeKb": null }, "issues": [], "summary": "Perfect share setup — renders a full card on all platforms (score 100/100)." } ``` | Field | What it means | |---|---| | `shareScore` | 0–100 across 7 checks (see FAQ) | | `previewLikely` | The resolved headline/text/image/siteName after the OG → Twitter → `<title>` fallback chain | | `imageCheck.exists` | The preview image URL actually resolves with a live request | | `issues` | Human-readable findings, empty when nothing is wrong | | `found` | `false` means the check failed; the row says why and is not billed | #### Need the rest of the picture? These run on the same account, take the same shape of input and bill the same way, so they slot into an existing pipeline without new plumbing. | Actor | What it does | |---|---| | [AI Crawler Access Checker](https://apify.com/zinin/ai-crawler-access-checker) | Check which AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended & more) can access your website | | [Domain Health Checker](https://apify.com/zinin/domain-health-checker) | Bulk-audit domains: DNS records, SSL certificate expiry, SPF & DMARC email authentication | | [LLM Brand Visibility Tracker](https://apify.com/zinin/llm-brand-visibility) | For each query that matters, check whether AI assistants recommend YOUR brand — and which competitors they… | | [B2B Lead Enricher](https://apify.com/zinin/b2b-lead-enricher) | Turn a list of company websites into sales-qualified lead cards: detected tech stack, a rough revenue… | | [Clinical Trials Monitor](https://apify.com/zinin/clinical-trials-monitor) | Watch conditions, drugs or sponsors for new and updated clinical trials | ### FAQ **Does it render JavaScript?** No — it fetches the raw HTML and parses the `<head>` only. That is exactly what social-media crawlers (Telegram, WhatsApp, Facebook, X) do — they don't run your JS either, so this is a truer test than opening the page in a browser. **What goes into the share score?** Seven checks: title, description, image present, image actually reachable, Twitter Card, `og:site_name`, and favicon. The score is the percentage passed. **Does it check if the image actually loads?** Yes — a live HEAD (falling back to GET) request confirms the preview image resolves, and flags a broken or unreachable image separately from a missing one. **Is this legal?** Yes — it reads publicly served HTML `<head>` tags and makes a standard HTTP request to the image URL, the same requests any browser or link-unfurling bot makes. **Can I call it from an AI agent?** Yes — standard Apify Actor, callable from the Apify API, the SDK, or the Apify MCP server. **What this is NOT.** It does not post to any platform, take a real screenshot of the rendered card, or check link safety/malware. It answers one question — will this link show a real preview card — and answers it from the same head tags every platform actually reads. Found a wrong result, or need a platform we don't cover? Open an issue on this Actor's page. *** Built by [zinin](https://apify.com/zinin). Questions? Telegram [@timzinin](https://t.me/timzinin). # Actor input Schema ## `urls` (type: `array`): List of page URLs to check (e.g. `example.com/article` or a full https URL). ## `maxConcurrency` (type: `integer`): How many URLs to check in parallel. ## Actor input object example ```json { "urls": [ "apify.com", "github.com", "stripe.com" ], "maxConcurrency": 10 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '<YOUR_API_TOKEN>' with your token const client = new ApifyClient({ token: '<YOUR_API_TOKEN>', }); // Prepare Actor input const input = { "urls": [ "apify.com", "github.com", "stripe.com" ] }; // Run the Actor and wait for it to finish const run = await client.actor("zinin/social-preview-checker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '<YOUR_API_TOKEN>' with your token. client = ApifyClient("<YOUR_API_TOKEN>") # Prepare the Actor input run_input = { "urls": [ "apify.com", "github.com", "stripe.com", ] } # Run the Actor and wait for it to finish run = client.actor("zinin/social-preview-checker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "apify.com", "github.com", "stripe.com" ] }' | apify call zinin/social-preview-checker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=zinin/social-preview-checker", "--header", "Authorization: Bearer <YOUR_API_TOKEN>" ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Social Preview Checker", "description": "See exactly how your links look when shared on Telegram, WhatsApp, X, LinkedIn, Slack, Facebook & Discord. Bulk-audit Open Graph and Twitter Card tags, validate preview images, and find what breaks your link previews.", "version": "0.1", "x-build-id": "buknq3oddZeTMxKrn" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zinin~social-preview-checker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zinin-social-preview-checker", "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/zinin~social-preview-checker/runs": { "post": { "operationId": "runs-sync-zinin-social-preview-checker", "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/zinin~social-preview-checker/run-sync": { "post": { "operationId": "run-sync-zinin-social-preview-checker", "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", "maxItems": 100, "type": "array", "description": "List of page URLs to check (e.g. `example.com/article` or a full https URL).", "items": { "type": "string" } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many URLs to check in parallel.", "default": 10 } } }, "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 } } } } } } } } } } ```