# agentshelf.syntexa.ch OG Image XPath Extractor

> agentshelf.syntexa.ch OG Image XPath Extractor is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Extracts the Open Graph image URL (og:image meta property) from a public webpage or raw HTML using XPath, with SSRF protection.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/xpath-og-image?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-syntexa-ch-og-image-xpath-extractor-98cac98c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Xd2UbKsUlDJ3hZnp_kQXd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentshelf-syntexa-ch-og-image-xpath-extractor-98cac98c -d '<json body>'
```

Example prompt: Can you grab the og:image URL from https://example.com/article — I need the Open Graph image that would show up when someone shares that page on social media?

## When to prefer this

Choose this endpoint when you need specifically the og:image Open Graph image URL from a webpage or HTML snippet with SSRF safety guarantees. It is purpose-built for this single XPath query, making it more reliable and cheaper than a general-purpose scraper. Use when you already have raw HTML and want to avoid an extra fetch, or when you need the social preview image URL for link enrichment, content aggregation, or metadata pipelines.

## Known failure modes

- No og:image meta tag present on the page — returns empty or null result
- SSRF-blocked URL (private/internal IP ranges) — request rejected for security reasons
- URL fetch timeout or unreachable host — returns error
- HTML input exceeds 200,000 character limit — rejected
- URL shorter than 8 characters or longer than 2048 characters — validation error
- Malformed HTML that cannot be parsed via XPath — returns empty result

## How this service works

Call when an agent needs content of meta property=og:image via //meta[@property='og:image']/@content from a public page or HTML (SSRF-safe). Exact $0.005 USDC. Prefer unpaid POST /v1/sandbox/xpath-og-image first.

## Output

Returns the value of the og:image meta property found via XPath (//meta[@property='og:image']/@content) — typically an absolute image URL intended for social media previews. If the page has no og:image tag or the URL/HTML is invalid, the response will indicate no value was found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 8,
   "description": "Public page to fetch. The selector or profile is fixed by the SKU. Provide url or html."
  },
  "html": {
   "type": "string",
   "examples": [
    "<!doctype html><html lang=\"en\"><head><title>Hello</title>\n<meta name=\"description\" content=\"Desc\"><meta property=\"og:title\" content=\"OG\">\n<link rel=\"canonical\" href=\"https://example.com/\"><link rel=\"icon\" href=\"/favicon.ico\">\n</head><body><h1>Hello</h1><a href=\"https://example.com/a\">A</a></body></html>"
   ],
   "maxLength": 200000,
   "minLength": 1,
   "description": "HTML to extract from locally. Provide html or url. When both are set, html is used."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshelf-syntexa-ch-og-image-xpath-extractor-98cac98c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)