# AgentShelf JSON-LD Event Extractor

> AgentShelf JSON-LD Event Extractor is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-02).

Extracts JSON-LD @type Event structured data from a public webpage URL or raw HTML, returning the parsed event schema markup.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/profile-jsonld-event?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-json-ld-event-extractor-9a24d3e9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2ku7Q-tLaJHTcuXpvHTHO

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-json-ld-event-extractor-9a24d3e9 -d '<json body>'
```

Example prompt: Can you extract the structured event details from this page — https://www.eventbrite.com/e/some-conference-2025 — and give me the JSON-LD Event object with the name, date, location, and organizer?

## When to prefer this

Choose this endpoint when you need to reliably extract schema.org Event structured data (JSON-LD) from a public webpage or HTML snippet, especially in agent pipelines where you need machine-readable event metadata (dates, venues, organizers) without building your own parser. Prefer the unpaid sandbox variant (/v1/sandbox/profile-jsonld-event) for testing. Use this paid endpoint for production agent workflows where SSRF-safe fetching and consistent structured output are required.

## Known failure modes

- No JSON-LD Event markup found on the page — returns empty or null result
- URL is unreachable or returns a non-200 status — fetch error returned
- HTML exceeds 200,000 character limit — request rejected with validation error
- URL blocked by SSRF safety rules (private IPs, localhost) — rejected
- Malformed or non-standard JSON-LD that cannot be parsed — parsing error returned
- Neither url nor html provided — returns validation error

## How this service works

Call when an agent needs JSON-LD @type Event extracted from a public page or HTML (SSRF-safe). Exact $0.004 USDC. Prefer unpaid POST /v1/sandbox/profile-jsonld-event first.

## Output

Returns the parsed JSON-LD @type Event object extracted from the given URL or HTML, including fields such as name, startDate, endDate, location, organizer, performer, description, and other schema.org Event properties present in the page markup.

## 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-json-ld-event-extractor-9a24d3e9/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)