{ "openapi": "3.0.3", "info": { "title": "Web Search, Page to Markdown and Document Conversion API", "version": "2.0.0", "description": "Search the web, turn pages and documents into Markdown, capture screenshots and transcribe audio.", "contact": { "name": "WritersLogic", "url": "https://writerslogic.com/agents" }, "termsOfService": "https://writerslogic.com/terms", "x-category": "data", "x-long-description": "Web access for agents and apps behind one API. Search the web through licensed Exa and Brave results, turn any public page into clean Markdown, convert PDF, DOCX, XLSX and PPTX files with per-page hashes, capture a page as a screenshot or PDF, transcribe an audio or video file with timestamps and subtitles, and generate CSS selectors that survive a site redesign. Every successful response is signed and carries a SHA-256 of what was read.\n\nEndpoints: Web Page to Clean Markdown; Web Search with Snippets (Exa and Brave); Document to Markdown with Page Hashes; Audio and Video URL Transcription; Web Page Screenshot and PDF; Self-Healing Scraper Selector Generator; Verify a Signed Result.\n\nEvery successful response is signed, and the Verify a Signed Result endpoint checks any of them. Documentation for every endpoint: https://writerslogic.com/agents/", "x-website": "https://writerslogic.com/agents/", "x-public": false, "x-thumbnail": "https://agents.writerslogic.com/logos/web.png", "x-version-lifecycle": "active" }, "servers": [ { "url": "https://agents.writerslogic.com/api", "description": "Base URL" } ], "components": {}, "paths": { "/v1/page-contents": { "post": { "operationId": "pageContents", "summary": "Web Page to Clean Markdown", "description": "`POST /v1/page-contents`\n\nFetches one public web page and returns its main content as GitHub-flavored Markdown or plain text, with title, canonical URL, language, absolute links and content hashes. Deterministic, no model. It does not run JavaScript, so client-rendered pages come back sparse, and it does not follow links.\n\n**What you get:** Token-efficient page text for an LLM without writing a scraper or an HTML cleaner.\n\n### Use it for\n\n- Feed a web page to a language model as clean Markdown instead of raw HTML, so it spends tokens on content and not on navigation and markup.\n- Build a reading or summarizing step that needs the page title, canonical URL, language and absolute links alongside the text.\n- Detect whether a page changed between two fetches by comparing the returned content and HTML SHA-256 hashes.\n\n### Details and limits\n\nFetches one public web page and returns its main content as clean GitHub-flavored Markdown or plain text, with title, canonical URL, language, absolute links and content hashes, for agents that feed pages to a model. Deterministic, no model. Does not run JavaScript (client-rendered pages come back sparse), does not follow links, does not consult robots.txt, and drops navigation, footers, sidebars and forms.\n\n### Request fields\n\nSend these as a JSON body.\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| `url` | string | yes | Public http(s) URL. |\n| `format` | enum | no | One of: markdown, text. Default \"markdown\". |\n| `max_chars` | integer | no | Content is cut to this many characters; truncated says whether it was. Default 60000. |\n| `include_links` | boolean | no | Keep Markdown links and return a links list (at most 200). Default true. |\n| `include_tables` | boolean | no | Convert data tables to GFM tables; false drops them. Default true. |\n\n### Example request body\n\n```json\n{\n \"url\": \"https://example.com/\",\n \"format\": \"markdown\",\n \"max_chars\": 20000\n}\n```\n\n### Request (curl)\n\n```bash\ncurl -X POST \"https://$RAPIDAPI_HOST/v1/page-contents\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-RapidAPI-Key: $RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: $RAPIDAPI_HOST\" \\\n -d '{\"url\":\"https://example.com/\",\"format\":\"markdown\",\"max_chars\":20000}'\n```\n\n### What comes back\n\nA 200 response is `{ \"data\": ..., \"_provenance\": ... }`. `_provenance` is a signed record of the sources read; the Verify a Signed Result endpoint checks it.\n\nFields of `data`:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `url` | string | URL. |\n| `final_url` | string | Final URL. |\n| `title` | string | Title. |\n| `canonical` | string, nullable | Canonical. |\n| `lang` | string, nullable | Lang. |\n| `description` | string, nullable | Description. |\n| `format` | enum | One of: markdown, text. |\n| `content` | string | Content. |\n| `word_count` | integer | Word count, a whole number. |\n| `truncated` | boolean | Truncated, true or false. |\n| `content_sha256` | string | Content SHA-256. |\n| `html_sha256` | string | HTML SHA-256. |\n| `links` | array of object | Links, a list of objects. |\n| `fetched_at` | string | Fetched at. |\n| `limits` | object | Limits, an object. |\n\nExample `data` from a real recorded call (long values shortened):\n\n```json\n{\n \"url\": \"https://example.com/\",\n \"final_url\": \"https://example.com/\",\n \"title\": \"Example Domain\",\n \"canonical\": null,\n \"lang\": \"en\",\n \"description\": null,\n \"format\": \"markdown\",\n \"content\": \"This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes.\",\n \"word_count\": 25,\n \"truncated\": false,\n \"content_sha256\": \"0a080719be9fbb82a86a45b80dc8c2a430fbe17dc93d23758debac092864d00f\",\n \"html_sha256\": \"25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484\",\n \"links\": [],\n \"fetched_at\": \"2026-11-06T17:55:19.431Z\"\n}\n```\n\n### HTTP response status codes\n\n- 200: success; the body is `{ \"data\": ..., \"_provenance\": ... }`.\n- 400: the request failed validation; `error` names the field and `code` is `invalid_request`.\n- 401: the RapidAPI key or subscription is missing or not valid for this API.\n- 429: the plan's rate limit was reached.\n- 5xx: the call failed on our side or at an upstream source; retry it.\n\nFull field-by-field documentation: https://writerslogic.com/agents/page-contents/\nMachine-readable input and result schemas: https://writerslogic.com/agents/page-contents.json", "x-sample-url": "https://agents.writerslogic.com/api/v1/samples/page-contents", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "minLength": 8, "maxLength": 2048, "description": "Public http(s) URL." }, "format": { "type": "string", "enum": [ "markdown", "text" ], "default": "markdown", "description": "One of: markdown, text." }, "max_chars": { "type": "integer", "minimum": 1000, "maximum": 200000, "default": 60000, "description": "Content is cut to this many characters; truncated says whether it was." }, "include_links": { "type": "boolean", "default": true, "description": "Keep Markdown links and return a links list (at most 200)." }, "include_tables": { "type": "boolean", "default": true, "description": "Convert data tables to GFM tables; false drops them." } }, "description": "Input payload for Page contents: URL to clean Markdown or text. Required fields: `url`. Optional fields: `format`, `max_chars`, `include_links`, `include_tables`.", "externalDocs": { "url": "https://writerslogic.com/agents/page-contents.json", "description": "Machine-readable record for Page contents: URL to clean Markdown or text: the full input and result JSON Schemas, an example payload and the OpenAPI operation." } }, "examples": { "default": { "summary": "Example request for Page contents: URL to clean Markdown or text", "description": "A complete valid request body for Web Page to Clean Markdown.", "value": { "url": "https://example.com/", "format": "markdown", "max_chars": 20000 } }, "Plain text without links": { "summary": "Plain text without links", "value": { "url": "https://example.com/", "format": "text", "include_links": false, "max_chars": 5000 } } } } }, "description": "JSON request body for Page contents: URL to clean Markdown or text. Required fields: `url`. Optional fields: `format`, `max_chars`, `include_links`, `include_tables`. Unknown fields are rejected with a 400." }, "responses": { "200": { "description": "Success. `data` holds the answer and `_provenance` holds the signed credential for it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "url": { "type": "string", "description": "URL." }, "final_url": { "type": "string", "description": "Final URL." }, "title": { "type": "string", "description": "Title." }, "canonical": { "type": "string", "nullable": true, "description": "Canonical." }, "lang": { "type": "string", "nullable": true, "description": "Lang." }, "description": { "type": "string", "nullable": true, "description": "Description." }, "format": { "type": "string", "enum": [ "markdown", "text" ], "description": "One of: markdown, text." }, "content": { "type": "string", "description": "Content." }, "word_count": { "type": "integer", "description": "Word count, a whole number." }, "truncated": { "type": "boolean", "description": "Truncated, true or false." }, "content_sha256": { "type": "string", "description": "Content SHA-256." }, "html_sha256": { "type": "string", "description": "HTML SHA-256." }, "links": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string", "description": "Text." }, "href": { "type": "string", "description": "Href." } } }, "description": "Links, a list of objects." }, "fetched_at": { "type": "string", "description": "Fetched at." }, "limits": { "type": "object", "properties": { "note": { "type": "string", "description": "Note." } }, "description": "Limits, an object." } }, "description": "Data, an object." }, "_provenance": { "type": "object", "description": "C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance" } }, "required": [ "data", "_provenance" ] }, "example": { "data": { "url": "https://example.com/", "final_url": "https://example.com/", "title": "Example Domain", "canonical": null, "lang": "en", "description": null, "format": "markdown", "content": "This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes.", "word_count": 25, "truncated": false, "content_sha256": "0a080719be9fbb82a86a45b80dc8c2a430fbe17dc93d23758debac092864d00f", "html_sha256": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484", "links": [], "fetched_at": "2026-11-06T17:55:19.431Z", "limits": { "note": "no JavaScript rendering; one request; robots.txt not consulted" } }, "_provenance": { "version": "writerslogic-provenance/1", "issuer": "did:web:agents.writerslogic.com", "verify": { "endpoint": "POST /api/v1/verify-provenance", "did": "did:web:agents.writerslogic.com" }, "manifest": { "format": "application/json", "instance_id": "xmp:iid:54fac44f-12e7-4547-a4ea-e892f4623ca6", "claim_generator_info": [ { "name": "WritersLogic x402 Agent Hub", "version": "2.0.0" } ], "title": "Page contents: URL to clean Markdown or text", "assertions": [ { "label": "c2pa.actions.v2", "data": { "actions": [ { "action": "c2pa.created", "when": "2026-11-06T17:55:19.443Z", "softwareAgent": { "name": "writerslogic-agent-hub/page-contents", "version": "2.0.0" }, "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia", "parameters": { "endpoint": "POST /api/v1/page-contents", "inputDigest": { "alg": "sha256", "hash": "df2ac97223ac0478b6c6621d7c8a3d7bfe33037cfa1c47749c89100794df07ef", "canonicalization": "JCS" } } } ] } }, { "label": "c2pa.hash.data", "data": { "alg": "sha256", "hash": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "name": "jcs-canonical-json(data)" } }, { "label": "c2pa.ingredient.v3", "data": { "title": "https://example.com/", "format": "text/html", "relationship": "inputTo", "dc": { "source": "https://example.com/", "date": "2026-11-06T17:55:19.443Z" }, "hash": { "alg": "sha256", "hash": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484", "basis": "body" } } } ] }, "credential": { "@context": [ "https://www.w3.org/ns/credentials/v2" ], "id": "urn:uuid:33216a77-d024-472f-ba4d-13438a2bf6ba", "type": [ "VerifiableCredential", "AgentOutputCredential" ], "issuer": "did:web:agents.writerslogic.com", "validFrom": "2026-11-06T17:55:19.443Z", "credentialSubject": { "id": "urn:sha256:d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "agent": "page-contents", "endpoint": "POST /api/v1/page-contents", "outputDigest": { "alg": "sha256", "value": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "canonicalization": "JCS" }, "inputDigest": { "alg": "sha256", "value": "df2ac97223ac0478b6c6621d7c8a3d7bfe33037cfa1c47749c89100794df07ef", "canonicalization": "JCS" }, "manifestDigest": { "alg": "sha256", "value": "b33ed80ac42f39ddcd72d0af27c6774f62350e93e3265b2d1bca01c0d71c584a", "canonicalization": "JCS" }, "ingredients": [ { "url": "https://example.com/", "sha256": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484" } ], "payment": { "scheme": "api-key", "network": "eip155:8453", "payer": "sample" } }, "proof": { "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "created": "2026-11-06T17:55:19.443Z", "verificationMethod": "did:web:agents.writerslogic.com#key-1", "proofPurpose": "assertionMethod", "proofValue": "z2AtwZQqTStnrRzCnCohybJ3cwRpsc52hhweLLPbdcHLTn7XXyD9sVRWD61uSpUsfJ88qSePKYKXyHT3vjxq4MtSZ" } }, "ethSignature": { "type": "EIP-191", "signer": "did:pkh:eip155:8453:0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "address": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "message": "writerslogic-provenance:153a58f215a0314d9fa994f7ab88cece46f678cca7e6f1628dab0638becfdbc4", "signature": "0x9c165b64d61abe9a39a0f131729fd98bb9059c9e22ac5d7df3499730b4efbe4d45f81df06f69e06888d4d80f2bb823857fcb52a4dc208ab7d37c02158bc65a621c" } } } } } }, "400": { "description": "Invalid request. The `error` field names the offending field and `code` is `invalid_request`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "401": { "description": "Missing or invalid RapidAPI key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "402": { "description": "Payment required. The request did not arrive through RapidAPI.", "content": { "application/json": { "schema": { "type": "object", "description": "x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)", "properties": { "x402Version": { "type": "integer" }, "error": { "type": "string" }, "code": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } } } } } }, "502": { "description": "A source or model this endpoint depends on failed. Retry later; the body carries an `error` message and a `code`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } }, "externalDocs": { "url": "https://writerslogic.com/agents/page-contents/", "description": "Documentation for Page contents: URL to clean Markdown or text: what it does, every input and result field, an example call and the response shape. A free signed sample response is linked from the page." }, "x-tests": [ { "name": "page-contents: unknown field is rejected", "method": "POST", "path": "/v1/page-contents", "body": { "nonsense": true }, "assert": { "status": 400, "json": { "code": "invalid_request" }, "maxMs": 10000 } }, { "name": "page-contents: example returns a signed result", "method": "POST", "path": "/v1/page-contents", "body": { "url": "https://example.com/", "format": "markdown", "max_chars": 20000 }, "assert": { "status": 200, "jsonPathsExist": [ "data", "_provenance.credential" ], "jsonSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "url": { "type": "string" }, "final_url": { "type": "string" }, "title": { "type": "string" }, "canonical": { "type": [ "string", "null" ] }, "lang": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "format": { "type": "string", "enum": [ "markdown", "text" ] }, "content": { "type": "string" }, "word_count": { "type": "integer" }, "truncated": { "type": "boolean" }, "content_sha256": { "type": "string" }, "html_sha256": { "type": "string" }, "links": { "type": "array", "items": { "type": "object", "properties": { "text": { "type": "string" }, "href": { "type": "string" } } } }, "fetched_at": { "type": "string" }, "limits": { "type": "object", "properties": { "note": { "type": "string" } } } } }, "_provenance": { "type": "object" } }, "required": [ "data", "_provenance" ] }, "maxMs": 120000 } } ] } }, "/v1/web-search": { "post": { "operationId": "webSearch", "summary": "Web Search with Snippets (Exa and Brave)", "description": "`POST /v1/web-search`\n\nRuns a web search through a licensed search API (Exa or Brave) and returns up to 10 ranked results with title, URL, snippet, highlights and published date. It does not scrape search engines, does not fetch or summarize the result pages (use the page contents endpoint for that) and does not use a model.\n\n**What you get:** Current web results from a licensed index in one call, without a search-API account or key.\n\n### Use it for\n\n- Give an agent current links on any topic without it holding its own search API account.\n- Limit research to one site, or to results published after a date, with the site and date filters.\n- Pair it with Web Page to Clean Markdown: search first, then read the best results.\n\n### Details and limits\n\nRuns a web search through a licensed search API (Exa or Brave) and returns up to 10 ranked results with title, URL, snippet, highlights and published date, for agents that need current links. Does not scrape search engines, does not fetch or summarize the result pages (use page-contents for that), and does not use a model.\n\n### Request fields\n\nSend these as a JSON body.\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| `query` | string | yes | Search query. |\n| `num_results` | integer | no | Num results, a whole number. Between 1 and 10. Default 5. |\n| `provider` | enum | no | auto uses Exa when configured, else Brave. Default \"auto\". |\n| `include_text` | boolean | no | Ask the provider for highlights/extra snippet text per result. Default false. |\n| `site` | string | no | Restrict to a domain, for example example.com. |\n| `date_from` | string | no | Only results published on or after this date, YYYY-MM-DD. |\n\n### Example request body\n\n```json\n{\n \"query\": \"x402 payment protocol HTTP 402\",\n \"num_results\": 5,\n \"include_text\": true\n}\n```\n\n### Request (curl)\n\n```bash\ncurl -X POST \"https://$RAPIDAPI_HOST/v1/web-search\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-RapidAPI-Key: $RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: $RAPIDAPI_HOST\" \\\n -d '{\"query\":\"x402 payment protocol HTTP 402\",\"num_results\":5,\"include_text\":true}'\n```\n\n### What comes back\n\nA 200 response is `{ \"data\": ..., \"_provenance\": ... }`. `_provenance` is a signed record of the sources read; the Verify a Signed Result endpoint checks it.\n\nFields of `data`:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `provider` | enum | One of: exa, brave. |\n| `query` | string | Query. |\n| `query_sha256` | string | Query SHA-256. |\n| `results` | array of object | Results, a list of objects. |\n| `result_count` | integer | Result count, a whole number. |\n| `fetched_at` | string | Fetched at. |\n| `limits` | object | Limits, an object. |\n\nExample `data` from a real recorded call (long values shortened):\n\n```json\n{\n \"provider\": \"exa\",\n \"query\": \"x402 payment protocol HTTP 402\",\n \"query_sha256\": \"9e0fb05be25f021acb7c3b84fc8c81ff87031b8d2b6405863483d50443238ba0\",\n \"results\": [\n {\n \"rank\": 1,\n \"title\": \"x402\",\n \"url\": \"https://x402.org/\",\n \"snippet\": \"image_animation=”none” border_type=”simple” column_border_width=”none” column_border_color=”#000000″ column_border_style=”solid” column_padding_type=”default...\",\n \"highlights\": [\n \"image_animation=”none” border_type=”simple” column_border_width=”none” column_border_color=”#000000″ column_border_style=”solid” column_padding_type=”default...\"\n ],\n \"published_date\": null,\n \"snippet_sha256\": \"6ef3bbd706ed12c9c7f716debd19eaeda1083bef185c37ab17de39cd6b0e35af\"\n },\n {\n \"rank\": 2,\n \"title\": \"\",\n \"url\": \"https://docs.cdp.coinbase.com/x402/core-concepts/how-it-works\",\n \"snippet\": \"x402 enables programmatic payments over ... 2. **Server responds with 402** - The resource server returns an HTTP 402 Payment Required status code with payme...\",\n \"highlights\": [\n \"x402 enables programmatic payments over ... 2. **Server responds with 402** - The resource server returns an HTTP 402 Payment Required status code with payme...\"\n ],\n \"published_date\": null,\n \"snippet_sha256\": \"df9e834edb5b289527f7e9fb933fbd806e27cabfdbea1c77771ab650ef468989\"\n },\n {\n \"rank\": 3,\n \"title\": \"x402-foundation/x402\",\n \"url\": \"https://github.com/x402-foundation/x402/\",\n \"snippet\": \"1. `Client` makes an HTTP request to a `resource server`. ... . 3. `Client` selects one of the `PaymentRequirements` returned by the server response and crea...\",\n \"highlights\": [\n \"1. `Client` makes an HTTP request to a `resource server`. ... . 3. `Client` selects one of the `PaymentRequirements` returned by the server response and crea...\"\n ],\n \"published_date\": null,\n \"snippet_sha256\": \"30d81dfd1ec231a08618c8203ef6c5e401687fe8508102909c7fdf1bfb7c09a8\"\n }\n ],\n \"result_count\": 5,\n \"fetched_at\": \"2026-11-06T17:57:04.325Z\",\n \"limits\": {\n \"note\": \"Ranking and snippets are the provider's at fetched_at; pages themselves are not fetched (use page-contents for that). published_date is the provider's value ...\"\n }\n}\n```\n\n### HTTP response status codes\n\n- 200: success; the body is `{ \"data\": ..., \"_provenance\": ... }`.\n- 400: the request failed validation; `error` names the field and `code` is `invalid_request`.\n- 401: the RapidAPI key or subscription is missing or not valid for this API.\n- 429: the plan's rate limit was reached.\n- 5xx: the call failed on our side or at an upstream source; retry it.\n\nFull field-by-field documentation: https://writerslogic.com/agents/web-search/\nMachine-readable input and result schemas: https://writerslogic.com/agents/web-search.json", "x-sample-url": "https://agents.writerslogic.com/api/v1/samples/web-search", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "query" ], "properties": { "query": { "type": "string", "minLength": 1, "maxLength": 400, "description": "Search query." }, "num_results": { "type": "integer", "minimum": 1, "maximum": 10, "default": 5, "description": "Num results, a whole number. Between 1 and 10." }, "provider": { "type": "string", "enum": [ "auto", "exa", "brave" ], "default": "auto", "description": "auto uses Exa when configured, else Brave." }, "include_text": { "type": "boolean", "default": false, "description": "Ask the provider for highlights/extra snippet text per result." }, "site": { "type": "string", "maxLength": 253, "description": "Restrict to a domain, for example example.com." }, "date_from": { "type": "string", "maxLength": 10, "description": "Only results published on or after this date, YYYY-MM-DD." } }, "description": "Input payload for Web search: licensed Exa/Brave results with snippets. Required fields: `query`. Optional fields: `num_results`, `provider`, `include_text`, `site`, `date_from`.", "externalDocs": { "url": "https://writerslogic.com/agents/web-search.json", "description": "Machine-readable record for Web search: licensed Exa/Brave results with snippets: the full input and result JSON Schemas, an example payload and the OpenAPI operation." } }, "examples": { "default": { "summary": "Example request for Web search: licensed Exa/Brave results with snippets", "description": "A complete valid request body for Web Search with Snippets (Exa and Brave).", "value": { "query": "x402 payment protocol HTTP 402", "num_results": 5, "include_text": true } }, "Search one site": { "summary": "Search one site", "value": { "query": "x402 payment protocol", "num_results": 5, "site": "github.com" } } } } }, "description": "JSON request body for Web search: licensed Exa/Brave results with snippets. Required fields: `query`. Optional fields: `num_results`, `provider`, `include_text`, `site`, `date_from`. Unknown fields are rejected with a 400." }, "responses": { "200": { "description": "Success. `data` holds the answer and `_provenance` holds the signed credential for it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "exa", "brave" ], "description": "One of: exa, brave." }, "query": { "type": "string", "description": "Query." }, "query_sha256": { "type": "string", "description": "Query SHA-256." }, "results": { "type": "array", "items": { "type": "object", "properties": { "rank": { "type": "integer", "description": "Rank, a whole number." }, "title": { "type": "string", "description": "Title." }, "url": { "type": "string", "description": "URL." }, "snippet": { "type": "string", "description": "May be empty." }, "highlights": { "type": "array", "items": { "type": "string" }, "description": "Highlights, a list of strings." }, "published_date": { "type": "string", "description": "Provider value, or null.", "nullable": true }, "snippet_sha256": { "type": "string", "description": "sha256 of snippet and highlights joined by newlines." } } }, "description": "Results, a list of objects." }, "result_count": { "type": "integer", "description": "Result count, a whole number." }, "fetched_at": { "type": "string", "description": "Fetched at." }, "limits": { "type": "object", "properties": { "note": { "type": "string", "description": "Note." } }, "description": "Limits, an object." } }, "description": "Data, an object." }, "_provenance": { "type": "object", "description": "C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance" } }, "required": [ "data", "_provenance" ] }, "example": { "data": { "provider": "exa", "query": "x402 payment protocol HTTP 402", "query_sha256": "9e0fb05be25f021acb7c3b84fc8c81ff87031b8d2b6405863483d50443238ba0", "results": [ { "rank": 1, "title": "x402", "url": "https://x402.org/", "snippet": "image_animation=”none” border_type=”simple” column_border_width=”none” column_border_color=”#000000″ column_border_style=”solid” column_padding_type=”default” content_layout=”default” gradient_type=”default”][vc_column_text text_direction=”", "highlights": [ "image_animation=”none” border_type=”simple” column_border_width=”none” column_border_color=”#000000″ column_border_style=”solid” column_padding_type=”default” content_layout=”default” gradient_type=”default”][vc_column_text text_direction=”" ], "published_date": null, "snippet_sha256": "6ef3bbd706ed12c9c7f716debd19eaeda1083bef185c37ab17de39cd6b0e35af" }, { "rank": 2, "title": "", "url": "https://docs.cdp.coinbase.com/x402/core-concepts/how-it-works", "snippet": "x402 enables programmatic payments over ... 2. **Server responds with 402** - The resource server returns an HTTP 402 Payment Required status code with payment requirements in the `PAYMENT-REQUIRED` header. ... **Client creates payment** - The client examines the payment requirements and creates ...", "highlights": [ "x402 enables programmatic payments over ... 2. **Server responds with 402** - The resource server returns an HTTP 402 Payment Required status code with payment requirements in the `PAYMENT-REQUIRED` header. ... **Client creates payment** - The client examines the payment requirements and creates ..." ], "published_date": null, "snippet_sha256": "df9e834edb5b289527f7e9fb933fbd806e27cabfdbea1c77771ab650ef468989" }, { "rank": 3, "title": "x402-foundation/x402", "url": "https://github.com/x402-foundation/x402/", "snippet": "1. `Client` makes an HTTP request to a `resource server`. ... . 3. `Client` selects one of the `PaymentRequirements` returned by the server response and creates a ... . 4. `Client` sends the HTTP request with the `PAYMENT-SIGNATURE` header containing the", "highlights": [ "1. `Client` makes an HTTP request to a `resource server`. ... . 3. `Client` selects one of the `PaymentRequirements` returned by the server response and creates a ... . 4. `Client` sends the HTTP request with the `PAYMENT-SIGNATURE` header containing the" ], "published_date": null, "snippet_sha256": "30d81dfd1ec231a08618c8203ef6c5e401687fe8508102909c7fdf1bfb7c09a8" } ], "result_count": 5, "fetched_at": "2026-11-06T17:57:04.325Z", "limits": { "note": "Ranking and snippets are the provider's at fetched_at; pages themselves are not fetched (use page-contents for that). published_date is the provider's value and may be null. Brave snippets come from the search index, Exa returns highlights only when include_text is true." } }, "_provenance": { "version": "writerslogic-provenance/1", "issuer": "did:web:agents.writerslogic.com", "verify": { "endpoint": "POST /api/v1/verify-provenance", "did": "did:web:agents.writerslogic.com" }, "manifest": { "format": "application/json", "instance_id": "xmp:iid:f048cc57-fddf-4543-ae5b-ee38ad73433e", "claim_generator_info": [ { "name": "WritersLogic x402 Agent Hub", "version": "2.0.0" } ], "title": "Web search: licensed Exa/Brave results with snippets", "assertions": [ { "label": "c2pa.actions.v2", "data": { "actions": [ { "action": "c2pa.created", "when": "2026-11-06T17:57:04.417Z", "softwareAgent": { "name": "writerslogic-agent-hub/web-search", "version": "2.0.0" }, "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia", "parameters": { "endpoint": "POST /api/v1/web-search", "inputDigest": { "alg": "sha256", "hash": "5ef3bbaf5cc97e4d529de51508b6f20e906439dbc6b297154ca2f4932005e283", "canonicalization": "JCS" } } } ] } }, { "label": "c2pa.hash.data", "data": { "alg": "sha256", "hash": "2b1036a64094bfedad6fd9a94863bfb71a01474a7af64f3778fdc69e401112ab", "name": "jcs-canonical-json(data)" } }, { "label": "c2pa.ingredient.v3", "data": { "title": "https://api.exa.ai/search", "format": "application/json", "relationship": "inputTo", "dc": { "source": "https://api.exa.ai/search", "date": "2026-11-06T17:57:04.417Z" }, "hash": { "alg": "sha256", "hash": "e77a3d4d1fee32a26c64c87fe5526434d3b9ad812245eaff06fc3d5de2fa45a4", "basis": "body" } } } ] }, "credential": { "@context": [ "https://www.w3.org/ns/credentials/v2" ], "id": "urn:uuid:525b1801-a793-4141-852b-32a33bf05352", "type": [ "VerifiableCredential", "AgentOutputCredential" ], "issuer": "did:web:agents.writerslogic.com", "validFrom": "2026-11-06T17:57:04.417Z", "credentialSubject": { "id": "urn:sha256:2b1036a64094bfedad6fd9a94863bfb71a01474a7af64f3778fdc69e401112ab", "agent": "web-search", "endpoint": "POST /api/v1/web-search", "outputDigest": { "alg": "sha256", "value": "2b1036a64094bfedad6fd9a94863bfb71a01474a7af64f3778fdc69e401112ab", "canonicalization": "JCS" }, "inputDigest": { "alg": "sha256", "value": "5ef3bbaf5cc97e4d529de51508b6f20e906439dbc6b297154ca2f4932005e283", "canonicalization": "JCS" }, "manifestDigest": { "alg": "sha256", "value": "b2042b2cb07e665b553c3025221bcd5eacf17ff156d5307ede3527f12dcc8495", "canonicalization": "JCS" }, "ingredients": [ { "url": "https://api.exa.ai/search", "sha256": "e77a3d4d1fee32a26c64c87fe5526434d3b9ad812245eaff06fc3d5de2fa45a4" } ], "payment": { "scheme": "api-key", "network": "eip155:8453", "payer": "sample" } }, "proof": { "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "created": "2026-11-06T17:57:04.417Z", "verificationMethod": "did:web:agents.writerslogic.com#key-1", "proofPurpose": "assertionMethod", "proofValue": "z33QL43mzgVbzKEUHhcFVQqnJVvi9aHapJM2kyXZemnWyeEq5EZ18g1RCQLcrYgg4KmZ9TnGGnB3gjRMNdRbAP5Ys" } }, "ethSignature": { "type": "EIP-191", "signer": "did:pkh:eip155:8453:0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "address": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "message": "writerslogic-provenance:3a4aa3437e523ec27e8a2f8a970f89694ce20e0268343fa355ba5b6b25d4322a", "signature": "0x13f1bdf708400fbd78c9af498646334b20e4073446e303410cd4cfd117f8a9f23d1fb6010f7bb2d03c9558d1282d34c63d45be4523ad61b510983c1f146d9ba71b" } } } } } }, "400": { "description": "Invalid request. The `error` field names the offending field and `code` is `invalid_request`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "401": { "description": "Missing or invalid RapidAPI key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "402": { "description": "Payment required. The request did not arrive through RapidAPI.", "content": { "application/json": { "schema": { "type": "object", "description": "x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)", "properties": { "x402Version": { "type": "integer" }, "error": { "type": "string" }, "code": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } } } } } }, "502": { "description": "A source or model this endpoint depends on failed. Retry later; the body carries an `error` message and a `code`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } }, "externalDocs": { "url": "https://writerslogic.com/agents/web-search/", "description": "Documentation for Web search: licensed Exa/Brave results with snippets: what it does, every input and result field, an example call and the response shape. A free signed sample response is linked from the page." }, "x-tests": [ { "name": "web-search: unknown field is rejected", "method": "POST", "path": "/v1/web-search", "body": { "nonsense": true }, "assert": { "status": 400, "json": { "code": "invalid_request" }, "maxMs": 10000 } }, { "name": "web-search: example returns a signed result", "method": "POST", "path": "/v1/web-search", "body": { "query": "x402 payment protocol HTTP 402", "num_results": 5, "include_text": true }, "assert": { "status": 200, "jsonPathsExist": [ "data", "_provenance.credential" ], "jsonSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "provider": { "type": "string", "enum": [ "exa", "brave" ] }, "query": { "type": "string" }, "query_sha256": { "type": "string" }, "results": { "type": "array", "items": { "type": "object", "properties": { "rank": { "type": "integer" }, "title": { "type": "string" }, "url": { "type": "string" }, "snippet": { "type": "string" }, "highlights": { "type": "array", "items": { "type": "string" } }, "published_date": { "type": [ "string", "null" ] }, "snippet_sha256": { "type": "string" } } } }, "result_count": { "type": "integer" }, "fetched_at": { "type": "string" }, "limits": { "type": "object", "properties": { "note": { "type": "string" } } } } }, "_provenance": { "type": "object" } }, "required": [ "data", "_provenance" ] }, "maxMs": 120000 } } ] } }, "/v1/doc-to-markdown": { "post": { "operationId": "docToMarkdown", "summary": "Document to Markdown with Page Hashes", "description": "`POST /v1/doc-to-markdown`\n\nConverts a PDF (text layer), DOCX, XLSX or PPTX file, or normalizes HTML, Markdown, text, CSV or JSON, into Markdown or plain text. Give an https URL or up to 4 MB as base64. Returns one unit per page, sheet or slide with its exact character range and SHA-256, so later quotes and citations can anchor to a page.\n\n**What you get:** Agents cannot cite a page they cannot locate. This returns readable Markdown with a verifiable hash and character range per page, and flags scanned pages that need OCR instead of silently returning nothing.\n\n### Use it for\n\n- Turn contracts, reports, spreadsheets and slide decks into Markdown an agent can read.\n- Cite a specific page, sheet or slide by its exact character range and SHA-256 hash.\n- Find out which scanned PDF pages need OCR before relying on the extracted text.\n\n### Details and limits\n\nConverts a PDF (text layer), DOCX, XLSX or PPTX file, or normalizes an HTML, Markdown, text, CSV or JSON file, into Markdown (or plain text) for an agent that must read or cite a document. Give an https URL or up to 4 MB as base64. Returns the content plus one unit per page, sheet or slide with its exact character range in the content and a SHA-256 of that unit's text, so later quote and citation checks can anchor to a page. Headings, lists, tables and links are kept for DOCX; sheets become tables; slides become sections. Set describe to also get a suggested descriptive file name, tags and a one-line summary (a fast model reads the first 6,000 characters; its quotes are checked against the text). It does NOT run OCR: scanned PDF pages are flagged needs_ocr and come back empty. Images, comments, notes, headers and footers are ignored, legacy .doc/.xls/.ppt and password-protected files are refused, and ZIP64 is unsupported.\n\n### Request fields\n\nSend these as a JSON body.\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| `url` | string | no | https URL of the document. Provide this or content_base64. |\n| `content_base64` | string | no | Standard padded base64 of the file, at most 4 MB decoded. Provide this or url. |\n| `filename` | string | no | Original file name; helps format detection and is kept as the extension of the suggested name. |\n| `format` | enum | no | markdown (default) or text (Markdown syntax removed). |\n| `pages` | string | no | Page, sheet or slide selection such as \"1-5,8\", at most 200 pages. Default: the first 200. |\n| `max_chars` | integer | no | Output cap in characters, cut at a unit boundary. Default 120000. |\n| `describe` | boolean | no | Also suggest a file name, tags and a summary with a language model. Default false. |\n\n### Example request body\n\n```json\n{\n \"url\": \"https://www.irs.gov/pub/irs-pdf/fw9.pdf\",\n \"pages\": \"1-2\",\n \"max_chars\": 20000,\n \"describe\": true\n}\n```\n\n### Request (curl)\n\n```bash\ncurl -X POST \"https://$RAPIDAPI_HOST/v1/doc-to-markdown\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-RapidAPI-Key: $RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: $RAPIDAPI_HOST\" \\\n -d '{\"url\":\"https://www.irs.gov/pub/irs-pdf/fw9.pdf\",\"pages\":\"1-2\",\"max_chars\":20000,\"describe\":true}'\n```\n\n### What comes back\n\nA 200 response is `{ \"data\": ..., \"_provenance\": ... }`. `_provenance` is a signed record of the sources read; the Verify a Signed Result endpoint checks it.\n\nFields of `data`:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `source` | object | kind (url\\|inline), final url, filename, detected media_type, bytes and sha256 of the input file. |\n| `document_kind` | enum | One of: pdf, docx, xlsx, pptx, html, markdown, text, csv, json. |\n| `format` | enum | One of: markdown, text. |\n| `content` | string | The converted document; units are joined by a blank line. |\n| `units` | array of object | Units, a list of objects. |\n| `unit_count` | integer | Units returned. |\n| `units_total` | integer | Units in the document. |\n| `metadata` | object, nullable | title, author, created, modified, page_count; null when absent. |\n| `tables_count` | integer | Tables count, a whole number. |\n| `truncated` | boolean | True when max_chars, a page cap, a row cap or the time budget left content out. |\n| `notes` | array of string | Notes, a list of strings. |\n| `deterministic` | boolean | True when no model was used for this result. |\n| `describe` | object | With describe=true: suggested_filename, doc_type, tags, summary and evidence_quotes verified to appear in the content; null otherwise or when the model is unavailable. |\n| `llm` | object | status (ok\\|skipped\\|unavailable), provider and model when ok, reason when unavailable. |\n| `limits` | object | max_bytes, max_chars, offsets convention and what is not covered. |\n\nExample `data` from a real recorded call (long values shortened):\n\n```json\n{\n \"source\": {\n \"kind\": \"url\",\n \"url\": \"https://www.irs.gov/pub/irs-pdf/fw9.pdf\",\n \"filename\": \"fw9.pdf\",\n \"media_type\": \"application/pdf\",\n \"bytes\": 140815,\n \"sha256\": \"2d420cbb4123dcf1fb82595b2359cfbb5d81f00b9df9d359fcc7af361d093f53\"\n },\n \"document_kind\": \"pdf\",\n \"format\": \"markdown\",\n \"content\": \"Form W-9(Rev. March 2024)\\nRequest for Taxpayer\\nIdentification Number and Certification\\nDepartment of the Treasury\\nInternal Revenue Service Go to www.irs.gov/...\",\n \"units\": [\n {\n \"index\": 1,\n \"label\": \"page 1\",\n \"char_start\": 0,\n \"char_end\": 5658,\n \"sha256\": \"c51223798908963227f21801aeda7ed090dcc3c4a1d59b664a7123b6022fa54e\",\n \"needs_ocr\": false,\n \"truncated\": false\n },\n {\n \"index\": 2,\n \"label\": \"page 2\",\n \"char_start\": 5660,\n \"char_end\": 13828,\n \"sha256\": \"19a19bd9e35bb6e926f7e5bd1c3412cfbc8d21c08551c33f34adc869f98e812d\",\n \"needs_ocr\": false,\n \"truncated\": false\n }\n ],\n \"unit_count\": 2,\n \"units_total\": 6,\n \"metadata\": {\n \"title\": \"Form W-9 (Rev. March 2024)\",\n \"author\": \"SE:W:CAR:MP\",\n \"created\": \"2024-03-06T08:18:13-05:00\",\n \"modified\": \"2024-03-06T08:18:13-05:00\",\n \"page_count\": 6\n },\n \"tables_count\": 0,\n \"truncated\": false,\n \"notes\": [],\n \"deterministic\": false,\n \"describe\": {\n \"suggested_filename\": \"irs-form-w-9-request-for-taxpayer-identification-number-and-certification-rev-ma.pdf\",\n \"doc_type\": \"tax form\",\n \"tags\": [\n \"irs\",\n \"form w-9\",\n \"taxpayer identification number\"\n ],\n \"summary\": \"This is the IRS Form W-9 (Rev. March 2024), used by requesters to obtain a taxpayer identification number and certification from payees.\",\n \"evidence_quotes\": [\n \"Form W-9(Rev. March 2024)\",\n \"Request for Taxpayer Identification Number and Certification\",\n \"Give form to the requester. Do not send to the IRS.\"\n ]\n },\n \"llm\": {\n \"status\": \"ok\",\n \"provider\": \"openrouter\",\n \"model\": \"anthropic/claude-haiku-5.5\"\n }\n}\n```\n\n### HTTP response status codes\n\n- 200: success; the body is `{ \"data\": ..., \"_provenance\": ... }`.\n- 400: the request failed validation; `error` names the field and `code` is `invalid_request`.\n- 401: the RapidAPI key or subscription is missing or not valid for this API.\n- 429: the plan's rate limit was reached.\n- 5xx: the call failed on our side or at an upstream source; retry it.\n\nFull field-by-field documentation: https://writerslogic.com/agents/doc-to-markdown/\nMachine-readable input and result schemas: https://writerslogic.com/agents/doc-to-markdown.json", "x-sample-url": "https://agents.writerslogic.com/api/v1/samples/doc-to-markdown", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "url": { "type": "string", "minLength": 1, "maxLength": 2048, "description": "https URL of the document. Provide this or content_base64." }, "content_base64": { "type": "string", "minLength": 1, "maxLength": 5592408, "description": "Standard padded base64 of the file, at most 4 MB decoded. Provide this or url." }, "filename": { "type": "string", "minLength": 1, "maxLength": 255, "description": "Original file name; helps format detection and is kept as the extension of the suggested name." }, "format": { "type": "string", "enum": [ "markdown", "text" ], "description": "markdown (default) or text (Markdown syntax removed)." }, "pages": { "type": "string", "maxLength": 1000, "description": "Page, sheet or slide selection such as \"1-5,8\", at most 200 pages. Default: the first 200." }, "max_chars": { "type": "integer", "minimum": 1000, "maximum": 400000, "description": "Output cap in characters, cut at a unit boundary. Default 120000." }, "describe": { "type": "boolean", "description": "Also suggest a file name, tags and a summary with a language model. Default false." } }, "description": "Input payload for Document to Markdown with per-page hashes and offsets. Required fields: none. Optional fields: `url`, `content_base64`, `filename`, `format`, `pages`, `max_chars`, `describe`.", "externalDocs": { "url": "https://writerslogic.com/agents/doc-to-markdown.json", "description": "Machine-readable record for Document to Markdown with per-page hashes and offsets: the full input and result JSON Schemas, an example payload and the OpenAPI operation." } }, "examples": { "default": { "summary": "Example request for Document to Markdown with per-page hashes and offsets", "description": "A complete valid request body for Document to Markdown with Page Hashes.", "value": { "url": "https://www.irs.gov/pub/irs-pdf/fw9.pdf", "pages": "1-2", "max_chars": 20000, "describe": true } }, "A PDF by URL": { "summary": "A PDF by URL", "value": { "url": "https://pdfobject.com/pdf/sample.pdf", "format": "markdown" } } } } }, "description": "JSON request body for Document to Markdown with per-page hashes and offsets. Required fields: none. Optional fields: `url`, `content_base64`, `filename`, `format`, `pages`, `max_chars`, `describe`. Unknown fields are rejected with a 400." }, "responses": { "200": { "description": "Success. `data` holds the answer and `_provenance` holds the signed credential for it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "source": { "type": "object", "description": "kind (url|inline), final url, filename, detected media_type, bytes and sha256 of the input file." }, "document_kind": { "type": "string", "enum": [ "pdf", "docx", "xlsx", "pptx", "html", "markdown", "text", "csv", "json" ], "description": "One of: pdf, docx, xlsx, pptx, html, markdown, text, csv, json." }, "format": { "type": "string", "enum": [ "markdown", "text" ], "description": "One of: markdown, text." }, "content": { "type": "string", "description": "The converted document; units are joined by a blank line." }, "units": { "type": "array", "items": { "type": "object", "description": "index (page/sheet/slide number), label, char_start, char_end (content.slice(char_start, char_end) is the unit), sha256 of that text, needs_ocr, truncated." }, "description": "Units, a list of objects." }, "unit_count": { "type": "integer", "description": "Units returned." }, "units_total": { "type": "integer", "description": "Units in the document." }, "metadata": { "type": "object", "description": "title, author, created, modified, page_count; null when absent.", "nullable": true }, "tables_count": { "type": "integer", "description": "Tables count, a whole number." }, "truncated": { "type": "boolean", "description": "True when max_chars, a page cap, a row cap or the time budget left content out." }, "notes": { "type": "array", "items": { "type": "string" }, "description": "Notes, a list of strings." }, "deterministic": { "type": "boolean", "description": "True when no model was used for this result." }, "describe": { "type": "object", "description": "With describe=true: suggested_filename, doc_type, tags, summary and evidence_quotes verified to appear in the content; null otherwise or when the model is unavailable." }, "llm": { "type": "object", "description": "status (ok|skipped|unavailable), provider and model when ok, reason when unavailable." }, "limits": { "type": "object", "description": "max_bytes, max_chars, offsets convention and what is not covered." } }, "description": "Data, an object." }, "_provenance": { "type": "object", "description": "C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance" } }, "required": [ "data", "_provenance" ] }, "example": { "data": { "source": { "kind": "url", "url": "https://www.irs.gov/pub/irs-pdf/fw9.pdf", "filename": "fw9.pdf", "media_type": "application/pdf", "bytes": 140815, "sha256": "2d420cbb4123dcf1fb82595b2359cfbb5d81f00b9df9d359fcc7af361d093f53" }, "document_kind": "pdf", "format": "markdown", "content": "Form W-9(Rev. March 2024)\nRequest for Taxpayer\nIdentification Number and Certification\nDepartment of the Treasury\nInternal Revenue Service Go to www.irs.gov/FormW9 for instructions and the latest information.\nGive form to the\nrequester. Do not\nsend to the IRS.\nBefore you begin. For guidance relat...", "units": [ { "index": 1, "label": "page 1", "char_start": 0, "char_end": 5658, "sha256": "c51223798908963227f21801aeda7ed090dcc3c4a1d59b664a7123b6022fa54e", "needs_ocr": false, "truncated": false }, { "index": 2, "label": "page 2", "char_start": 5660, "char_end": 13828, "sha256": "19a19bd9e35bb6e926f7e5bd1c3412cfbc8d21c08551c33f34adc869f98e812d", "needs_ocr": false, "truncated": false } ], "unit_count": 2, "units_total": 6, "metadata": { "title": "Form W-9 (Rev. March 2024)", "author": "SE:W:CAR:MP", "created": "2024-03-06T08:18:13-05:00", "modified": "2024-03-06T08:18:13-05:00", "page_count": 6 }, "tables_count": 0, "truncated": false, "notes": [], "deterministic": false, "describe": { "suggested_filename": "irs-form-w-9-request-for-taxpayer-identification-number-and-certification-rev-ma.pdf", "doc_type": "tax form", "tags": [ "irs", "form w-9", "taxpayer identification number" ], "summary": "This is the IRS Form W-9 (Rev. March 2024), used by requesters to obtain a taxpayer identification number and certification from payees.", "evidence_quotes": [ "Form W-9(Rev. March 2024)", "Request for Taxpayer Identification Number and Certification", "Give form to the requester. Do not send to the IRS." ] }, "llm": { "status": "ok", "provider": "openrouter", "model": "anthropic/claude-haiku-5.5" }, "limits": { "max_bytes": 4194304, "max_chars": 20000, "note": "text layer only, no OCR; images ignored; ZIP64 unsupported", "offsets": "char_start/char_end are UTF-16 code unit offsets into content" } }, "_provenance": { "version": "writerslogic-provenance/1", "issuer": "did:web:agents.writerslogic.com", "verify": { "endpoint": "POST /api/v1/verify-provenance", "did": "did:web:agents.writerslogic.com" }, "manifest": { "format": "application/json", "instance_id": "xmp:iid:c0271ee7-7190-4ace-a198-7b2e13d8758d", "claim_generator_info": [ { "name": "WritersLogic x402 Agent Hub", "version": "2.0.0" } ], "title": "Document to Markdown with per-page hashes and offsets", "assertions": [ { "label": "c2pa.actions.v2", "data": { "actions": [ { "action": "c2pa.created", "when": "2026-11-06T17:55:22.802Z", "softwareAgent": { "name": "writerslogic-agent-hub/doc-to-markdown", "version": "2.0.0" }, "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia", "parameters": { "endpoint": "POST /api/v1/doc-to-markdown", "inputDigest": { "alg": "sha256", "hash": "fb1a5e97353303315b25c99cdb4536f37f40c0ec9d7957250bfb2ec499b67c7b", "canonicalization": "JCS" } } } ] } }, { "label": "c2pa.hash.data", "data": { "alg": "sha256", "hash": "bcf646d56de239d68a540a4b0ed474a807e14eaa2fbb79ae12536dc5e74c9d50", "name": "jcs-canonical-json(data)" } }, { "label": "c2pa.ingredient.v3", "data": { "title": "https://www.irs.gov/pub/irs-pdf/fw9.pdf", "format": "application/pdf", "relationship": "inputTo", "dc": { "source": "https://www.irs.gov/pub/irs-pdf/fw9.pdf", "date": "2026-11-06T17:55:19.769Z" }, "hash": { "alg": "sha256", "hash": "2d420cbb4123dcf1fb82595b2359cfbb5d81f00b9df9d359fcc7af361d093f53", "basis": "body" } } } ] }, "credential": { "@context": [ "https://www.w3.org/ns/credentials/v2" ], "id": "urn:uuid:297f3a93-042b-4695-b402-f6461b5b0338", "type": [ "VerifiableCredential", "AgentOutputCredential" ], "issuer": "did:web:agents.writerslogic.com", "validFrom": "2026-11-06T17:55:22.802Z", "credentialSubject": { "id": "urn:sha256:bcf646d56de239d68a540a4b0ed474a807e14eaa2fbb79ae12536dc5e74c9d50", "agent": "doc-to-markdown", "endpoint": "POST /api/v1/doc-to-markdown", "outputDigest": { "alg": "sha256", "value": "bcf646d56de239d68a540a4b0ed474a807e14eaa2fbb79ae12536dc5e74c9d50", "canonicalization": "JCS" }, "inputDigest": { "alg": "sha256", "value": "fb1a5e97353303315b25c99cdb4536f37f40c0ec9d7957250bfb2ec499b67c7b", "canonicalization": "JCS" }, "manifestDigest": { "alg": "sha256", "value": "dbec32fa9ace9791bb12263b8f1523225ffa7c6a75b9460619299c0e862f866a", "canonicalization": "JCS" }, "ingredients": [ { "url": "https://www.irs.gov/pub/irs-pdf/fw9.pdf", "sha256": "2d420cbb4123dcf1fb82595b2359cfbb5d81f00b9df9d359fcc7af361d093f53" } ], "payment": { "scheme": "api-key", "network": "eip155:8453", "payer": "sample" } }, "proof": { "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "created": "2026-11-06T17:55:22.802Z", "verificationMethod": "did:web:agents.writerslogic.com#key-1", "proofPurpose": "assertionMethod", "proofValue": "z3anz8HQeSuAKGDpNrFmLhQEeFPA9c4r1bFBBdReE5g1RHqSKhi4qfsiQRWFbESeY1iT4kakjGKh65rSDv7pnCq77" } }, "ethSignature": { "type": "EIP-191", "signer": "did:pkh:eip155:8453:0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "address": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "message": "writerslogic-provenance:da2f4b26c2e4363b3b060e72f7a525bd3e7f82ea14f2bf06bee78cf2e1a445af", "signature": "0x129414c434892c0225a6fd33695b177ac5067ffce024c1bd400d81e6ec65cc2b6458399767ab5dc7069e3f5304732fc5ac8895754269745e8fc8a661089fc07b1c" } } } } } }, "400": { "description": "Invalid request. The `error` field names the offending field and `code` is `invalid_request`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "401": { "description": "Missing or invalid RapidAPI key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "402": { "description": "Payment required. The request did not arrive through RapidAPI.", "content": { "application/json": { "schema": { "type": "object", "description": "x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)", "properties": { "x402Version": { "type": "integer" }, "error": { "type": "string" }, "code": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } } } } } }, "502": { "description": "A source or model this endpoint depends on failed. Retry later; the body carries an `error` message and a `code`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } }, "externalDocs": { "url": "https://writerslogic.com/agents/doc-to-markdown/", "description": "Documentation for Document to Markdown with per-page hashes and offsets: what it does, every input and result field, an example call and the response shape. A free signed sample response is linked from the page." }, "x-tests": [ { "name": "doc-to-markdown: unknown field is rejected", "method": "POST", "path": "/v1/doc-to-markdown", "body": { "nonsense": true }, "assert": { "status": 400, "json": { "code": "invalid_request" }, "maxMs": 10000 } }, { "name": "doc-to-markdown: example returns a signed result", "method": "POST", "path": "/v1/doc-to-markdown", "body": { "url": "https://www.irs.gov/pub/irs-pdf/fw9.pdf", "pages": "1-2", "max_chars": 20000, "describe": true }, "assert": { "status": 200, "jsonPathsExist": [ "data", "_provenance.credential" ], "jsonSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "source": { "type": "object" }, "document_kind": { "type": "string", "enum": [ "pdf", "docx", "xlsx", "pptx", "html", "markdown", "text", "csv", "json" ] }, "format": { "type": "string", "enum": [ "markdown", "text" ] }, "content": { "type": "string" }, "units": { "type": "array", "items": { "type": "object" } }, "unit_count": { "type": "integer" }, "units_total": { "type": "integer" }, "metadata": { "type": [ "object", "null" ] }, "tables_count": { "type": "integer" }, "truncated": { "type": "boolean" }, "notes": { "type": "array", "items": { "type": "string" } }, "deterministic": { "type": "boolean" }, "describe": { "type": "object" }, "llm": { "type": "object" }, "limits": { "type": "object" } } }, "_provenance": { "type": "object" } }, "required": [ "data", "_provenance" ] }, "maxMs": 120000 } } ] } }, "/v1/transcribe-url": { "post": { "operationId": "transcribeUrl", "summary": "Audio and Video URL Transcription", "description": "`POST /v1/transcribe-url`\n\nTranscribes a public audio or video file URL (mp3, wav, mp4, m4a, ogg, webm, flac; up to 25 MB and 30 minutes) with Whisper large-v3-turbo. Returns timestamped segments, SRT and VTT subtitles and plain text, bound to the media's SHA-256. The URL must be the media file itself: YouTube, Spotify and other streaming pages are not accepted. No speaker identification and no translation.\n\n### Use it for\n\n- Turn a podcast episode, meeting recording or voice memo into searchable text.\n- Produce SRT or VTT subtitles for a video or audio file.\n- Tie a transcript to the exact file it came from through the media SHA-256.\n\n### Details and limits\n\nTranscribes a public audio or video FILE URL (podcast enclosure, meeting recording, voice memo; mp3, wav, mp4/m4a, ogg, webm, flac; up to 25 MB and 30 minutes) with Whisper large-v3-turbo on Cloudflare Workers AI. Returns timestamped segments plus SRT and VTT subtitles and the plain text, bound to the media's SHA-256. Does NOT accept YouTube, Spotify or any streaming page (the URL must be the media file itself), does not identify speakers, and does not translate.\n\n### Request fields\n\nSend these as a JSON body.\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| `url` | string | yes | https URL of the audio or video file itself. |\n| `language` | string | no | ISO 639-1 language code of the speech (for example en); detected when omitted. |\n| `formats` | array of string | no | Outputs to include; default all. |\n| `max_minutes` | integer | no | Reject audio longer than this, default 30. |\n\n### Example request body\n\n```json\n{\n \"url\": \"https://archive.org/download/testmp3testfile/mpthreetest.mp3\",\n \"language\": \"en\",\n \"formats\": [\n \"segments\",\n \"srt\"\n ],\n \"max_minutes\": 5\n}\n```\n\n### Request (curl)\n\n```bash\ncurl -X POST \"https://$RAPIDAPI_HOST/v1/transcribe-url\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-RapidAPI-Key: $RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: $RAPIDAPI_HOST\" \\\n -d '{\"url\":\"https://archive.org/download/testmp3testfile/mpthreetest.mp3\",\"language\":\"en\",\"formats\":[\"segments\",\"srt\"],\"max_minutes\":5}'\n```\n\n### What comes back\n\nA 200 response is `{ \"data\": ..., \"_provenance\": ... }`. `_provenance` is a signed record of the sources read; the Verify a Signed Result endpoint checks it.\n\nFields of `data`:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `url` | string | URL. |\n| `final_url` | string | URL after redirects. |\n| `media_sha256` | string | SHA-256 (hex) of the downloaded media bytes. |\n| `bytes` | integer | Bytes, a whole number. |\n| `container` | enum | One of: mp3, wav, mp4, ogg, webm, flac. |\n| `duration_seconds` | number, nullable | From the container for mp3/wav, else from the model; null when unknown. |\n| `language` | string, nullable | Detected or requested language; null when unknown. |\n| `model` | string | Model. |\n| `chunks` | integer | Model requests used; mp3 and wav are split into at most 10-minute chunks. |\n| `text` | string | Text. |\n| `segments` | array of object | Segments, a list of objects. |\n| `srt` | string, nullable | SubRip subtitles, max 2 lines of 42 characters per cue; null when not requested. |\n| `vtt` | string, nullable | WebVTT subtitles; null when not requested. |\n| `word_count` | integer | Word count, a whole number. |\n| `truncated` | boolean | True when text was cut to bound the response size. |\n| `limits` | object | Limits, an object. |\n\nExample `data` from a real recorded call (long values shortened):\n\n```json\n{\n \"url\": \"https://archive.org/download/testmp3testfile/mpthreetest.mp3\",\n \"final_url\": \"https://dn710807.ca.archive.org/0/items/testmp3testfile/mpthreetest.mp3\",\n \"media_sha256\": \"07d11170fe30596ca17307682d2745e09862a8dcdf90c76fa90b70d381eb4973\",\n \"bytes\": 198658,\n \"container\": \"mp3\",\n \"duration_seconds\": 12.408,\n \"language\": \"en\",\n \"model\": \"@cf/openai/whisper-large-v3-turbo\",\n \"chunks\": 1,\n \"segments\": [\n {\n \"start\": 0,\n \"end\": 9.3,\n \"text\": \"Okay, we are trying this for a second time to test the ability to upload an MP3 file.\"\n },\n {\n \"start\": 9.76,\n \"end\": 11.12,\n \"text\": \"Hopefully this will work.\"\n }\n ],\n \"srt\": \"1\\n00:00:00,000 --> 00:00:09,300\\nOkay, we are trying this for a second time\\nto test the ability to upload an MP3 file.\\n\\n2\\n00:00:09,760 --> 00:00:11,120\\nHopefu...\",\n \"vtt\": null,\n \"word_count\": 22,\n \"truncated\": false\n}\n```\n\n### HTTP response status codes\n\n- 200: success; the body is `{ \"data\": ..., \"_provenance\": ... }`.\n- 400: the request failed validation; `error` names the field and `code` is `invalid_request`.\n- 401: the RapidAPI key or subscription is missing or not valid for this API.\n- 429: the plan's rate limit was reached.\n- 5xx: the call failed on our side or at an upstream source; retry it.\n\nFull field-by-field documentation: https://writerslogic.com/agents/transcribe-url/\nMachine-readable input and result schemas: https://writerslogic.com/agents/transcribe-url.json", "x-sample-url": "https://agents.writerslogic.com/api/v1/samples/transcribe-url", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "minLength": 8, "maxLength": 2048, "pattern": "^https://", "description": "https URL of the audio or video file itself." }, "language": { "type": "string", "pattern": "^[a-z]{2}$", "description": "ISO 639-1 language code of the speech (for example en); detected when omitted." }, "formats": { "type": "array", "minItems": 1, "maxItems": 4, "items": { "type": "string", "enum": [ "segments", "srt", "vtt", "text" ] }, "description": "Outputs to include; default all." }, "max_minutes": { "type": "integer", "minimum": 1, "maximum": 30, "description": "Reject audio longer than this, default 30." } }, "description": "Input payload for Transcribe an audio or video file URL (Whisper, timestamps, SRT, VTT). Required fields: `url`. Optional fields: `language`, `formats`, `max_minutes`.", "externalDocs": { "url": "https://writerslogic.com/agents/transcribe-url.json", "description": "Machine-readable record for Transcribe an audio or video file URL (Whisper, timestamps, SRT, VTT): the full input and result JSON Schemas, an example payload and the OpenAPI operation." } }, "examples": { "default": { "summary": "Example request for Transcribe an audio or video file URL (Whisper, timestamps, SRT, VTT)", "description": "A complete valid request body for Audio and Video URL Transcription.", "value": { "url": "https://archive.org/download/testmp3testfile/mpthreetest.mp3", "language": "en", "formats": [ "segments", "srt" ], "max_minutes": 5 } } } } }, "description": "JSON request body for Transcribe an audio or video file URL (Whisper, timestamps, SRT, VTT). Required fields: `url`. Optional fields: `language`, `formats`, `max_minutes`. Unknown fields are rejected with a 400." }, "responses": { "200": { "description": "Success. `data` holds the answer and `_provenance` holds the signed credential for it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "url": { "type": "string", "description": "URL." }, "final_url": { "type": "string", "description": "URL after redirects." }, "media_sha256": { "type": "string", "description": "SHA-256 (hex) of the downloaded media bytes." }, "bytes": { "type": "integer", "description": "Bytes, a whole number." }, "container": { "type": "string", "enum": [ "mp3", "wav", "mp4", "ogg", "webm", "flac" ], "description": "One of: mp3, wav, mp4, ogg, webm, flac." }, "duration_seconds": { "type": "number", "description": "From the container for mp3/wav, else from the model; null when unknown.", "nullable": true }, "language": { "type": "string", "description": "Detected or requested language; null when unknown.", "nullable": true }, "model": { "type": "string", "description": "Model." }, "chunks": { "type": "integer", "description": "Model requests used; mp3 and wav are split into at most 10-minute chunks." }, "text": { "type": "string", "description": "Text." }, "segments": { "type": "array", "items": { "type": "object", "properties": { "start": { "type": "number", "description": "Start, a number." }, "end": { "type": "number", "description": "End, a number." }, "text": { "type": "string", "description": "Text." } } }, "description": "Segments, a list of objects." }, "srt": { "type": "string", "description": "SubRip subtitles, max 2 lines of 42 characters per cue; null when not requested.", "nullable": true }, "vtt": { "type": "string", "description": "WebVTT subtitles; null when not requested.", "nullable": true }, "word_count": { "type": "integer", "description": "Word count, a whole number." }, "truncated": { "type": "boolean", "description": "True when text was cut to bound the response size." }, "limits": { "type": "object", "properties": { "max_bytes": { "type": "integer", "description": "Max bytes, a whole number." }, "max_minutes": { "type": "integer", "description": "Max minutes, a whole number." }, "note": { "type": "string", "description": "Note." } }, "description": "Limits, an object." } }, "description": "Data, an object." }, "_provenance": { "type": "object", "description": "C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance" } }, "required": [ "data", "_provenance" ] }, "example": { "data": { "url": "https://archive.org/download/testmp3testfile/mpthreetest.mp3", "final_url": "https://dn710807.ca.archive.org/0/items/testmp3testfile/mpthreetest.mp3", "media_sha256": "07d11170fe30596ca17307682d2745e09862a8dcdf90c76fa90b70d381eb4973", "bytes": 198658, "container": "mp3", "duration_seconds": 12.408, "language": "en", "model": "@cf/openai/whisper-large-v3-turbo", "chunks": 1, "segments": [ { "start": 0, "end": 9.3, "text": "Okay, we are trying this for a second time to test the ability to upload an MP3 file." }, { "start": 9.76, "end": 11.12, "text": "Hopefully this will work." } ], "srt": "1\n00:00:00,000 --> 00:00:09,300\nOkay, we are trying this for a second time\nto test the ability to upload an MP3 file.\n\n2\n00:00:09,760 --> 00:00:11,120\nHopefully this will work.\n", "vtt": null, "word_count": 22, "truncated": false, "limits": { "max_bytes": 26214400, "max_minutes": 5, "note": "single request for mp4/m4a/ogg/webm/flac; no diarization; no YouTube" } }, "_provenance": { "version": "writerslogic-provenance/1", "issuer": "did:web:agents.writerslogic.com", "verify": { "endpoint": "POST /api/v1/verify-provenance", "did": "did:web:agents.writerslogic.com" }, "manifest": { "format": "application/json", "instance_id": "xmp:iid:55299941-c904-48b7-b0be-8ae4360c15c2", "claim_generator_info": [ { "name": "WritersLogic x402 Agent Hub", "version": "2.0.0" } ], "title": "Transcribe an audio or video file URL (Whisper, timestamps, SRT, VTT)", "assertions": [ { "label": "c2pa.actions.v2", "data": { "actions": [ { "action": "c2pa.created", "when": "2026-11-06T17:57:09.524Z", "softwareAgent": { "name": "writerslogic-agent-hub/transcribe-url", "version": "2.0.0" }, "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia", "parameters": { "endpoint": "POST /api/v1/transcribe-url", "inputDigest": { "alg": "sha256", "hash": "b5691174504e71dc69ea5369326b15b4fe2cde674e1edc89aa9b011a5b33fda3", "canonicalization": "JCS" } } } ] } }, { "label": "c2pa.hash.data", "data": { "alg": "sha256", "hash": "b521ab58c58bd8523cac8a4b6b8a404c44bbd04e33974a57ab6da709bb92950d", "name": "jcs-canonical-json(data)" } }, { "label": "c2pa.ingredient.v3", "data": { "title": "https://dn710807.ca.archive.org/0/items/testmp3testfile/mpthreetest.mp3", "format": "audio/mpeg", "relationship": "inputTo", "dc": { "source": "https://dn710807.ca.archive.org/0/items/testmp3testfile/mpthreetest.mp3", "date": "2026-11-06T17:57:08.021Z" }, "hash": { "alg": "sha256", "hash": "07d11170fe30596ca17307682d2745e09862a8dcdf90c76fa90b70d381eb4973", "basis": "body" } } } ] }, "credential": { "@context": [ "https://www.w3.org/ns/credentials/v2" ], "id": "urn:uuid:73885bc2-f59e-4005-971a-47f9b4a53e6b", "type": [ "VerifiableCredential", "AgentOutputCredential" ], "issuer": "did:web:agents.writerslogic.com", "validFrom": "2026-11-06T17:57:09.524Z", "credentialSubject": { "id": "urn:sha256:b521ab58c58bd8523cac8a4b6b8a404c44bbd04e33974a57ab6da709bb92950d", "agent": "transcribe-url", "endpoint": "POST /api/v1/transcribe-url", "outputDigest": { "alg": "sha256", "value": "b521ab58c58bd8523cac8a4b6b8a404c44bbd04e33974a57ab6da709bb92950d", "canonicalization": "JCS" }, "inputDigest": { "alg": "sha256", "value": "b5691174504e71dc69ea5369326b15b4fe2cde674e1edc89aa9b011a5b33fda3", "canonicalization": "JCS" }, "manifestDigest": { "alg": "sha256", "value": "0a49038ff2c155da2618818305cd2a133247174f93222dd539da231513f3e152", "canonicalization": "JCS" }, "ingredients": [ { "url": "https://dn710807.ca.archive.org/0/items/testmp3testfile/mpthreetest.mp3", "sha256": "07d11170fe30596ca17307682d2745e09862a8dcdf90c76fa90b70d381eb4973" }, { "url": "https://api.cloudflare.com/client/v4/accounts/d8cf78a91fcbd47d803e14b9897c976b/ai/run/@cf/openai/whisper-large-v3-turbo", "sha256": "0894bff7715277817b49de4ce3d815dd20f7751abaf764253213944b8f01390c" } ], "payment": { "scheme": "api-key", "network": "eip155:8453", "payer": "sample" } }, "proof": { "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "created": "2026-11-06T17:57:09.524Z", "verificationMethod": "did:web:agents.writerslogic.com#key-1", "proofPurpose": "assertionMethod", "proofValue": "z2aUpg6wWEKvHkNRQXeG5Vz99wL8xySqQ2z7vkT6pSBdK2hkFoYP5bVh4VkU1ebf1TWWAY19rrm7H9yEsABPyjSHU" } }, "ethSignature": { "type": "EIP-191", "signer": "did:pkh:eip155:8453:0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "address": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "message": "writerslogic-provenance:0fd629ffcf62e451838c96b194051e8a2f0e3d30daad99cbc30e176b92882f01", "signature": "0xc0d9cafe76153a37fd2748bfe5f03740cd7a7380d3783724f56c1c7bf5a66f465c80c8447a50ee09f8f9b93c844bcaa3b6bb99273ef23ba55c7308906d48beef1b" } } } } } }, "400": { "description": "Invalid request. The `error` field names the offending field and `code` is `invalid_request`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "401": { "description": "Missing or invalid RapidAPI key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "402": { "description": "Payment required. The request did not arrive through RapidAPI.", "content": { "application/json": { "schema": { "type": "object", "description": "x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)", "properties": { "x402Version": { "type": "integer" }, "error": { "type": "string" }, "code": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } } } } } }, "502": { "description": "A source or model this endpoint depends on failed. Retry later; the body carries an `error` message and a `code`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } }, "externalDocs": { "url": "https://writerslogic.com/agents/transcribe-url/", "description": "Documentation for Transcribe an audio or video file URL (Whisper, timestamps, SRT, VTT): what it does, every input and result field, an example call and the response shape. A free signed sample response is linked from the page." }, "x-tests": [ { "name": "transcribe-url: unknown field is rejected", "method": "POST", "path": "/v1/transcribe-url", "body": { "nonsense": true }, "assert": { "status": 400, "json": { "code": "invalid_request" }, "maxMs": 10000 } }, { "name": "transcribe-url: example returns a signed result", "method": "POST", "path": "/v1/transcribe-url", "body": { "url": "https://archive.org/download/testmp3testfile/mpthreetest.mp3", "language": "en", "formats": [ "segments", "srt" ], "max_minutes": 5 }, "assert": { "status": 200, "jsonPathsExist": [ "data", "_provenance.credential" ], "jsonSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "url": { "type": "string" }, "final_url": { "type": "string" }, "media_sha256": { "type": "string" }, "bytes": { "type": "integer" }, "container": { "type": "string", "enum": [ "mp3", "wav", "mp4", "ogg", "webm", "flac" ] }, "duration_seconds": { "type": [ "number", "null" ] }, "language": { "type": [ "string", "null" ] }, "model": { "type": "string" }, "chunks": { "type": "integer" }, "text": { "type": "string" }, "segments": { "type": "array", "items": { "type": "object", "properties": { "start": { "type": "number" }, "end": { "type": "number" }, "text": { "type": "string" } } } }, "srt": { "type": [ "string", "null" ] }, "vtt": { "type": [ "string", "null" ] }, "word_count": { "type": "integer" }, "truncated": { "type": "boolean" }, "limits": { "type": "object", "properties": { "max_bytes": { "type": "integer" }, "max_minutes": { "type": "integer" }, "note": { "type": "string" } } } } }, "_provenance": { "type": "object" } }, "required": [ "data", "_provenance" ] }, "maxMs": 120000 } } ] } }, "/v1/page-capture": { "post": { "operationId": "pageCapture", "summary": "Web Page Screenshot and PDF", "description": "`POST /v1/page-capture`\n\nRenders one public web page in a real browser with JavaScript enabled and returns a PNG or JPEG screenshot or a PDF as base64 with its SHA-256. It does not log in, click or fill forms, and does not capture private or internal hosts. Returns an error rather than a capture larger than 6 MB.\n\n**What you get:** A rendered screenshot or PDF of any public page without running a headless browser.\n\n### Use it for\n\n- Archive how a page looked at a point in time as a PNG, JPEG or PDF with a SHA-256 of the file.\n- Give a vision model a rendered screenshot of a page that needs JavaScript to display.\n- Produce a PDF of a public page for records, review or evidence.\n\n### Details and limits\n\nRenders one public web page in a real browser (Cloudflare Browser Run, JavaScript enabled) and returns a PNG or JPEG screenshot or a PDF as base64 with its sha256, for agents that need to see or archive a page. Does not log in, click or fill forms, does not capture private or internal hosts, and returns an error rather than a capture larger than 6 MB.\n\n### Request fields\n\nSend these as a JSON body.\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| `url` | string | yes | Public http(s) URL. |\n| `output` | enum | no | One of: png, jpeg, pdf. Default \"png\". |\n| `full_page` | boolean | no | Capture the full scroll height (screenshots only; a PDF is always the whole page). Default false. |\n| `viewport` | object | no | Default 1280x800. |\n| `wait_until` | enum | no | One of: load, networkidle0. Default \"load\". |\n| `timeout_ms` | integer | no | Page navigation timeout. Default 15000. |\n\n### Example request body\n\n```json\n{\n \"url\": \"https://example.com/\",\n \"output\": \"png\",\n \"viewport\": {\n \"width\": 1280,\n \"height\": 800\n }\n}\n```\n\n### Request (curl)\n\n```bash\ncurl -X POST \"https://$RAPIDAPI_HOST/v1/page-capture\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-RapidAPI-Key: $RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: $RAPIDAPI_HOST\" \\\n -d '{\"url\":\"https://example.com/\",\"output\":\"png\",\"viewport\":{\"width\":1280,\"height\":800}}'\n```\n\n### What comes back\n\nA 200 response is `{ \"data\": ..., \"_provenance\": ... }`. `_provenance` is a signed record of the sources read; the Verify a Signed Result endpoint checks it.\n\nFields of `data`:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `url` | string | URL. |\n| `output` | enum | One of: png, jpeg, pdf. |\n| `media_type` | string | Media type. |\n| `bytes` | integer | Bytes, a whole number. |\n| `content_base64` | string | Content base64. |\n| `content_sha256` | string | sha256 of the decoded file bytes. |\n| `viewport` | object | Viewport, an object. |\n| `full_page` | boolean | Full page, true or false. |\n| `captured_at` | string | Captured at. |\n| `limits` | object | Limits, an object. |\n\nExample `data` from a real recorded call (long values shortened):\n\n```json\n{\n \"url\": \"https://example.com/\",\n \"output\": \"png\",\n \"media_type\": \"image/png\",\n \"bytes\": 74812,\n \"content_base64\": \"iVBORw0KGgoAAAANSUhEUgAABQAAAAMgCAIAAADz+lisAAAQAElEQVR4nOzddbwUZdz38aE7BOnuBklJ6VBQSaUREVFAxUJBRFAUQUQFKZGQlu7uLumS7u5unu+913PPa+7ds3v2cA7lfN5/nNfu7OzENdfCf...\",\n \"content_sha256\": \"9dab6e635ca5a3f4c2220115121db3387da42e6890aae19da30d0395e2039066\",\n \"viewport\": {\n \"width\": 1280,\n \"height\": 800\n },\n \"full_page\": false,\n \"captured_at\": \"2026-11-06T17:57:04.594Z\",\n \"limits\": {\n \"note\": \"Rendered by Cloudflare Browser Run with JavaScript on; one navigation, no login, cookies or interaction; a PDF always covers the whole page; the capture is n...\"\n }\n}\n```\n\n### HTTP response status codes\n\n- 200: success; the body is `{ \"data\": ..., \"_provenance\": ... }`.\n- 400: the request failed validation; `error` names the field and `code` is `invalid_request`.\n- 401: the RapidAPI key or subscription is missing or not valid for this API.\n- 429: the plan's rate limit was reached.\n- 5xx: the call failed on our side or at an upstream source; retry it.\n\nFull field-by-field documentation: https://writerslogic.com/agents/page-capture/\nMachine-readable input and result schemas: https://writerslogic.com/agents/page-capture.json", "x-sample-url": "https://agents.writerslogic.com/api/v1/samples/page-capture", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "minLength": 8, "maxLength": 2048, "description": "Public http(s) URL." }, "output": { "type": "string", "enum": [ "png", "jpeg", "pdf" ], "default": "png", "description": "One of: png, jpeg, pdf." }, "full_page": { "type": "boolean", "default": false, "description": "Capture the full scroll height (screenshots only; a PDF is always the whole page)." }, "viewport": { "type": "object", "additionalProperties": false, "required": [ "width", "height" ], "properties": { "width": { "type": "integer", "minimum": 320, "maximum": 1920, "description": "Width, a whole number. Between 320 and 1920." }, "height": { "type": "integer", "minimum": 320, "maximum": 1080, "description": "Height, a whole number. Between 320 and 1080." } }, "description": "Default 1280x800." }, "wait_until": { "type": "string", "enum": [ "load", "networkidle0" ], "default": "load", "description": "One of: load, networkidle0." }, "timeout_ms": { "type": "integer", "minimum": 1000, "maximum": 30000, "default": 15000, "description": "Page navigation timeout." } }, "description": "Input payload for Page capture: screenshot or PDF of a public URL. Required fields: `url`. Optional fields: `output`, `full_page`, `viewport`, `wait_until`, `timeout_ms`.", "externalDocs": { "url": "https://writerslogic.com/agents/page-capture.json", "description": "Machine-readable record for Page capture: screenshot or PDF of a public URL: the full input and result JSON Schemas, an example payload and the OpenAPI operation." } }, "examples": { "default": { "summary": "Example request for Page capture: screenshot or PDF of a public URL", "description": "A complete valid request body for Web Page Screenshot and PDF.", "value": { "url": "https://example.com/", "output": "png", "viewport": { "width": 1280, "height": 800 } } }, "A PDF of the page": { "summary": "A PDF of the page", "value": { "url": "https://example.com/", "output": "pdf" } } } } }, "description": "JSON request body for Page capture: screenshot or PDF of a public URL. Required fields: `url`. Optional fields: `output`, `full_page`, `viewport`, `wait_until`, `timeout_ms`. Unknown fields are rejected with a 400." }, "responses": { "200": { "description": "Success. `data` holds the answer and `_provenance` holds the signed credential for it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "url": { "type": "string", "description": "URL." }, "output": { "type": "string", "enum": [ "png", "jpeg", "pdf" ], "description": "One of: png, jpeg, pdf." }, "media_type": { "type": "string", "description": "Media type." }, "bytes": { "type": "integer", "description": "Bytes, a whole number." }, "content_base64": { "type": "string", "description": "Content base64." }, "content_sha256": { "type": "string", "description": "sha256 of the decoded file bytes." }, "viewport": { "type": "object", "properties": { "width": { "type": "integer", "description": "Width, a whole number." }, "height": { "type": "integer", "description": "Height, a whole number." } }, "description": "Viewport, an object." }, "full_page": { "type": "boolean", "description": "Full page, true or false." }, "captured_at": { "type": "string", "description": "Captured at." }, "limits": { "type": "object", "properties": { "note": { "type": "string", "description": "Note." } }, "description": "Limits, an object." } }, "description": "Data, an object." }, "_provenance": { "type": "object", "description": "C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance" } }, "required": [ "data", "_provenance" ] }, "example": { "data": { "url": "https://example.com/", "output": "png", "media_type": "image/png", "bytes": 74812, "content_base64": "iVBORw0KGgoAAAANSUhEUgAABQAAAAMgCAIAAADz+lisAAAQAElEQVR4nOzddbwUZdz38aE7BOnuBklJ6VBQSaUREVFAxUJBRFAUQUQFKZGQlu7uLumS7u5unu+913PPa+7ds3v2cA7lfN5/nNfu7OzENdfCfK/f7GzU8+fPWwAAAAAA/NdFtgAAAAAAcAECMAAAAADAFQjAAAAAAABXIAADAAAAAFyBAAwAAAAAcAUCMAAAAADAFQjAAAAAAABXIAADAAAAAFyBAAwAAAAAcAUCMAAAAADAFQjAAAAAA...", "content_sha256": "9dab6e635ca5a3f4c2220115121db3387da42e6890aae19da30d0395e2039066", "viewport": { "width": 1280, "height": 800 }, "full_page": false, "captured_at": "2026-11-06T17:57:04.594Z", "limits": { "note": "Rendered by Cloudflare Browser Run with JavaScript on; one navigation, no login, cookies or interaction; a PDF always covers the whole page; the capture is not a legal record of what other visitors see." } }, "_provenance": { "version": "writerslogic-provenance/1", "issuer": "did:web:agents.writerslogic.com", "verify": { "endpoint": "POST /api/v1/verify-provenance", "did": "did:web:agents.writerslogic.com" }, "manifest": { "format": "application/json", "instance_id": "xmp:iid:00245e9a-3d01-4c71-ae44-4b50c2bee08f", "claim_generator_info": [ { "name": "WritersLogic x402 Agent Hub", "version": "2.0.0" } ], "title": "Page capture: screenshot or PDF of a public URL", "assertions": [ { "label": "c2pa.actions.v2", "data": { "actions": [ { "action": "c2pa.created", "when": "2026-11-06T17:57:06.972Z", "softwareAgent": { "name": "writerslogic-agent-hub/page-capture", "version": "2.0.0" }, "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia", "parameters": { "endpoint": "POST /api/v1/page-capture", "inputDigest": { "alg": "sha256", "hash": "7922e973b9548d765dfad9074039bd037890442ceea9c7f46a7c1f003127b0a0", "canonicalization": "JCS" } } } ] } }, { "label": "c2pa.hash.data", "data": { "alg": "sha256", "hash": "45437ca195930f32b979e7514a93f2a4b18efd4b77067e77486fdd073a02b5df", "name": "jcs-canonical-json(data)" } }, { "label": "c2pa.ingredient.v3", "data": { "title": "https://api.cloudflare.com/client/v4/accounts/d8cf78a91fcbd47d803e14b9897c976b/browser-run/screenshot", "format": "image/png", "relationship": "inputTo", "dc": { "source": "https://api.cloudflare.com/client/v4/accounts/d8cf78a91fcbd47d803e14b9897c976b/browser-run/screenshot", "date": "2026-11-06T17:57:06.972Z" }, "hash": { "alg": "sha256", "hash": "9dab6e635ca5a3f4c2220115121db3387da42e6890aae19da30d0395e2039066", "basis": "body" } } } ] }, "credential": { "@context": [ "https://www.w3.org/ns/credentials/v2" ], "id": "urn:uuid:05ac4330-28b1-457f-8754-7b0c579ba034", "type": [ "VerifiableCredential", "AgentOutputCredential" ], "issuer": "did:web:agents.writerslogic.com", "validFrom": "2026-11-06T17:57:06.972Z", "credentialSubject": { "id": "urn:sha256:45437ca195930f32b979e7514a93f2a4b18efd4b77067e77486fdd073a02b5df", "agent": "page-capture", "endpoint": "POST /api/v1/page-capture", "outputDigest": { "alg": "sha256", "value": "45437ca195930f32b979e7514a93f2a4b18efd4b77067e77486fdd073a02b5df", "canonicalization": "JCS" }, "inputDigest": { "alg": "sha256", "value": "7922e973b9548d765dfad9074039bd037890442ceea9c7f46a7c1f003127b0a0", "canonicalization": "JCS" }, "manifestDigest": { "alg": "sha256", "value": "e33a8ba0bbd1ed49fb21aea53b4f2d1c0ff606ba33f7b67c8ee73f70057a222e", "canonicalization": "JCS" }, "ingredients": [ { "url": "https://api.cloudflare.com/client/v4/accounts/d8cf78a91fcbd47d803e14b9897c976b/browser-run/screenshot", "sha256": "9dab6e635ca5a3f4c2220115121db3387da42e6890aae19da30d0395e2039066" } ], "payment": { "scheme": "api-key", "network": "eip155:8453", "payer": "sample" } }, "proof": { "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "created": "2026-11-06T17:57:06.972Z", "verificationMethod": "did:web:agents.writerslogic.com#key-1", "proofPurpose": "assertionMethod", "proofValue": "z4zboNjgSU5hZhvbbnKjniNiz84CaL8z42nNsz2YgHg3SnV4jL4dZSV5EqGRMyPWaKgBLphQrFw9DHXXi5RLgR8P7" } }, "ethSignature": { "type": "EIP-191", "signer": "did:pkh:eip155:8453:0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "address": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "message": "writerslogic-provenance:bd58a832b6de44d6ca061fb78e51c931bd2235d913ba581340648744dd8c7b7b", "signature": "0x320d2f698433c58a05606ce17a73264584560f809c5dd0302a4e332832189de82baba1e577a07abf7d50e25c89bdd12745c564da4c54b86d780fcf293967d1271b" } } } } } }, "400": { "description": "Invalid request. The `error` field names the offending field and `code` is `invalid_request`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "401": { "description": "Missing or invalid RapidAPI key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "402": { "description": "Payment required. The request did not arrive through RapidAPI.", "content": { "application/json": { "schema": { "type": "object", "description": "x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)", "properties": { "x402Version": { "type": "integer" }, "error": { "type": "string" }, "code": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } } } } } }, "502": { "description": "A source or model this endpoint depends on failed. Retry later; the body carries an `error` message and a `code`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } }, "externalDocs": { "url": "https://writerslogic.com/agents/page-capture/", "description": "Documentation for Page capture: screenshot or PDF of a public URL: what it does, every input and result field, an example call and the response shape. A free signed sample response is linked from the page." }, "x-tests": [ { "name": "page-capture: unknown field is rejected", "method": "POST", "path": "/v1/page-capture", "body": { "nonsense": true }, "assert": { "status": 400, "json": { "code": "invalid_request" }, "maxMs": 10000 } }, { "name": "page-capture: example returns a signed result", "method": "POST", "path": "/v1/page-capture", "body": { "url": "https://example.com/", "output": "png", "viewport": { "width": 1280, "height": 800 } }, "assert": { "status": 200, "jsonPathsExist": [ "data", "_provenance.credential" ], "jsonSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "url": { "type": "string" }, "output": { "type": "string", "enum": [ "png", "jpeg", "pdf" ] }, "media_type": { "type": "string" }, "bytes": { "type": "integer" }, "content_base64": { "type": "string" }, "content_sha256": { "type": "string" }, "viewport": { "type": "object", "properties": { "width": { "type": "integer" }, "height": { "type": "integer" } } }, "full_page": { "type": "boolean" }, "captured_at": { "type": "string" }, "limits": { "type": "object", "properties": { "note": { "type": "string" } } } } }, "_provenance": { "type": "object" } }, "required": [ "data", "_provenance" ] }, "maxMs": 120000 } } ] } }, "/v1/heal-scraper": { "post": { "operationId": "healScraper", "summary": "Self-Healing Scraper Selector Generator", "description": "`POST /v1/heal-scraper`\n\nSynthesizes durable CSS selectors (Cheerio, no XPath) for a target JSON schema and proves them against the live DOM in the same request. Returns the extracted data plus a ready-to-run TypeScript Cheerio extractor. Send a URL or HTML, the target schema and, optionally, the selectors that broke.\n\n**What you get:** Pay once when a scraper breaks instead of paying for LLM extraction on every page; the returned extractor runs deterministically for free.\n\n### Use it for\n\n- Repair a scraper whose selectors broke after a site redesign by passing the old selectors in.\n- Generate CSS selectors for a new page from a JSON Schema of the fields you want.\n- Get a standalone TypeScript Cheerio extractor you can run later without calling the API again.\n\n### Details and limits\n\nSynthesizes durable CSS selectors (Cheerio; no XPath) for a target JSON schema, proves them against the live DOM in-request, and returns the extracted data plus a ready-to-run TypeScript Cheerio extractor.\n\n### Request fields\n\nSend these as a JSON body.\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| `url` | string | no | Page to fetch. Provide url or html. |\n| `html` | string | no | Raw HTML to use instead of fetching. |\n| `targetSchema` | object | yes | JSON Schema of the fields to extract: an object whose properties are string/number/integer/boolean (or arrays of those), or an array whose items are such an object for list pages. The pattern keyword is not allowed. |\n| `previousBrokenSelectors` | object | no | Map of field name to the CSS selector that stopped working. |\n\n### Example request body\n\n```json\n{\n \"url\": \"https://news.ycombinator.com\",\n \"targetSchema\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"required\": [\n \"title\",\n \"link\"\n ],\n \"properties\": {\n \"title\": {\n \"type\": \"string\"\n },\n \"link\": {\n \"type\": \"string\"\n },\n \"points\": {\n \"type\": \"integer\"\n }\n }\n }\n },\n \"previousBrokenSelectors\": {\n \"title\": \".storylink\"\n }\n}\n```\n\n### Request (curl)\n\n```bash\ncurl -X POST \"https://$RAPIDAPI_HOST/v1/heal-scraper\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-RapidAPI-Key: $RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: $RAPIDAPI_HOST\" \\\n -d '{\"url\":\"https://news.ycombinator.com\",\"targetSchema\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"required\":[\"title\",\"link\"],\"properties\":{\"title\":{\"type\":\"string\"},\"link\":{\"type\":\"string\"},\"points\":{\"type\":\"integer\"}}}},\"previousBrokenSelectors\":{\"title\":\".storylink\"}}'\n```\n\n### What comes back\n\nA 200 response is `{ \"data\": ..., \"_provenance\": ... }`. `_provenance` is a signed record of the sources read; the Verify a Signed Result endpoint checks it.\n\nFields of `data`:\n\n| Field | Type | Description |\n| --- | --- | --- |\n| `source_url` | string, nullable | Final fetched URL, or null when html was supplied. |\n| `healed` | boolean | True when every field fills at least 4 in 5 records (single record: filled) and the data validates against targetSchema. |\n| `decidedBy` | enum | Which stage produced the returned spec; all but llm make no model call. With llm, only the fields in llmFields were sent to the model. |\n| `deterministic` | boolean | True when no model call was made: replay, cosmetic repair, or structured markup satisfied the schema. |\n| `llmCalls` | integer | LLM calls, a whole number. |\n| `llmFields` | array of string | Fields the model was asked to solve (empty when deterministic). |\n| `repairs` | array of object | Previous selectors changed to survive cosmetic drift: hashed or utility classes, :nth-child positions. |\n| `data` | any | Extracted data shaped like targetSchema. |\n| `selectorMap` | object | Selector map, an object. |\n| `spec` | object | Spec, an object. |\n| `validation` | object | Validation, an object. |\n| `extractorCode` | string | Standalone TypeScript module exporting extract(html). |\n| `page_structure_notes` | string | Page structure notes. |\n\nExample `data` from a real recorded call (long values shortened):\n\n```json\n{\n \"source_url\": \"https://news.ycombinator.com/\",\n \"healed\": true,\n \"decidedBy\": \"llm\",\n \"deterministic\": false,\n \"llmCalls\": 1,\n \"llmFields\": [\n \"title\",\n \"link\",\n \"points\"\n ],\n \"repairs\": [],\n \"data\": [\n {\n \"title\": \"AI is forcing us to pay off 40 years of technical debt\",\n \"link\": \"https://spectrum.ieee.org/ai-in-cybersecurity-php2shell-vulnerability\",\n \"points\": 883\n },\n {\n \"title\": \"A new Go API for JSON\",\n \"link\": \"https://go.dev/blog/jsonv2\",\n \"points\": 110\n },\n {\n \"title\": \"Ripple-65B Preview: U.S. Open-Weight SOTA on Agentic Coding\",\n \"link\": \"https://www.ricursive.com/ripple\",\n \"points\": 51\n }\n ],\n \"selectorMap\": {\n \"title\": \".titleline > a\",\n \"link\": \".titleline > a\",\n \"points\": \"+ tr .score\"\n },\n \"spec\": {\n \"itemSelector\": \"tr.athing.submission\",\n \"fields\": [\n \"...\",\n \"...\",\n \"...\"\n ]\n },\n \"validation\": {\n \"valid\": true,\n \"errors\": [],\n \"itemCount\": 30,\n \"fields\": [\n \"...\",\n \"...\",\n \"...\"\n ]\n },\n \"extractorCode\": \"// Generated by x402-agents /api/v1/heal-scraper. Requires: npm install cheerio\\nimport * as cheerio from \\\"cheerio\\\";\\n\\ntype FieldSpec = { name: string; selecto...\",\n \"page_structure_notes\": \"Hacker News front page. Each story is split across two sibling rows: tr.athing.submission holds the rank, title and link in span.titleline > a, and the next ...\"\n}\n```\n\n### HTTP response status codes\n\n- 200: success; the body is `{ \"data\": ..., \"_provenance\": ... }`.\n- 400: the request failed validation; `error` names the field and `code` is `invalid_request`.\n- 401: the RapidAPI key or subscription is missing or not valid for this API.\n- 429: the plan's rate limit was reached.\n- 5xx: the call failed on our side or at an upstream source; retry it.\n\nFull field-by-field documentation: https://writerslogic.com/agents/heal-scraper/\nMachine-readable input and result schemas: https://writerslogic.com/agents/heal-scraper.json", "x-sample-url": "https://agents.writerslogic.com/api/v1/samples/heal-scraper", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "required": [ "targetSchema" ], "properties": { "url": { "type": "string", "maxLength": 2048, "description": "Page to fetch. Provide url or html." }, "html": { "type": "string", "maxLength": 1500000, "description": "Raw HTML to use instead of fetching." }, "targetSchema": { "type": "object", "description": "JSON Schema of the fields to extract: an object whose properties are string/number/integer/boolean (or arrays of those), or an array whose items are such an object for list pages. The pattern keyword is not allowed." }, "previousBrokenSelectors": { "type": "object", "description": "Map of field name to the CSS selector that stopped working." } }, "description": "Input payload for Self-Healing Scraper & DOM-to-JSON Compiler. Required fields: `targetSchema`. Optional fields: `url`, `html`, `previousBrokenSelectors`.", "externalDocs": { "url": "https://writerslogic.com/agents/heal-scraper.json", "description": "Machine-readable record for Self-Healing Scraper & DOM-to-JSON Compiler: the full input and result JSON Schemas, an example payload and the OpenAPI operation." } }, "examples": { "default": { "summary": "Example request for Self-Healing Scraper & DOM-to-JSON Compiler", "description": "A complete valid request body for Self-Healing Scraper Selector Generator.", "value": { "url": "https://news.ycombinator.com", "targetSchema": { "type": "array", "items": { "type": "object", "required": [ "title", "link" ], "properties": { "title": { "type": "string" }, "link": { "type": "string" }, "points": { "type": "integer" } } } }, "previousBrokenSelectors": { "title": ".storylink" } } } } } }, "description": "JSON request body for Self-Healing Scraper & DOM-to-JSON Compiler. Required fields: `targetSchema`. Optional fields: `url`, `html`, `previousBrokenSelectors`. Unknown fields are rejected with a 400." }, "responses": { "200": { "description": "Success. `data` holds the answer and `_provenance` holds the signed credential for it.", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "source_url": { "description": "Final fetched URL, or null when html was supplied.", "type": "string", "nullable": true }, "healed": { "type": "boolean", "description": "True when every field fills at least 4 in 5 records (single record: filled) and the data validates against targetSchema." }, "decidedBy": { "type": "string", "enum": [ "previous_selectors", "repaired_selectors", "structured_markup", "llm" ], "description": "Which stage produced the returned spec; all but llm make no model call. With llm, only the fields in llmFields were sent to the model." }, "deterministic": { "type": "boolean", "description": "True when no model call was made: replay, cosmetic repair, or structured markup satisfied the schema." }, "llmCalls": { "type": "integer", "description": "LLM calls, a whole number." }, "llmFields": { "type": "array", "items": { "type": "string" }, "description": "Fields the model was asked to solve (empty when deterministic)." }, "repairs": { "type": "array", "description": "Previous selectors changed to survive cosmetic drift: hashed or utility classes, :nth-child positions.", "items": { "type": "object", "properties": { "field": { "type": "string", "description": "Field." }, "from": { "type": "string", "description": "From." }, "to": { "type": "string", "description": "To." }, "strategy": { "type": "string", "description": "Strategy." } } } }, "data": { "description": "Extracted data shaped like targetSchema." }, "selectorMap": { "type": "object", "description": "Selector map, an object." }, "spec": { "type": "object", "description": "Spec, an object." }, "validation": { "type": "object", "description": "Validation, an object." }, "extractorCode": { "type": "string", "description": "Standalone TypeScript module exporting extract(html)." }, "page_structure_notes": { "type": "string", "description": "Page structure notes." } }, "description": "Data, an object." }, "_provenance": { "type": "object", "description": "C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance" } }, "required": [ "data", "_provenance" ] }, "example": { "data": { "source_url": "https://news.ycombinator.com/", "healed": true, "decidedBy": "llm", "deterministic": false, "llmCalls": 1, "llmFields": [ "title", "link", "points" ], "repairs": [], "data": [ { "title": "AI is forcing us to pay off 40 years of technical debt", "link": "https://spectrum.ieee.org/ai-in-cybersecurity-php2shell-vulnerability", "points": 883 }, { "title": "A new Go API for JSON", "link": "https://go.dev/blog/jsonv2", "points": 110 }, { "title": "Ripple-65B Preview: U.S. Open-Weight SOTA on Agentic Coding", "link": "https://www.ricursive.com/ripple", "points": 51 } ], "selectorMap": { "title": ".titleline > a", "link": ".titleline > a", "points": "+ tr .score" }, "spec": { "itemSelector": "tr.athing.submission", "fields": [ { "name": "title", "selector": ".titleline > a", "extract": "text", "attribute": "", "all": false, "type": "string" }, { "name": "link", "selector": ".titleline > a", "extract": "attr", "attribute": "href", "all": false, "type": "string" }, { "name": "points", "selector": "+ tr .score", "extract": "text", "attribute": "", "all": false, "type": "integer" } ] }, "validation": { "valid": true, "errors": [], "itemCount": 30, "fields": [ { "name": "title", "selector": ".titleline > a", "matches": 30, "filled": 30, "fillRate": 1 }, { "name": "link", "selector": ".titleline > a", "matches": 30, "filled": 30, "fillRate": 1 }, { "name": "points", "selector": "+ tr .score", "matches": 30, "filled": 30, "fillRate": 1 } ] }, "extractorCode": "// Generated by x402-agents /api/v1/heal-scraper. Requires: npm install cheerio\nimport * as cheerio from \"cheerio\";\n\ntype FieldSpec = { name: string; selector: string; extract: \"text\" | \"attr\" | \"html\"; attribute: string; all: boolean; type: \"string\" | \"number\" | \"integer\" | \"boolean\" };\ntype Val...", "page_structure_notes": "Hacker News front page. Each story is split across two sibling rows: tr.athing.submission holds the rank, title and link in span.titleline > a, and the next sibling tr holds span.score. The old .storylink class no longer exists. Points are read with a leading-combinator selector (+ tr .score) rel..." }, "_provenance": { "version": "writerslogic-provenance/1", "issuer": "did:web:agents.writerslogic.com", "verify": { "endpoint": "POST /api/v1/verify-provenance", "did": "did:web:agents.writerslogic.com" }, "manifest": { "format": "application/json", "instance_id": "xmp:iid:1811730b-1bac-4a47-9dc6-5a67f8f99872", "claim_generator_info": [ { "name": "WritersLogic x402 Agent Hub", "version": "2.0.0" } ], "title": "Self-Healing Scraper & DOM-to-JSON Compiler", "assertions": [ { "label": "c2pa.actions.v2", "data": { "actions": [ { "action": "c2pa.created", "when": "2026-11-04T20:24:57.199Z", "softwareAgent": { "name": "writerslogic-agent-hub/heal-scraper", "version": "2.0.0" }, "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia", "parameters": { "endpoint": "POST /api/v1/heal-scraper", "inputDigest": { "alg": "sha256", "hash": "9b21a4e8eaab13e84dc1f656abf94f7338efd519ff33f6709a304eb1f36f6f4c", "canonicalization": "JCS" } } } ] } }, { "label": "c2pa.hash.data", "data": { "alg": "sha256", "hash": "c86f7dc21ec08535df7a1a531d29d42375ae6f7998c006200f9417c0c3b6ff64", "name": "jcs-canonical-json(data)" } }, { "label": "c2pa.ingredient.v3", "data": { "title": "https://news.ycombinator.com/", "format": "text/html", "relationship": "inputTo", "dc": { "source": "https://news.ycombinator.com/", "date": "2026-11-04T20:24:45.645Z" }, "hash": { "alg": "sha256", "hash": "4c52087646a3dd1d2080b710f40669be2aa142847bc3d8d57484b643e0576fd7", "basis": "body" } } } ] }, "credential": { "@context": [ "https://www.w3.org/ns/credentials/v2" ], "id": "urn:uuid:cec2e524-61e0-4242-8e28-f1a8e47eb190", "type": [ "VerifiableCredential", "AgentOutputCredential" ], "issuer": "did:web:agents.writerslogic.com", "validFrom": "2026-11-04T20:24:57.199Z", "credentialSubject": { "id": "urn:sha256:c86f7dc21ec08535df7a1a531d29d42375ae6f7998c006200f9417c0c3b6ff64", "agent": "heal-scraper", "endpoint": "POST /api/v1/heal-scraper", "outputDigest": { "alg": "sha256", "value": "c86f7dc21ec08535df7a1a531d29d42375ae6f7998c006200f9417c0c3b6ff64", "canonicalization": "JCS" }, "inputDigest": { "alg": "sha256", "value": "9b21a4e8eaab13e84dc1f656abf94f7338efd519ff33f6709a304eb1f36f6f4c", "canonicalization": "JCS" }, "manifestDigest": { "alg": "sha256", "value": "e3f332915c8669ba8e3ee5dcd6ef071a3cdc329fc0e92070df27f0372292db6d", "canonicalization": "JCS" }, "ingredients": [ { "url": "https://news.ycombinator.com/", "sha256": "4c52087646a3dd1d2080b710f40669be2aa142847bc3d8d57484b643e0576fd7" } ], "payment": { "scheme": "api-key", "network": "eip155:8453", "payer": "sample" } }, "proof": { "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "created": "2026-11-04T20:24:57.199Z", "verificationMethod": "did:web:agents.writerslogic.com#key-1", "proofPurpose": "assertionMethod", "proofValue": "z53mxyy58rBsXbjaikG6YHAjuw9xTCgsDoBM5cG3r2WTiWc5XbYpr8aF1cmvTGgYTSX1hMpPi35E6rtZdiEb8d89o" } }, "ethSignature": { "type": "EIP-191", "signer": "did:pkh:eip155:8453:0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "address": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "message": "writerslogic-provenance:e697bc1d40337cf1148759c2424b3285716bfc9522612dd007fcd34b4d324e62", "signature": "0xf00998a2a3662a534ccdf4bb255ea9d0901dd481099c6663637d80d81611fb5655859bee5ac42c5486315b4292d53229ac7c9949649902240ecf26a526f2b06f1c" } } } } } }, "400": { "description": "Invalid request. The `error` field names the offending field and `code` is `invalid_request`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "401": { "description": "Missing or invalid RapidAPI key.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } }, "402": { "description": "Payment required. The request did not arrive through RapidAPI.", "content": { "application/json": { "schema": { "type": "object", "description": "x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)", "properties": { "x402Version": { "type": "integer" }, "error": { "type": "string" }, "code": { "type": "string" }, "resource": { "type": "object" }, "accepts": { "type": "array", "items": { "type": "object" } }, "extensions": { "type": "object" } } } } } }, "502": { "description": "A source or model this endpoint depends on failed. Retry later; the body carries an `error` message and a `code`.", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "code": { "type": "string" } } } } } } }, "externalDocs": { "url": "https://writerslogic.com/agents/heal-scraper/", "description": "Documentation for Self-Healing Scraper & DOM-to-JSON Compiler: what it does, every input and result field, an example call and the response shape. A free signed sample response is linked from the page." }, "x-tests": [ { "name": "heal-scraper: unknown field is rejected", "method": "POST", "path": "/v1/heal-scraper", "body": { "nonsense": true }, "assert": { "status": 400, "json": { "code": "invalid_request" }, "maxMs": 10000 } }, { "name": "heal-scraper: example returns a signed result", "method": "POST", "path": "/v1/heal-scraper", "body": { "url": "https://news.ycombinator.com", "targetSchema": { "type": "array", "items": { "type": "object", "required": [ "title", "link" ], "properties": { "title": { "type": "string" }, "link": { "type": "string" }, "points": { "type": "integer" } } } }, "previousBrokenSelectors": { "title": ".storylink" } }, "assert": { "status": 200, "jsonPathsExist": [ "data", "_provenance.credential" ], "jsonSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "source_url": { "type": [ "string", "null" ] }, "healed": { "type": "boolean" }, "decidedBy": { "type": "string", "enum": [ "previous_selectors", "repaired_selectors", "structured_markup", "llm" ] }, "deterministic": { "type": "boolean" }, "llmCalls": { "type": "integer" }, "llmFields": { "type": "array", "items": { "type": "string" } }, "repairs": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" }, "strategy": { "type": "string" } } } }, "data": {}, "selectorMap": { "type": "object" }, "spec": { "type": "object" }, "validation": { "type": "object" }, "extractorCode": { "type": "string" }, "page_structure_notes": { "type": "string" } } }, "_provenance": { "type": "object" } }, "required": [ "data", "_provenance" ] }, "maxMs": 120000 } } ] } }, "/v1/verify-provenance": { "post": { "operationId": "verifyProvenance", "summary": "Verify a Signed Result", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "description": "The `data` field of the response being verified, unchanged." }, "_provenance": { "type": "object", "description": "The `_provenance` field of the same response, unchanged." } }, "required": [ "data", "_provenance" ] }, "examples": { "A signed response": { "summary": "A signed response", "value": { "data": { "url": "https://example.com/", "final_url": "https://example.com/", "title": "Example Domain", "canonical": null, "lang": "en", "description": null, "format": "markdown", "content": "This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes.", "word_count": 25, "truncated": false, "content_sha256": "0a080719be9fbb82a86a45b80dc8c2a430fbe17dc93d23758debac092864d00f", "html_sha256": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484", "links": [], "fetched_at": "2026-11-06T17:55:19.431Z", "limits": { "note": "no JavaScript rendering; one request; robots.txt not consulted" } }, "_provenance": { "version": "writerslogic-provenance/1", "issuer": "did:web:agents.writerslogic.com", "verify": { "endpoint": "POST /api/v1/verify-provenance", "did": "did:web:agents.writerslogic.com" }, "manifest": { "format": "application/json", "instance_id": "xmp:iid:54fac44f-12e7-4547-a4ea-e892f4623ca6", "claim_generator_info": [ { "name": "WritersLogic x402 Agent Hub", "version": "2.0.0" } ], "title": "Page contents: URL to clean Markdown or text", "assertions": [ { "label": "c2pa.actions.v2", "data": { "actions": [ { "action": "c2pa.created", "when": "2026-11-06T17:55:19.443Z", "softwareAgent": { "name": "writerslogic-agent-hub/page-contents", "version": "2.0.0" }, "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia", "parameters": { "endpoint": "POST /api/v1/page-contents", "inputDigest": { "alg": "sha256", "hash": "df2ac97223ac0478b6c6621d7c8a3d7bfe33037cfa1c47749c89100794df07ef", "canonicalization": "JCS" } } } ] } }, { "label": "c2pa.hash.data", "data": { "alg": "sha256", "hash": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "name": "jcs-canonical-json(data)" } }, { "label": "c2pa.ingredient.v3", "data": { "title": "https://example.com/", "format": "text/html", "relationship": "inputTo", "dc": { "source": "https://example.com/", "date": "2026-11-06T17:55:19.443Z" }, "hash": { "alg": "sha256", "hash": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484", "basis": "body" } } } ] }, "credential": { "@context": [ "https://www.w3.org/ns/credentials/v2" ], "id": "urn:uuid:33216a77-d024-472f-ba4d-13438a2bf6ba", "type": [ "VerifiableCredential", "AgentOutputCredential" ], "issuer": "did:web:agents.writerslogic.com", "validFrom": "2026-11-06T17:55:19.443Z", "credentialSubject": { "id": "urn:sha256:d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "agent": "page-contents", "endpoint": "POST /api/v1/page-contents", "outputDigest": { "alg": "sha256", "value": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "canonicalization": "JCS" }, "inputDigest": { "alg": "sha256", "value": "df2ac97223ac0478b6c6621d7c8a3d7bfe33037cfa1c47749c89100794df07ef", "canonicalization": "JCS" }, "manifestDigest": { "alg": "sha256", "value": "b33ed80ac42f39ddcd72d0af27c6774f62350e93e3265b2d1bca01c0d71c584a", "canonicalization": "JCS" }, "ingredients": [ { "url": "https://example.com/", "sha256": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484" } ], "payment": { "scheme": "api-key", "network": "eip155:8453", "payer": "sample" } }, "proof": { "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "created": "2026-11-06T17:55:19.443Z", "verificationMethod": "did:web:agents.writerslogic.com#key-1", "proofPurpose": "assertionMethod", "proofValue": "z2AtwZQqTStnrRzCnCohybJ3cwRpsc52hhweLLPbdcHLTn7XXyD9sVRWD61uSpUsfJ88qSePKYKXyHT3vjxq4MtSZ" } }, "ethSignature": { "type": "EIP-191", "signer": "did:pkh:eip155:8453:0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "address": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "message": "writerslogic-provenance:153a58f215a0314d9fa994f7ab88cece46f678cca7e6f1628dab0638becfdbc4", "signature": "0x9c165b64d61abe9a39a0f131729fd98bb9059c9e22ac5d7df3499730b4efbe4d45f81df06f69e06888d4d80f2bb823857fcb52a4dc208ab7d37c02158bc65a621c" } } } }, "A tampered copy": { "summary": "A tampered copy (valid is false)", "value": { "data": { "url": "https://example.com/", "final_url": "https://example.com/", "title": "Example Domain", "canonical": null, "lang": "en", "description": null, "format": "markdown", "content": "This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes.", "word_count": 25, "truncated": false, "content_sha256": "0a080719be9fbb82a86a45b80dc8c2a430fbe17dc93d23758debac092864d00f", "html_sha256": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484", "links": [], "fetched_at": "2026-11-06T17:55:19.431Z", "limits": { "note": "no JavaScript rendering; one request; robots.txt not consulted" }, "tampered": true }, "_provenance": { "version": "writerslogic-provenance/1", "issuer": "did:web:agents.writerslogic.com", "verify": { "endpoint": "POST /api/v1/verify-provenance", "did": "did:web:agents.writerslogic.com" }, "manifest": { "format": "application/json", "instance_id": "xmp:iid:54fac44f-12e7-4547-a4ea-e892f4623ca6", "claim_generator_info": [ { "name": "WritersLogic x402 Agent Hub", "version": "2.0.0" } ], "title": "Page contents: URL to clean Markdown or text", "assertions": [ { "label": "c2pa.actions.v2", "data": { "actions": [ { "action": "c2pa.created", "when": "2026-11-06T17:55:19.443Z", "softwareAgent": { "name": "writerslogic-agent-hub/page-contents", "version": "2.0.0" }, "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia", "parameters": { "endpoint": "POST /api/v1/page-contents", "inputDigest": { "alg": "sha256", "hash": "df2ac97223ac0478b6c6621d7c8a3d7bfe33037cfa1c47749c89100794df07ef", "canonicalization": "JCS" } } } ] } }, { "label": "c2pa.hash.data", "data": { "alg": "sha256", "hash": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "name": "jcs-canonical-json(data)" } }, { "label": "c2pa.ingredient.v3", "data": { "title": "https://example.com/", "format": "text/html", "relationship": "inputTo", "dc": { "source": "https://example.com/", "date": "2026-11-06T17:55:19.443Z" }, "hash": { "alg": "sha256", "hash": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484", "basis": "body" } } } ] }, "credential": { "@context": [ "https://www.w3.org/ns/credentials/v2" ], "id": "urn:uuid:33216a77-d024-472f-ba4d-13438a2bf6ba", "type": [ "VerifiableCredential", "AgentOutputCredential" ], "issuer": "did:web:agents.writerslogic.com", "validFrom": "2026-11-06T17:55:19.443Z", "credentialSubject": { "id": "urn:sha256:d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "agent": "page-contents", "endpoint": "POST /api/v1/page-contents", "outputDigest": { "alg": "sha256", "value": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "canonicalization": "JCS" }, "inputDigest": { "alg": "sha256", "value": "df2ac97223ac0478b6c6621d7c8a3d7bfe33037cfa1c47749c89100794df07ef", "canonicalization": "JCS" }, "manifestDigest": { "alg": "sha256", "value": "b33ed80ac42f39ddcd72d0af27c6774f62350e93e3265b2d1bca01c0d71c584a", "canonicalization": "JCS" }, "ingredients": [ { "url": "https://example.com/", "sha256": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484" } ], "payment": { "scheme": "api-key", "network": "eip155:8453", "payer": "sample" } }, "proof": { "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "created": "2026-11-06T17:55:19.443Z", "verificationMethod": "did:web:agents.writerslogic.com#key-1", "proofPurpose": "assertionMethod", "proofValue": "z2AtwZQqTStnrRzCnCohybJ3cwRpsc52hhweLLPbdcHLTn7XXyD9sVRWD61uSpUsfJ88qSePKYKXyHT3vjxq4MtSZ" } }, "ethSignature": { "type": "EIP-191", "signer": "did:pkh:eip155:8453:0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "address": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "message": "writerslogic-provenance:153a58f215a0314d9fa994f7ab88cece46f678cca7e6f1628dab0638becfdbc4", "signature": "0x9c165b64d61abe9a39a0f131729fd98bb9059c9e22ac5d7df3499730b4efbe4d45f81df06f69e06888d4d80f2bb823857fcb52a4dc208ab7d37c02158bc65a621c" } } } } } } }, "description": "The complete response body to verify, exactly as the endpoint returned it: both `data` and `_provenance`." }, "responses": { "200": { "description": "The verification result: `valid` is true when every check passes, and `checks` lists each check with its outcome.", "content": { "application/json": { "schema": { "type": "object" }, "example": { "valid": true, "checks": [ { "check": "version", "ok": true, "detail": "writerslogic-provenance/1" }, { "check": "outputDigest", "ok": true, "detail": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46" }, { "check": "manifestDigest", "ok": true }, { "check": "c2pa.hash.data", "ok": true }, { "check": "proof", "ok": true }, { "check": "ethSignature", "ok": true, "detail": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f" } ] } } } } }, "description": "Checks the signed provenance envelope of any response from this API: structure, output and manifest digests, the Ed25519 credential proof and the Ethereum co-signature. Send the complete response body with its data and _provenance fields. It reads no outside source, so the result is the same on every call.", "x-tests": [ { "name": "verify: a signed sample verifies", "method": "POST", "path": "/v1/verify-provenance", "body": { "data": { "url": "https://example.com/", "final_url": "https://example.com/", "title": "Example Domain", "canonical": null, "lang": "en", "description": null, "format": "markdown", "content": "This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes.", "word_count": 25, "truncated": false, "content_sha256": "0a080719be9fbb82a86a45b80dc8c2a430fbe17dc93d23758debac092864d00f", "html_sha256": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484", "links": [], "fetched_at": "2026-11-06T17:55:19.431Z", "limits": { "note": "no JavaScript rendering; one request; robots.txt not consulted" } }, "_provenance": { "version": "writerslogic-provenance/1", "issuer": "did:web:agents.writerslogic.com", "verify": { "endpoint": "POST /api/v1/verify-provenance", "did": "did:web:agents.writerslogic.com" }, "manifest": { "format": "application/json", "instance_id": "xmp:iid:54fac44f-12e7-4547-a4ea-e892f4623ca6", "claim_generator_info": [ { "name": "WritersLogic x402 Agent Hub", "version": "2.0.0" } ], "title": "Page contents: URL to clean Markdown or text", "assertions": [ { "label": "c2pa.actions.v2", "data": { "actions": [ { "action": "c2pa.created", "when": "2026-11-06T17:55:19.443Z", "softwareAgent": { "name": "writerslogic-agent-hub/page-contents", "version": "2.0.0" }, "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia", "parameters": { "endpoint": "POST /api/v1/page-contents", "inputDigest": { "alg": "sha256", "hash": "df2ac97223ac0478b6c6621d7c8a3d7bfe33037cfa1c47749c89100794df07ef", "canonicalization": "JCS" } } } ] } }, { "label": "c2pa.hash.data", "data": { "alg": "sha256", "hash": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "name": "jcs-canonical-json(data)" } }, { "label": "c2pa.ingredient.v3", "data": { "title": "https://example.com/", "format": "text/html", "relationship": "inputTo", "dc": { "source": "https://example.com/", "date": "2026-11-06T17:55:19.443Z" }, "hash": { "alg": "sha256", "hash": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484", "basis": "body" } } } ] }, "credential": { "@context": [ "https://www.w3.org/ns/credentials/v2" ], "id": "urn:uuid:33216a77-d024-472f-ba4d-13438a2bf6ba", "type": [ "VerifiableCredential", "AgentOutputCredential" ], "issuer": "did:web:agents.writerslogic.com", "validFrom": "2026-11-06T17:55:19.443Z", "credentialSubject": { "id": "urn:sha256:d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "agent": "page-contents", "endpoint": "POST /api/v1/page-contents", "outputDigest": { "alg": "sha256", "value": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "canonicalization": "JCS" }, "inputDigest": { "alg": "sha256", "value": "df2ac97223ac0478b6c6621d7c8a3d7bfe33037cfa1c47749c89100794df07ef", "canonicalization": "JCS" }, "manifestDigest": { "alg": "sha256", "value": "b33ed80ac42f39ddcd72d0af27c6774f62350e93e3265b2d1bca01c0d71c584a", "canonicalization": "JCS" }, "ingredients": [ { "url": "https://example.com/", "sha256": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484" } ], "payment": { "scheme": "api-key", "network": "eip155:8453", "payer": "sample" } }, "proof": { "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "created": "2026-11-06T17:55:19.443Z", "verificationMethod": "did:web:agents.writerslogic.com#key-1", "proofPurpose": "assertionMethod", "proofValue": "z2AtwZQqTStnrRzCnCohybJ3cwRpsc52hhweLLPbdcHLTn7XXyD9sVRWD61uSpUsfJ88qSePKYKXyHT3vjxq4MtSZ" } }, "ethSignature": { "type": "EIP-191", "signer": "did:pkh:eip155:8453:0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "address": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "message": "writerslogic-provenance:153a58f215a0314d9fa994f7ab88cece46f678cca7e6f1628dab0638becfdbc4", "signature": "0x9c165b64d61abe9a39a0f131729fd98bb9059c9e22ac5d7df3499730b4efbe4d45f81df06f69e06888d4d80f2bb823857fcb52a4dc208ab7d37c02158bc65a621c" } } }, "assert": { "status": 200, "json": { "valid": true }, "maxMs": 10000 } }, { "name": "verify: a tampered sample fails", "method": "POST", "path": "/v1/verify-provenance", "body": { "data": { "url": "https://example.com/", "final_url": "https://example.com/", "title": "Example Domain", "canonical": null, "lang": "en", "description": null, "format": "markdown", "content": "This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring purposes.", "word_count": 25, "truncated": false, "content_sha256": "0a080719be9fbb82a86a45b80dc8c2a430fbe17dc93d23758debac092864d00f", "html_sha256": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484", "links": [], "fetched_at": "2026-11-06T17:55:19.431Z", "limits": { "note": "no JavaScript rendering; one request; robots.txt not consulted" }, "tampered": true }, "_provenance": { "version": "writerslogic-provenance/1", "issuer": "did:web:agents.writerslogic.com", "verify": { "endpoint": "POST /api/v1/verify-provenance", "did": "did:web:agents.writerslogic.com" }, "manifest": { "format": "application/json", "instance_id": "xmp:iid:54fac44f-12e7-4547-a4ea-e892f4623ca6", "claim_generator_info": [ { "name": "WritersLogic x402 Agent Hub", "version": "2.0.0" } ], "title": "Page contents: URL to clean Markdown or text", "assertions": [ { "label": "c2pa.actions.v2", "data": { "actions": [ { "action": "c2pa.created", "when": "2026-11-06T17:55:19.443Z", "softwareAgent": { "name": "writerslogic-agent-hub/page-contents", "version": "2.0.0" }, "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia", "parameters": { "endpoint": "POST /api/v1/page-contents", "inputDigest": { "alg": "sha256", "hash": "df2ac97223ac0478b6c6621d7c8a3d7bfe33037cfa1c47749c89100794df07ef", "canonicalization": "JCS" } } } ] } }, { "label": "c2pa.hash.data", "data": { "alg": "sha256", "hash": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "name": "jcs-canonical-json(data)" } }, { "label": "c2pa.ingredient.v3", "data": { "title": "https://example.com/", "format": "text/html", "relationship": "inputTo", "dc": { "source": "https://example.com/", "date": "2026-11-06T17:55:19.443Z" }, "hash": { "alg": "sha256", "hash": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484", "basis": "body" } } } ] }, "credential": { "@context": [ "https://www.w3.org/ns/credentials/v2" ], "id": "urn:uuid:33216a77-d024-472f-ba4d-13438a2bf6ba", "type": [ "VerifiableCredential", "AgentOutputCredential" ], "issuer": "did:web:agents.writerslogic.com", "validFrom": "2026-11-06T17:55:19.443Z", "credentialSubject": { "id": "urn:sha256:d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "agent": "page-contents", "endpoint": "POST /api/v1/page-contents", "outputDigest": { "alg": "sha256", "value": "d4afce90393123c0fc632209e39b5ae3a02b6a99f5392afaf8ed8999f52b9a46", "canonicalization": "JCS" }, "inputDigest": { "alg": "sha256", "value": "df2ac97223ac0478b6c6621d7c8a3d7bfe33037cfa1c47749c89100794df07ef", "canonicalization": "JCS" }, "manifestDigest": { "alg": "sha256", "value": "b33ed80ac42f39ddcd72d0af27c6774f62350e93e3265b2d1bca01c0d71c584a", "canonicalization": "JCS" }, "ingredients": [ { "url": "https://example.com/", "sha256": "25ddf2c883e0d1958ea971d279a7e4f0fd446724ee3db7db19dadabd4a62e484" } ], "payment": { "scheme": "api-key", "network": "eip155:8453", "payer": "sample" } }, "proof": { "type": "DataIntegrityProof", "cryptosuite": "eddsa-jcs-2022", "created": "2026-11-06T17:55:19.443Z", "verificationMethod": "did:web:agents.writerslogic.com#key-1", "proofPurpose": "assertionMethod", "proofValue": "z2AtwZQqTStnrRzCnCohybJ3cwRpsc52hhweLLPbdcHLTn7XXyD9sVRWD61uSpUsfJ88qSePKYKXyHT3vjxq4MtSZ" } }, "ethSignature": { "type": "EIP-191", "signer": "did:pkh:eip155:8453:0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "address": "0x3DBd42560cA7a7E448A2c7DfC9E785526189411f", "message": "writerslogic-provenance:153a58f215a0314d9fa994f7ab88cece46f678cca7e6f1628dab0638becfdbc4", "signature": "0x9c165b64d61abe9a39a0f131729fd98bb9059c9e22ac5d7df3499730b4efbe4d45f81df06f69e06888d4d80f2bb823857fcb52a4dc208ab7d37c02158bc65a621c" } } }, "assert": { "status": 200, "json": { "valid": false }, "maxMs": 10000 } } ], "externalDocs": { "url": "https://writerslogic.com/agents/", "description": "How the signed provenance envelope works, and the documentation index for every agent whose output it verifies." } } } }, "externalDocs": { "url": "https://writerslogic.com/agents/", "description": "Documentation for every WritersLogic agent: human-readable pages plus an index.json listing machine-readable records." }, "x-documentation": { "readme": " $\"WritersLogic$ \n\n## Web Search, Page to Markdown & Document Conversion API\n\n**Search. Extract. Convert. Verify.**\n\nOne API for web search, document conversion, transcription, screenshots, and structured extraction. Every successful response includes cryptographically signed provenance for independent integrity verification.\n\n## Quick Start\n\nSubscribe through RapidAPI, select an endpoint in the Playground, and run its example—or make a request directly.\n\n**Example: Convert a web page to Markdown**\n\n```bash\ncurl -X POST \"https://$RAPIDAPI_HOST/v1/page-contents\" \\\n -H \"Content-Type: application/json\" \\\n -H \"X-RapidAPI-Key: $RAPIDAPI_KEY\" \\\n -H \"X-RapidAPI-Host: $RAPIDAPI_HOST\" \\\n -d '{\n \"url\": \"https://example.com/\",\n \"format\": \"markdown\",\n \"max_chars\": 20000\n }'\n```\n\nAll endpoints accept `POST` requests with JSON bodies. Replace the environment variables with your RapidAPI host and API key.\n\n## Seven Endpoints. One API.\n\n| Endpoint | Capability |\n|---|---|\n| **Web Search — Exa & Brave** | Up to 10 ranked results with URLs, snippets, highlights, and available publication dates. |\n| **Web Page to Clean Markdown** | Extract main content as Markdown or text, preserving links, metadata, and content hashes. |\n| **Document to Markdown** | Convert PDF, DOCX, XLSX, PPTX, HTML, Markdown, TXT, CSV, and JSON, with page-level hashes where supported. |\n| **Audio & Video Transcription** | Transcribe public media URLs using Whisper large-v3-turbo, with timestamps and subtitles. |\n| **Web Page Screenshot & PDF** | Render JavaScript-enabled pages as PNG, JPEG, or PDF, with SHA-256 integrity hashes. |\n| **Self-Healing Scraper Selectors** | Generate and validate resilient CSS selectors against a live DOM using a target JSON schema. |\n| **Verify a Signed Result** | Validate provenance digests, Ed25519 credential proofs, and Ethereum EIP-191 co-signatures. |\n\n## Every Result Comes with Proof\n\nMost APIs return data. **WritersLogic also returns cryptographic evidence of the result and its recorded sources.**\n\nEvery successful response includes:\n\n- **SHA-256 digests** to detect modifications.\n- **Source provenance** recording what was processed.\n- **Ed25519 signatures** to authenticate the signing identity.\n- **Independent verification** through public cryptographic credentials.\n\n**Simplified response:**\n\n```json\n{\n \"data\": {\n \"...\": \"Endpoint-specific result\"\n },\n \"_provenance\": {\n \"version\": \"writerslogic-provenance/1\",\n \"manifest\": {\n \"...\": \"Source records and SHA-256 digests\"\n },\n \"credential\": {\n \"...\": \"W3C Verifiable Credential\"\n },\n \"ethSignature\": {\n \"...\": \"EIP-191 co-signature\"\n }\n }\n}\n```\n\nA valid signature establishes integrity and signing-key authenticity—not the factual accuracy of the underlying source.\n\n

Cryptographic Verification & Technical Details

\n\n

Submit the complete response to the Verify a Signed Result endpoint to validate:

\n\n

Provenance envelope structure and version
Output and manifest SHA-256 digests
W3C Verifiable Credential and Ed25519 proof
Ethereum EIP-191 co-signature

\n\n

Publisher DID: did:web:agents.writerslogic.com

\n\n

Public DID document: View verification keys

\n\n

Results can also be verified independently using the published key material and applicable signature and canonicalization specifications.

\n\n

Changing the signed result or its covered metadata causes the corresponding digest or signature check to fail.

\n\n

\n\n## Built for Real-World Workflows\n\n**AI agents & RAG** — Search, extract, and normalize web content with verifiable provenance.\n\n**Research & due diligence** — Retrieve sources, process documents, and preserve signed evidence.\n\n**Compliance & auditing** — Capture pages, fingerprint documents, and verify stored outputs.\n\n**Data engineering** — Automate structured extraction, media transcription, and ingestion pipelines.\n\n

Limits, Security & Processing

\n\n

Public resources: No authenticated pages, private networks, or internal hosts.
JavaScript: Supported for screenshots and PDFs; not executed during Markdown extraction.
Transcription: MP3, WAV, MP4, M4A, OGG, WebM, and FLAC; up to 25 MB and 30 minutes.
Processing: Model-backed requests may take up to approximately 90 seconds. Configure timeouts of at least 120 seconds.
Input handling: Inputs are processed for the individual request and are not stored by the service.
Verification scope: Cryptographic proof establishes integrity, not independent factual correctness.

\n\n

Error Codes & Troubleshooting

\n\n

400 — Invalid request: Missing or invalid input. Inspect the error field.
401 — Unauthorized: Missing or invalid RapidAPI key.
402 — Payment required: Request not routed through RapidAPI.
502 — Upstream failure: Source or model processing failed. Retry with backoff.

\n\n

Example error:

\n\n

{\n  \"error\": \"$.text: required\",\n  \"code\": \"invalid_request\"\n}

\n\n

About WritersLogic

\n\n

Verifiable AI infrastructure. Proof, not promises.

\n\n

WritersLogic develops cryptographic infrastructure for AI agents, content provenance, and independently verifiable digital workflows.

\n\n

Full API documentation

\n\n

Public signing identity

\n\n

\n\n---\n\n**Ready to integrate?** Select an endpoint in the RapidAPI Playground and run your first signed request." } }