Documentation
Web Intelligence

Web Intelligence

Scrape, crawl, search, extract, and screenshot public web pages into agent-ready context.

Status: Preview.

Web Intelligence is the first hosted API family under Agent Mag. It is built for agents that need current public web context without building browser workers, content extraction, retries, queues, and usage ledgers from scratch.

Endpoint Family

EndpointStatusUse caseTypical output
POST /v1/scrapePreviewFetch one URL.Markdown, text, links, metadata, optional screenshot.
POST /v1/crawlPlannedTraverse many pages.Job ID, page results, crawl graph, failures.
POST /v1/searchPlannedFind and rank URLs before capture.Ranked results and selected page context.
POST /v1/extractPlannedConvert pages into typed JSON.Schema-shaped JSON and confidence notes.
POST /v1/screenshotPreview SpecCapture visual page state.Image URL, viewport metadata, timing details.

Shared Request Rules

All hosted endpoints use bearer auth:

code
Authorization: Bearer $AGENTMAG_API_KEY
Content-Type: application/json

Requests should include public URLs only. Private pages, credentialed browsing, and bypassing access controls are out of scope.