{ "openapi": "3.1.0", "info": { "title": "CrawlForge REST API", "version": "1.0.0", "description": "31 metered web tools behind one API key, sent as the X-API-Key header. Every call is priced in credits: x-credits on an operation is its base price, and a tool with a per-unit or conditional price explains it in x-credits-note and x-extra. Credits are deducted only after a call succeeds. Every error response, whatever its status, charges nothing. A successful response reports credits_used and credits_remaining. Each tool also answers GET with the self-description this document was generated from. Full reference, including each tool's response shape: https://www.crawlforge.dev/docs/api-reference", "termsOfService": "https://www.crawlforge.dev/terms", "contact": { "name": "CrawlForge", "email": "simon@crawlforge.dev" } }, "servers": [ { "url": "https://www.crawlforge.dev/api/v1", "description": "Production" } ], "security": [ { "ApiKeyAuth": [] } ], "tags": [ { "name": "tools", "description": "The web tools. POST runs a tool and is metered; GET describes it and is free." } ], "paths": { "/tools/agent": { "post": { "operationId": "agent", "summary": "Autonomous research/extraction from a natural-language prompt — no URLs required. Plans search queries, fetches and filters relevant pages, and returns a prose or structured answer under hard safety caps. Agent runs can exceed the REST API's ~50s window (the MCP tool allows 120s) — keep maxSteps/maxUrls small, or use the CrawlForge MCP server for long runs.", "tags": [ "tools" ], "x-credits": 18, "x-credits-note": "8 per run, plus 5 for each walled page (challenge, 403/429, empty shell, timeout) the agent gets by retrying it in a stealth browser, at most 2 a run; a retry blocked again is free. The published 18 is the ceiling reserved before the run; the charge is what ran, and the response reports it as credits_used.", "x-extra": { "availability": { "hosted_api": true, "mcp_server": true, "note": "Runs on the CrawlForge execution backend. Agent runs can exceed the REST API's ~50s window (the MCP tool allows up to 120s wall-clock) — keep maxSteps/maxUrls small, or use the CrawlForge MCP server for long runs. model \"pro\" is not available via the REST API." } }, "x-docs-url": "https://www.crawlforge.dev/docs/api-reference/tools/agent", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRequest" }, "example": { "prompt": "Find the current pricing tiers for the top 3 MCP web-scraping providers", "maxSteps": 3, "maxUrls": 5 } } } }, "responses": { "200": { "description": "The tool's result; 18 credits charged (see x-credits-note and x-extra for add-ons).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolSuccess" } } } }, "400": { "description": "VALIDATION_ERROR: the body does not match the request schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "MISSING_API_KEY or INVALID_API_KEY.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "INSUFFICIENT_CREDITS: the balance does not cover the tool's base price. X-Auto-Recharge-Triggered says whether an automatic recharge was started; retry once it lands.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "RATE_LIMIT_EXCEEDED: your plan's rate limit. Retry-After: 60.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "TOOL_ERROR, INTERNAL_ERROR or CREDIT_DEDUCTION_FAILED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "default": { "description": "Any other error. Which of 403, 404, 413, 422, 501, 502, 503 and 504 a tool can return depends on what it does (fetching a page, calling the execution backend, reading stored results); the code vocabulary is listed on the ErrorResponse schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "get": { "operationId": "describe_agent", "summary": "Describe agent", "description": "The tool's self-description: its price, its request schema and an example body. No API key is needed.", "tags": [ "tools" ], "security": [], "responses": { "200": { "description": "The ToolInfo this document was generated from.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolInfo" } } } } } } }, "/tools/analyze_content": { "post": { "operationId": "analyze_content", "summary": "Analyze web content for language, keywords, sentiment, and readability", "tags": [ "tools" ], "x-credits": 3, "x-docs-url": "https://www.crawlforge.dev/docs/api-reference/tools/analyze-content", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnalyzeContentRequest" }, "example": { "url": "https://example.com/article", "analyze_sentiment": true, "extract_keywords": true, "detect_language": true, "analyze_readability": true } } } }, "responses": { "200": { "description": "The tool's result; 3 credits charged (see x-credits-note and x-extra for add-ons).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolSuccess" } } } }, "400": { "description": "VALIDATION_ERROR: the body does not match the request schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "MISSING_API_KEY or INVALID_API_KEY.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "INSUFFICIENT_CREDITS: the balance does not cover the tool's base price. X-Auto-Recharge-Triggered says whether an automatic recharge was started; retry once it lands.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "RATE_LIMIT_EXCEEDED: your plan's rate limit. Retry-After: 60.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "TOOL_ERROR, INTERNAL_ERROR or CREDIT_DEDUCTION_FAILED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "default": { "description": "Any other error. Which of 403, 404, 413, 422, 501, 502, 503 and 504 a tool can return depends on what it does (fetching a page, calling the execution backend, reading stored results); the code vocabulary is listed on the ErrorResponse schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "get": { "operationId": "describe_analyze_content", "summary": "Describe analyze_content", "description": "The tool's self-description: its price, its request schema and an example body. No API key is needed.", "tags": [ "tools" ], "security": [], "responses": { "200": { "description": "The ToolInfo this document was generated from.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolInfo" } } } } } } }, "/tools/batch_scrape": { "post": { "operationId": "batch_scrape", "summary": "Fetch up to 50 URLs concurrently in one synchronous call, returning title, text, and optional CSS-extracted fields per URL", "tags": [ "tools" ], "x-credits": 5, "x-credits-note": "5 per URL attempted (skipped URLs are not charged)", "x-extra": { "execution_model": { "mode": "synchronous", "time_budget": "20s of fetching per batch; URLs not started in time return status \"skipped\" and are not charged", "robots": "URLs disallowed by the target's robots.txt, URLs on a host CrawlForge has permanently blocked or that asked us to back off, and URLs whose host declares a Crawl-delay too long for the batch budget all return status \"skipped\" (with the reason in error) and are not charged; the reasons are summarized in notes", "crawl_delay": "A robots.txt Crawl-delay is honoured per host: URLs on that host are fetched one at a time, spaced by the delay, while other hosts keep the full concurrency", "per_url_timeout": "8s", "binary_content": "A PDF or other binary served with a 2xx status fails that URL (status \"failed\", error naming the content type) instead of being decoded as text; use process_document for it", "javascript": "Pages are fetched without JavaScript execution; screenshots and JS rendering require a browser — use the CrawlForge MCP server (npm: crawlforge-mcp-server)", "results_retention": "The full result set is stored for 24h and retrievable via get_batch_results using the returned batch_id" } }, "x-docs-url": "https://www.crawlforge.dev/docs/api-reference/tools/batch-scrape", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BatchScrapeRequest" }, "example": { "urls": [ { "url": "https://example1.com/products", "id": "site1" }, { "url": "https://example2.com/products", "id": "site2" } ], "batch_config": { "concurrency": 5 }, "extraction_template": { "fields": [ { "name": "title", "selector": "h1" }, { "name": "price", "selector": ".price" }, { "name": "canonical", "selector": "link[rel=\"canonical\"]", "attribute": "href" } ] } } } } }, "responses": { "200": { "description": "The tool's result; 5 credits charged (see x-credits-note and x-extra for add-ons).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolSuccess" } } } }, "400": { "description": "VALIDATION_ERROR: the body does not match the request schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "MISSING_API_KEY or INVALID_API_KEY.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "INSUFFICIENT_CREDITS: the balance does not cover the tool's base price. X-Auto-Recharge-Triggered says whether an automatic recharge was started; retry once it lands.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "RATE_LIMIT_EXCEEDED: your plan's rate limit. Retry-After: 60.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "TOOL_ERROR, INTERNAL_ERROR or CREDIT_DEDUCTION_FAILED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "default": { "description": "Any other error. Which of 403, 404, 413, 422, 501, 502, 503 and 504 a tool can return depends on what it does (fetching a page, calling the execution backend, reading stored results); the code vocabulary is listed on the ErrorResponse schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "get": { "operationId": "describe_batch_scrape", "summary": "Describe batch_scrape", "description": "The tool's self-description: its price, its request schema and an example body. No API key is needed.", "tags": [ "tools" ], "security": [], "responses": { "200": { "description": "The ToolInfo this document was generated from.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolInfo" } } } } } } }, "/tools/browser_session": { "post": { "operationId": "browser_session", "summary": "Drive a browser across several calls, keeping the page, its cookies and its login in between. The loop is: open a session on a URL, snapshot it to list the interactive elements as refs (@e1, @e2 ...), act on those refs, read the content (the whole page by default, onlyMainContent: true for the main article block alone), close. Because the page stays open you can look before each step instead of committing to a whole chain up front, so a wrong selector costs one call rather than all of them. Not for a page that renders without interaction (scrape), and not for an interaction you can write out in advance — that is one scrape_with_actions call.", "tags": [ "tools" ], "x-credits": 3, "x-credits-note": "Priced per operation, not per call: open 3, read 2, and snapshot, act, screenshot, close and list 1 each. The published 3 is the ceiling — it is what an unrecognised operation costs and what is reserved before the body is read, and the charge drops to the operation's own price. A login-then-read flow (open, snapshot, act, act, read, close) costs 9.", "x-extra": { "credits_cost_by_operation": { "note": "Nothing in a session is free: close and list are bookkeeping and still cost 1. An absent or unrecognised operation is charged the flat 3.", "open": 3, "snapshot": 1, "act": 1, "read": 2, "screenshot": 1, "close": 1, "list": 1 }, "session_lifetime": { "ttl_seconds": 600, "activity_ttl_seconds": 300, "note": "A session dies 600s after it opens or 300s after its last use, whichever comes first — both adjustable on open. Close it when you are done rather than leaving it to expire." }, "limits": { "concurrent_sessions": 1, "note": "One open session per API key on the hosted API. A second open is refused by name and charged nothing — close the first, or wait for it to expire. Sessions share the backend browser pool with every other tool, which is what the cap protects." }, "availability": { "hosted_api": true, "mcp_server": true, "note": "Runs on the CrawlForge execution backend, where the page itself lives. A session id is usable only from the backend instance that opened it and only while that instance is running, so a deploy or a restart ends every open session — treat a \"session not found\" as a signal to open a new one rather than an error to retry. Screenshots come back as crawlforge://screenshot/{id} resource URIs, which this endpoint passes through without resolving, so for now the screenshot operation is usable only from the CrawlForge MCP server. executeJavaScript is refused inside a hosted session." } }, "x-docs-url": "https://www.crawlforge.dev/docs/api-reference/tools/browser-session", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BrowserSessionRequest" }, "example": { "operation": "open", "url": "https://app.example.com/login", "ttl": 600 } } } }, "responses": { "200": { "description": "The tool's result; 3 credits charged (see x-credits-note and x-extra for add-ons).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolSuccess" } } } }, "400": { "description": "VALIDATION_ERROR: the body does not match the request schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "MISSING_API_KEY or INVALID_API_KEY.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "INSUFFICIENT_CREDITS: the balance does not cover the tool's base price. X-Auto-Recharge-Triggered says whether an automatic recharge was started; retry once it lands.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "RATE_LIMIT_EXCEEDED: your plan's rate limit. Retry-After: 60.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "TOOL_ERROR, INTERNAL_ERROR or CREDIT_DEDUCTION_FAILED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "default": { "description": "Any other error. Which of 403, 404, 413, 422, 501, 502, 503 and 504 a tool can return depends on what it does (fetching a page, calling the execution backend, reading stored results); the code vocabulary is listed on the ErrorResponse schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "get": { "operationId": "describe_browser_session", "summary": "Describe browser_session", "description": "The tool's self-description: its price, its request schema and an example body. No API key is needed.", "tags": [ "tools" ], "security": [], "responses": { "200": { "description": "The ToolInfo this document was generated from.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolInfo" } } } } } } }, "/tools/crawl_deep": { "post": { "operationId": "crawl_deep", "summary": "Crawl websites deeply using breadth-first search to discover and extract content", "tags": [ "tools" ], "x-credits": 4, "x-extra": { "response_notes": { "pages_attempted": "URLs the crawl requested: pages_crawled + error_count", "pages_crawled": "Pages fetched and parsed, one entry each in pages", "error_count": "URLs that were requested and did not produce a page, one entry each in errors", "errors": "One { url, depth, error, code? } per failed URL: a timeout, an unreachable host or an HTTP error status. code is present when known (FETCH_TIMEOUT, FETCH_FAILED, VALIDATION_ERROR for a private address). URLs skipped for robots.txt or Crawl-delay are counted in warnings instead" } }, "x-docs-url": "https://www.crawlforge.dev/docs/api-reference/tools/crawl-deep", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CrawlDeepRequest" }, "example": { "start_url": "https://example.com", "max_pages": 20, "max_depth": 3, "same_domain_only": true, "crawl_delay": 1000 } } } }, "responses": { "200": { "description": "The tool's result; 4 credits charged (see x-credits-note and x-extra for add-ons).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolSuccess" } } } }, "400": { "description": "VALIDATION_ERROR: the body does not match the request schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "MISSING_API_KEY or INVALID_API_KEY.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "INSUFFICIENT_CREDITS: the balance does not cover the tool's base price. X-Auto-Recharge-Triggered says whether an automatic recharge was started; retry once it lands.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "RATE_LIMIT_EXCEEDED: your plan's rate limit. Retry-After: 60.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "TOOL_ERROR, INTERNAL_ERROR or CREDIT_DEDUCTION_FAILED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "default": { "description": "Any other error. Which of 403, 404, 413, 422, 501, 502, 503 and 504 a tool can return depends on what it does (fetching a page, calling the execution backend, reading stored results); the code vocabulary is listed on the ErrorResponse schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "get": { "operationId": "describe_crawl_deep", "summary": "Describe crawl_deep", "description": "The tool's self-description: its price, its request schema and an example body. No API key is needed.", "tags": [ "tools" ], "security": [], "responses": { "200": { "description": "The ToolInfo this document was generated from.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolInfo" } } } } } } }, "/tools/deep_research": { "post": { "operationId": "deep_research", "summary": "Multi-query web research: runs web searches, fetches the top sources, and returns the most relevant passages verbatim with citations. Synthesis is extractive (no LLM on the hosted API) — for LLM-synthesized research use the CrawlForge MCP server.", "tags": [ "tools" ], "x-credits": 10, "x-extra": { "response_shape": { "methodology": "Queries run, backend used, source counts, synthesis: extractive, llm_used: false", "key_findings": "Up to 10 query-relevant passages, each with text, source_url, source_title, relevance_score. Author/affiliation and DOI front-matter is excluded, passages that barely mention the topic are dropped rather than used as padding (so this list can be short), and no single source domain fills more than 40% of it while another source has a passage to offer", "sources": "Every source considered: url, title, snippet, fetched (false = search snippet only), domain", "summary": "Extractive summary — the highest-scoring sentences from the findings, verbatim" } }, "x-docs-url": "https://www.crawlforge.dev/docs/api-reference/tools/deep-research", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeepResearchRequest" }, "example": { "research_query": "impact of remote work on software team productivity", "research_scope": { "depth_level": "moderate", "time_range": "year" }, "max_sources": 5 } } } }, "responses": { "200": { "description": "The tool's result; 10 credits charged (see x-credits-note and x-extra for add-ons).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolSuccess" } } } }, "400": { "description": "VALIDATION_ERROR: the body does not match the request schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "MISSING_API_KEY or INVALID_API_KEY.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "INSUFFICIENT_CREDITS: the balance does not cover the tool's base price. X-Auto-Recharge-Triggered says whether an automatic recharge was started; retry once it lands.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "RATE_LIMIT_EXCEEDED: your plan's rate limit. Retry-After: 60.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "TOOL_ERROR, INTERNAL_ERROR or CREDIT_DEDUCTION_FAILED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "default": { "description": "Any other error. Which of 403, 404, 413, 422, 501, 502, 503 and 504 a tool can return depends on what it does (fetching a page, calling the execution backend, reading stored results); the code vocabulary is listed on the ErrorResponse schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "get": { "operationId": "describe_deep_research", "summary": "Describe deep_research", "description": "The tool's self-description: its price, its request schema and an example body. No API key is needed.", "tags": [ "tools" ], "security": [], "responses": { "200": { "description": "The ToolInfo this document was generated from.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolInfo" } } } } } } }, "/tools/extract_content": { "post": { "operationId": "extract_content", "summary": "Extract main article content from web pages using readability detection", "tags": [ "tools" ], "x-credits": 2, "x-docs-url": "https://www.crawlforge.dev/docs/api-reference/tools/extract-content", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtractContentRequest" }, "example": { "url": "https://example.com/article", "include_images": true, "include_links": false, "clean_html": true, "extract_main_content": true } } } }, "responses": { "200": { "description": "The tool's result; 2 credits charged (see x-credits-note and x-extra for add-ons).", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolSuccess" } } } }, "400": { "description": "VALIDATION_ERROR: the body does not match the request schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "MISSING_API_KEY or INVALID_API_KEY.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "402": { "description": "INSUFFICIENT_CREDITS: the balance does not cover the tool's base price. X-Auto-Recharge-Triggered says whether an automatic recharge was started; retry once it lands.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "RATE_LIMIT_EXCEEDED: your plan's rate limit. Retry-After: 60.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "TOOL_ERROR, INTERNAL_ERROR or CREDIT_DEDUCTION_FAILED.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "default": { "description": "Any other error. Which of 403, 404, 413, 422, 501, 502, 503 and 504 a tool can return depends on what it does (fetching a page, calling the execution backend, reading stored results); the code vocabulary is listed on the ErrorResponse schema.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } }, "get": { "operationId": "describe_extract_content", "summary": "Describe extract_content", "description": "The tool's self-description: its price, its request schema and an example body. No API key is needed.", "tags": [ "tools" ], "security": [], "responses": { "200": { "description": "The ToolInfo this document was generated from.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolInfo" } } } } } } }, "/tools/extract_embedded_state": { "post": { "operationId": "extract_embedded_state", "summary": "Return the JSON state a page already ships in its own HTML: __NEXT_DATA__, React Server Component flight chunks (self.__next_f, \"$\" references between rows resolved, plus a data_rows index of the rows carrying data), __NUXT__ and Nuxt 3's __NUXT_DATA__ (decoded), SvelteKit kit.start data, __APOLLO_STATE__, __INITIAL_STATE__, __PRELOADED_STATE__, ytInitialData, ytInitialPlayerResponse, __remixContext and other window globals (JSON, or a JavaScript literal evaluated statically — no page code runs), Inertia data-page, Shopify meta and product JSON, JSON data-* attributes and