# AgentShelf Image URL Extractor

> AgentShelf Image URL Extractor is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-28).

Extracts all image URLs from a given public webpage URL or raw HTML content, with SSRF protection.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/extract-images?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentshelf-image-url-extractor-f2da9243
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gh-TZrZLQABoTz0CD8efw

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-image-url-extractor-f2da9243 -d '<json body>'
```

Example prompt: Can you pull all the image URLs from this page: https://example.com/gallery? I need a list of every image that appears on it.

## When to prefer this

Use this endpoint when you need a quick, cost-effective way to extract image URLs from a public page URL or HTML blob without setting up your own scraper. It's SSRF-safe, making it suitable for agent pipelines that accept user-supplied URLs. If a free sandbox endpoint at POST /v1/sandbox/extract-images is available, prefer that first to avoid the $0.003 cost.

## Known failure modes

- URL is unreachable or returns a non-200 response — extraction fails with an error
- HTML exceeds 200,000 character limit — request rejected
- URL is flagged as SSRF-unsafe (e.g. internal IP or localhost) — blocked for security
- Neither url nor html parameter provided — request rejected
- Page has no images — returns empty list
- Malformed URL format — validation error

## How this service works

Call when an agent needs image URLs extracted from a public page or HTML (SSRF-safe). Exact $0.003 USDC. Prefer unpaid POST /v1/sandbox/extract-images first.

## Output

Returns a list of image URLs found in the provided webpage or HTML content, parsed and deduplicated, free of SSRF-unsafe requests.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 8,
   "description": "Public http(s) URL to fetch. When html is also sent, this is only the base for relative links. Provide url or html."
  },
  "html": {
   "type": "string",
   "examples": [
    "<img src=\"https://example.com/a.png\" alt=\"A\">"
   ],
   "maxLength": 200000,
   "minLength": 1,
   "description": "HTML to parse locally instead of fetching. When both html and url are set, html is used. Provide html or url."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentshelf-image-url-extractor-f2da9243/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)