# Schema Markup Scraper API - JSON-LD, Microdata & RDFa (`pink_comic/schema-markup-extractor`) Actor

Extract JSON-LD, Microdata, RDFa, schema.org types, canonical URL, Open Graph, Twitter Cards, and meta tags from public pages. Fast structured-data/SEO evidence with HTTP status, final URL, truncation, and malformed-block signals.

- **URL**: https://apify.com/pink_comic/schema-markup-extractor.md
- **Developed by:** [Ava Torres](https://apify.com/pink_comic) (community)
- **Categories:** SEO tools, Developer tools, AI
- **Features:** Limited permissions
- **Stats:** 21 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 1,000 urls

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Schema Markup Scraper API - JSON-LD, Microdata & RDFa

Extract structured-data and SEO metadata from public web pages: **JSON-LD**, **HTML Microdata**, basic **RDFa**, schema.org types, canonical URLs, Open Graph, Twitter Cards, and meta tags. Every row also includes the final URL, HTTP status, content type, retrieval time, analyzed-byte count, truncation state, and an interpretation warning.

**Pricing:** `$0.002` per processed URL plus the memory-scaled Actor start event (`$0.0001` at the default reservation). The one-page default costs at most **$0.0021**. Buyer charge limits are applied before URLs are fetched.

### Why use it

- Audit structured-data coverage across landing pages, product pages, articles, and local-business pages.
- Export parsed JSON-LD instead of writing site-specific HTML parsers.
- Compare schema.org types and social metadata across competitors.
- Find malformed JSON-LD blocks and pages where static HTML exposes no structured data.
- Feed source-linked, point-in-time metadata into SEO QA or content pipelines.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `urls` | string array | `https://www.apple.com` | Public HTTP/HTTPS pages. One paid output item per processed URL. |
| `includeJsonLd` | boolean | `true` | Parse `application/ld+json` scripts and `@graph` arrays. |
| `includeOpenGraph` | boolean | `true` | Extract `og:*` properties. |
| `includeTwitterCard` | boolean | `true` | Extract `twitter:*` properties. |
| `includeMetaTags` | boolean | `true` | Extract HTML `meta name/content` pairs. |
| `concurrency` | integer | `5` | Parallel requests, from 1 to 20. |
| `timeout` | integer | `30` | Per-URL timeout in seconds, from 5 to 120. |
| `maxResults` | integer | `1` | Total URL/result cap, up to 10,000. A buyer charge limit can reduce it further. |

Microdata and RDFa evidence are always extracted because they are distinct schema-markup formats, not JSON-LD options.

### Output

Each requested URL produces one stable 23-key row. Arrays and objects are empty rather than `null` when evidence is absent.

```json
{
  "url": "https://www.apple.com",
  "finalUrl": "https://www.apple.com",
  "httpStatusCode": 200,
  "contentType": "text/html; charset=utf-8",
  "fetchedAt": "2026-07-25T05:13:44Z",
  "analyzedBodyBytes": 249240,
  "bodyTruncated": false,
  "title": "Apple",
  "canonicalUrl": "https://www.apple.com/",
  "jsonLd": [
    {
      "@context": "https://schema.org",
      "@type": "Organization",
      "name": "Apple"
    }
  ],
  "microdata": [],
  "rdfa": [],
  "openGraph": {
    "title": "Apple",
    "type": "website",
    "url": "https://www.apple.com/"
  },
  "twitterCard": {},
  "metaTags": [
    {"name": "description", "content": "..."}
  ],
  "schemaTypes": ["ContactPoint", "Organization", "SearchAction", "WebPage", "WebSite"],
  "microdataTypes": [],
  "rdfaTypes": [],
  "allSchemaTypes": ["ContactPoint", "Organization", "SearchAction", "WebPage", "WebSite"],
  "malformedJsonLdBlocks": 0,
  "hasStructuredData": true,
  "interpretation": "Point-in-time static HTML evidence only. Client-rendered or blocked markup can be missed; extracted syntax is not Google rich-result eligibility or semantic-validity certification.",
  "error": ""
}
```

#### Format details

- `schemaTypes` recursively includes nested JSON-LD types such as `Product` and `Offer`.
- `microdata` contains each `itemscope`, its declared type/ID, and directly owned `itemprop` values.
- `rdfa` provides basic `typeof`, `about`, and `property` extraction; it is not a complete RDF graph expansion.
- `allSchemaTypes` is the sorted union of JSON-LD, Microdata, and RDFa types.
- `malformedJsonLdBlocks` counts script blocks that are present but not valid JSON.
- Non-2xx pages remain explicit paid evidence rows with `httpStatusCode` and a non-empty `error` instead of silently looking successful.

### Evidence limits

- This Actor inspects the first **5 MiB of static response HTML**. It does not execute JavaScript. Client-rendered markup may therefore be absent.
- WAFs, consent pages, geolocation, authentication, personalization, and bot filtering can change the observed response.
- Parsed syntax does **not** certify schema.org semantic validity, Google rich-result eligibility, search ranking, canonical selection, ownership, or current indexing.
- Basic Microdata/RDFa extraction is designed for practical auditing, not standards-complete RDF processing.
- Private, loopback, link-local, non-HTTP, and malformed literal URLs are rejected. Only use publicly accessible pages you are authorized to request.
- Redirects are followed up to 10 hops; `url` preserves the request and `finalUrl` records the observed destination.

### How to use

1. Open [Schema Markup Scraper API - JSON-LD, Microdata & RDFa](https://apify.com/pink_comic/schema-markup-extractor) in Apify Console and click **Start** (or **Try for free**).
2. Fill in the input form - start with **URLs**, **Include JSON-LD**, **Include Open Graph**. Every field is optional unless marked required, and the form is prefilled with a working example.
3. Set **Maximum results** to cap your cost, then run the Actor.
4. Download the results as JSON, CSV, Excel, XML or HTML, or pull them with the Apify API.

#### Example input

```json
{
  "urls": [
    "https://www.apple.com"
  ],
  "includeJsonLd": true,
  "includeOpenGraph": true,
  "includeTwitterCard": true,
  "includeMetaTags": true,
  "concurrency": 5,
  "timeout": 30,
  "maxResults": 1
}
```

### Output example

One record from a real run (long values shortened, contact details partly masked):

```json
{
  "url": "https://www.apple.com",
  "finalUrl": "https://www.apple.com",
  "httpStatusCode": 200,
  "contentType": "text/html; charset=utf-8",
  "fetchedAt": "2026-11-11T14:00:20Z",
  "analyzedBodyBytes": 256748,
  "bodyTruncated": false,
  "title": "Apple",
  "canonicalUrl": "https://www.apple.com/",
  "jsonLd": [
    {
      "@context": "http://schema.org",
      "@id": "https://www.apple.com/#organization",
      "@type": "Organization",
      "contactPoint": [
        {
          "@type": "ContactPoint",
          "areaServed": "US",
          "contactType": "sales",
          "telephone": "+x-xxx-xxx-7753"
        },
        {
          "@type": "ContactPoint",
          "areaServed": "US",
          "availableLanguage": [
            "EN",
            "ES"
          ],
          "contactType": "technical support",
          "telephone": "+x-xxx-xxx-2273"
        },
        {
          "@type": "ContactPoint",
          "areaServed": "US",
          "availableLanguage": [
            "EN",
            "ES"
          ],
          "contactType": "customer support",
          "telephone": "+x-xxx-xxx-2273"
        }
      ],
      "logo": "https://www.apple.com/ac/structured-data/images/knowledge_graph_logo.png?202610011401",
      "name": "Apple",
      "sameAs": [
        "http://www.wikidata.org/entity/Q312",
        "https://www.youtube.com/user/Apple",
        "https://www.linkedin.com/company/apple"
      ],
      "subOrganization": {
        "@id": "https://support.apple.com/#organization",
        "@type": "Organization",
        "name": "Apple Support",
        "url": "https://support.apple.com"
      },
      "url": "https://www.apple.com/"
    },
    {
      "@context": "http://schema.org",
      "@id": "https://www.apple.com/#website",
      "@type": "WebSite",
      "name": "Apple",
      "potentialAction": {
        "@type": "SearchAction",
        "query-input": "required name=search_term_string",
        "target": "https://www.apple.com/us/search/{search_term_string}?src=mc_google"
      },
      "url": "https://www.apple.com/"
    },
    {
      "@context": "http://schema.org",
      "@id": "https://www.apple.com/#webpage",
      "@type": "WebPage",
      "name": "Apple",
      "url": "https://www.apple.com/"
    }
  ],
  "microdata": [],
  "rdfa": [],
  "openGraph": {
    "description": "Discover the innovative world of Apple and shop everything iPhone, iPad, Apple Watch, Mac, and Apple TV, plus explore accessories, entertainment, and expert ...",
    "image": "https://www.apple.com/ac/structured-data/images/open_graph_logo.png?202610011401",
    "locale": "en_US",
    "site_name": "Apple",
    "title": "Apple",
    "type": "website",
    "url": "https://www.apple.com/"
  },
  "twitterCard": {},
  "metaTags": [
    {
      "name": "viewport",
      "content": "width=device-width, initial-scale=1, viewport-fit=cover"
    },
    {
      "name": "description",
      "content": "Discover the innovative world of Apple and shop everything iPhone, iPad, Apple Watch, Mac, and Apple TV, plus explore accessories, entertainment, and expert ..."
    },
    {
      "name": "globalnav-store-key",
      "content": "SFX9YPYY9PPXCU9KH"
    }
  ],
  "schemaTypes": [
    "ContactPoint",
    "Organization",
    "SearchAction"
  ],
  "microdataTypes": [],
  "rdfaTypes": [],
  "allSchemaTypes": [
    "ContactPoint",
    "Organization",
    "SearchAction"
  ],
  "malformedJsonLdBlocks": 0,
  "hasStructuredData": true,
  "interpretation":
```

### Pricing

Pay per event: **$0.002 per url** plus **$0.0001 per run start**. No subscription to this Actor is needed. Apify Store discounts apply, so the price per result is lower on Silver, Gold and higher Apify plans. Use **Maximum results** to cap the cost of each run.

### FAQ

#### How much does Schema Markup Scraper API - JSON-LD, Microdata & RDFa cost?

$0.002 per url plus $0.0001 per run. For example, 1,000 results cost about $2.00. Higher Apify plans get a Store discount.

#### Do I need an API key or login?

No. Just configure the input and run it.

#### Can I run it on a schedule or from code?

Yes. Use Apify Schedules for recurring runs, or call it from the Apify API, the JavaScript or Python client, Make, Zapier, n8n, or any MCP-compatible AI agent.

#### Why did my run return no results?

Your filters are probably too narrow. Remove a filter or broaden the search, then run again. You only pay the result price for records that are actually saved.

#### Is the data accurate and up to date?

Each run fetches live data from the source described above, so results are as current as that source. Verify critical records with the original source before acting on them.

# Actor input Schema

## `urls` (type: `array`):

Public HTTP/HTTPS pages to inspect. Each URL creates one paid dataset item. The default runs one schema-rich Apple page for at most $0.0021 including the minimum start event.

## `includeJsonLd` (type: `boolean`):

Extract JSON-LD structured data blocks (application/ld+json scripts). Includes all @type objects and @graph arrays.

## `includeOpenGraph` (type: `boolean`):

Extract Open Graph metadata (og:title, og:description, og:image, og:url, og:type, etc.).

## `includeTwitterCard` (type: `boolean`):

Extract Twitter Card metadata (twitter:card, twitter:title, twitter:description, twitter:image, etc.).

## `includeMetaTags` (type: `boolean`):

Extract all <meta name=...> tags (description, keywords, author, robots, viewport, etc.).

## `concurrency` (type: `integer`):

Number of URLs to fetch in parallel. Keep low (3-5) for polite crawling.

## `timeout` (type: `integer`):

Maximum seconds to wait for each URL to respond.

## `maxResults` (type: `integer`):

Total URL/result cap for this run. Each processed URL costs $0.002; any buyer charge limit can reduce this total before fetching.

## Actor input object example

```json
{
  "urls": [
    "https://www.apple.com"
  ],
  "includeJsonLd": true,
  "includeOpenGraph": true,
  "includeTwitterCard": true,
  "includeMetaTags": true,
  "concurrency": 5,
  "timeout": 30,
  "maxResults": 1
}
```

# Actor output Schema

## `results` (type: `string`):

All records from this run in the default dataset, shown with the Overview table view.

# 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": [
        "https://www.apple.com"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("pink_comic/schema-markup-extractor").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": ["https://www.apple.com"] }

# Run the Actor and wait for it to finish
run = client.actor("pink_comic/schema-markup-extractor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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": [
    "https://www.apple.com"
  ]
}' |
apify call pink_comic/schema-markup-extractor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,pink_comic/schema-markup-extractor"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/uL4G6zMhjSOM6tckE/builds/1JGI3jKdg1Zg1uw6f/openapi.json