Skip to content
Mekler AIGet started

Mekler AI / Page Metadata

Service details

Page Metadata

Collect the title, description and preview links a webpage publishes. Your assistant calls the service and brings the result back into your task.

Extract static page metadata and share previews from one public HTML URL: title, description, canonical candidates, Open Graph/Twitter fields, image and favicon references

0.002 USDC per accepted request

Paid only. No free trial for this operation.

This operation needs paid setup. New to Mekler? Start with a free sample task →

Know its boundaries.

  • JavaScript rendering, screenshots, asset downloads, private pages or verification of referenced images/icons.

Data handling

The supplied public URL is fetched subject to robots and DNS/address controls. Inputs, results, keys and proofs are excluded from telemetry. Completed results are stored encrypted for30days; private recovery capabilities must remain private.

Input example and exact contract
{
  "url": "https://mekler.ai/",
  "request_id": "page-metadata-example-001"
}

API reference: input, output and error schemas →

Example output
{
  "status": "ok",
  "url": "https://mekler.ai/",
  "retrieved_at": "2026-10-18T00:00:00Z",
  "title": "Mekler example",
  "description": "Synthetic preview metadata",
  "canonical_url": "https://mekler.ai/",
  "canonical_candidates": [
    "https://mekler.ai/"
  ],
  "canonical_conflict": false,
  "images": [
    "https://mekler.ai/preview.png"
  ],
  "icons": [
    "https://mekler.ai/favicon.ico"
  ],
  "open_graph": {
    "title": [
      "Mekler example"
    ],
    "type": [
      "website"
    ]
  },
  "twitter": {
    "card": [
      "summary"
    ]
  },
  "limitations": [
    "Static HTML only; no JavaScript rendering or asset fetching.",
    "First valid canonical link wins; conflicts are disclosed. Title uses HTML then OpenGraph then Twitter.",
    "Linked images/icons/canonical destinations are references, not verified reachable assets."
  ]
}
Calling, result interpretation and recovery

Calling

Endpoint

POST /v1/web/pages/extract-metadata

Content type

application/json

Input

All fields, formats, defaults and limits are specified in requestBody. request_id must be16–64ASCII letters, digits, underscores or hyphens; use a fresh value per new purchase.

Interpret the result

Status

ok means the documented bounded operation completed; inspect explicit coverage and limitations.

Result

Response schema describes each output. Null means missing/unknown, never measured zero.

Recovery

Use the original body and payment proof after timeout, pending settlement or quote expiry.

Limits

Request bytes

24000

Semantics
  • No work occurs on unsigned quotes. Normalize and bind the complete input before payment.

  • Successful results are encrypted for30day original-proof recovery.

  • Incomplete operation or source/storage failure is uncharged. A completed diagnostic or zero-match lookup is charged.

Payment and recovery

Price

0.002 native USDC per completed operation

Network

Solana mainnet or Base mainnet

Protocol

x402 v2 exact

Quote

POST the intended JSON unsigned for one input-bound402; no work/source retrieval occurs. Sign one offer and resend identical JSON. Work and encrypted storage complete before settlement.

Authorization

Choose one accepts entry with a standard x402 v2 client. Check native USDC, network, recipient, amount and intended input before signing. Solana uses an SVM transaction; Base uses an EOA EIP-3009 authorization (USD Coin version 2). Send the proof with identical JSON input. No API key, token approval, bridge or Solana wallet is needed for Base. Never automatically fall back to another network.

Retry

Preserve identical JSON and original proof for30day result recovery; do not buy again after a timeout or pending result. Fresh request_id creates a new paid operation.

Finality

A202 is pending. Finalized delivery carries PAYMENT-RESPONSE; provisional delivery is separately labeled and does not establish finality. Preserve the original proof instead of buying again.

Expiry

Ongoing service under recurring monthly authority. Budget warnings do not stop service. Short-lived quotes and recovery retention still expire.

Networks
  • solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp

  • eip155:8453

Assets
Solana:5eykt4usfv8p8njdtrepy1vzqkqzkvdp

EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Eip155:8453

0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Fees

CDP sponsors the payment transaction gas on both networks. The service price is the same on either network; wallet funding or exchange fees are separate.

Request binding

The server authenticates the complete quote and input and atomically binds the first accepted authorization to them. Standard Base EIP-3009 signs the money terms and nonce, not HTTP content. Keep signatures private; do not reuse an authorization for another quote, operation or body.