Servidor MCP

ReplyNodes

            com.replynodes/mcp
        

Datos y analítica Búsqueda e investigación Público y accesible MCP 2025-11-25

Qué hace este MCP

Scrapes and searches websites and structured sources including app stores, Hacker News, brand profiles, reviews, permissions, and public app metadata.

app

Look up one public App Store application Look up one public App Store application. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/app

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'id': {'type': 'string', 'description': 'Numeric track id; provide this or appId.'}, 'lang': {'type': 'string', 'description': 'Language code.'}, 'appId': {'type': 'string', 'description': 'Bundle id; provide this or id.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'ratings': {'type': 'boolean', 'description': 'Include ratings information.'}}, 'additionalProperties': False}

brand_fonts

Get Fonts Extract the typography and font stack of a website by domain or URL. HTTP: GET /v1/brand/fonts

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'One specific page URL to extract font information from instead of the whole domain.'}, 'domain': {'type': 'string', 'description': 'Website domain to extract font information from, e.g. replynodes.com. One of domain or url is required.'}}, 'additionalProperties': False}

brand_logo

Get Brand Logo Fetch the brand logo kit for one company domain: primary logo URL, candidate logo variants, favicon, and og_image. HTTP: GET /v1/brand/logo

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'description': 'Company domain to resolve, e.g. stripe.com. A bare domain only: no scheme, port, path, or credentials.'}}, 'additionalProperties': False}

brand_retrieve

Retrieve Brand Resolve the full brand profile of a company by domain, or extract brand details from one specific page URL: name, description, primary logo, logos, colors, fonts, social links, favicon, and og_image. HTTP: GET /v1/brand/retrieve

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'One specific page URL to extract brand details from instead of the whole domain.'}, 'domain': {'type': 'string', 'description': 'Company domain to resolve, e.g. apple.com. One of domain or url is required.'}}, 'additionalProperties': False}

brand_search

Search Brand Fuzzy brand or company search by name or domain; returns up to 10 lightweight matches with domain, name, and logo. HTTP: GET /v1/brand/search

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['query'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Maximum number of matches to return (default and maximum 10).'}, 'query': {'type': 'string', 'description': 'Brand name or domain to search for.'}}, 'additionalProperties': False}

brand_styleguide

Get Styleguide Extract the design system of a website by domain or URL: colors, typography, spacing, and more. HTTP: GET /v1/brand/styleguide

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'One specific page URL to extract a styleguide from instead of the whole domain.'}, 'domain': {'type': 'string', 'description': 'Website domain to extract a styleguide from, e.g. replynodes.com. One of domain or url is required.'}}, 'additionalProperties': False}

developer

List applications by developer List applications by developer. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/developer

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['devId'], 'properties': {'lang': {'type': 'string', 'description': 'Language code.'}, 'devId': {'type': 'string', 'description': 'public developer identifier.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}}, 'additionalProperties': False}

get_fetcher_healthz

Health check HTTP: GET /fetcher/healthz

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {}, 'additionalProperties': False}

get_fetcher_readyz

Readiness (auth/db status) HTTP: GET /fetcher/readyz

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {}, 'additionalProperties': False}

get_v1_hackernews_capabilities

List available operations HTTP: GET /v1/hackernews/capabilities

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {}, 'additionalProperties': False}

googleplay_app_details

Fetch a single Google Play app's public detail record Fetch a single Google Play app's public detail record. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/app_details/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Google Play package id (e.g. com.nike.snkrs).'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'language': {'type': 'string', 'description': 'Language code.'}}, 'additionalProperties': False}

googleplay_availability

Fetch a Google Play app's per-storefront availability Fetch a Google Play app's per-storefront availability. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/availability/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Google Play package id (e.g. com.nike.snkrs).'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'language': {'type': 'string', 'description': 'Language code.'}, 'countries': {'type': 'string', 'description': 'Comma-separated storefront codes.'}}, 'additionalProperties': False}

googleplay_categories

List available Google Play category identifiers List available Google Play category identifiers. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/categories

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'language': {'type': 'string', 'description': 'Language code.'}}, 'additionalProperties': False}

googleplay_category_apps

Fetch top public apps in a Google Play category Fetch top public apps in a Google Play category. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/category_apps/{category}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['category'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..50 are rejected.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'category': {'type': 'string', 'description': 'Google Play category identifier (e.g. GAME, SHOPPING).'}, 'language': {'type': 'string', 'description': 'Language code.'}}, 'additionalProperties': False}

googleplay_data_safety

Fetch a Google Play app's declared data-safety disclosure Fetch a Google Play app's declared data-safety disclosure. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/data_safety/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Google Play package id (e.g. com.nike.snkrs).'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'language': {'type': 'string', 'description': 'Language code.'}}, 'additionalProperties': False}

googleplay_developer

Fetch public apps published by a Google Play developer Fetch public apps published by a Google Play developer. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/developer

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['dev_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..50 are rejected.'}, 'dev_id': {'type': 'string', 'description': 'Google Play developer id.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'language': {'type': 'string', 'description': 'Language code.'}}, 'additionalProperties': False}

googleplay_permissions

Fetch a Google Play app's declared permissions Fetch a Google Play app's declared permissions. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/permissions/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Google Play package id (e.g. com.nike.snkrs).'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'language': {'type': 'string', 'description': 'Language code.'}}, 'additionalProperties': False}

googleplay_reviews

Fetch public reviews for a Google Play app Fetch public reviews for a Google Play app. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/reviews/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Google Play package id (e.g. com.nike.snkrs).'}, 'sort': {'type': 'integer', 'description': 'Upstream review sort order.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..50 are rejected.'}, 'score': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Filter reviews to this star rating (1..5).'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'language': {'type': 'string', 'description': 'Language code.'}, 'next_token': {'type': 'string', 'description': 'Pagination token from a previous reviews response.'}}, 'additionalProperties': False}

googleplay_search

Search public Google Play applications by term Search public Google Play applications by term. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/search

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['term'], 'properties': {'term': {'type': 'string', 'description': 'Search term.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..50 are rejected.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'language': {'type': 'string', 'description': 'Language code.'}}, 'additionalProperties': False}

googleplay_similar_apps

Fetch apps similar to a given Google Play package Fetch apps similar to a given Google Play package. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/similar_apps/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Google Play package id (e.g. com.nike.snkrs).'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..50 are rejected.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'language': {'type': 'string', 'description': 'Language code.'}}, 'additionalProperties': False}

googleplay_suggest

Fetch Google Play search-term suggestions Fetch Google Play search-term suggestions. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/googleplay/suggest

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['term'], 'properties': {'term': {'type': 'string', 'description': 'Search term.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..50 are rejected.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'language': {'type': 'string', 'description': 'Language code.'}}, 'additionalProperties': False}

hackernews_item

Fetch a single Hacker News item and its comment tree Fetch a single Hacker News item and its comment tree. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/item/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'integer', 'description': 'Hacker News item id.'}, 'depth': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Maximum comment-tree depth to resolve; values outside 1..10 are rejected.'}}, 'additionalProperties': False}

hackernews_search

Search Hacker News via Algolia Search Hacker News via Algolia. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/search

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['q'], 'properties': {'q': {'type': 'string', 'description': 'Search query.'}, 'page': {'type': 'integer', 'minimum': 0, 'description': 'Result page.'}, 'tags': {'type': 'string', 'description': 'Algolia HN Search tag filter (e.g. story, comment, ask_hn).'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..100 are rejected.'}}, 'additionalProperties': False}

hackernews_stories_ask

Fetch current Ask HN stories Fetch current Ask HN stories. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_ask

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Result page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..100 are rejected.'}}, 'additionalProperties': False}

hackernews_stories_best

Fetch current Hacker News best stories Fetch current Hacker News best stories. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_best

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Result page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..100 are rejected.'}}, 'additionalProperties': False}

hackernews_stories_job

Fetch current Hacker News job postings Fetch current Hacker News job postings. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_job

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Result page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..100 are rejected.'}}, 'additionalProperties': False}

hackernews_stories_new

Fetch current Hacker News new stories Fetch current Hacker News new stories. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_new

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Result page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..100 are rejected.'}}, 'additionalProperties': False}

hackernews_stories_show

Fetch current Show HN stories Fetch current Show HN stories. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_show

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Result page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..100 are rejected.'}}, 'additionalProperties': False}

hackernews_stories_top

Fetch current Hacker News top stories Fetch current Hacker News top stories. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/stories_top

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Result page.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..100 are rejected.'}}, 'additionalProperties': False}

hackernews_user

Fetch a public Hacker News user profile Fetch a public Hacker News user profile. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/hackernews/user/{handle}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'description': 'Hacker News username.'}}, 'additionalProperties': False}

list

List applications from an iTunes collection List applications from an iTunes collection. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/list

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'num': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Number of applications; values outside 1..200 are rejected.'}, 'lang': {'type': 'string', 'description': 'Language code.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'category': {'type': 'string', 'description': 'Provider category constant.'}, 'collection': {'type': 'string', 'description': 'Provider collection constant.'}, 'fullDetail': {'type': 'boolean', 'description': 'Request detail enrichment.'}}, 'additionalProperties': False}

monitor_changes

List monitor changes HTTP: GET /v1/monitors/{id}/changes

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'format': 'uuid', 'description': 'path parameter'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'query parameter'}, 'cursor': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

monitor_create

Create a monitor asynchronously HTTP: POST /v1/monitors

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['Idempotency-Key', 'body'], 'properties': {'body': {'$ref': '#/$defs/MonitorCreateRequest'}, 'Idempotency-Key': {'type': 'string', 'minLength': 1, 'description': 'header parameter'}}, 'additionalProperties': False}

monitor_get

Get a monitor HTTP: GET /v1/monitors/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'format': 'uuid', 'description': 'path parameter'}}, 'additionalProperties': False}

monitor_list

List monitors for the authenticated organization HTTP: GET /v1/monitors

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'query parameter'}, 'cursor': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

monitor_runs

List monitor runs HTTP: GET /v1/monitors/{id}/runs

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'format': 'uuid', 'description': 'path parameter'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'query parameter'}, 'cursor': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

monitor_update

Update frequency, pause state, or webhook Update frequency, pause state, or webhook configuration. The change is recorded immediately in the monitor service database (scheduling authority) and the external changedetection watch is reconciled asynchronously and with bounded retries; the response monitor object carries sync_state/sync_next_retry_at/sync_error_reason so a degraded engine (for example, a failed pause) is truthful and visible rather than silently dropped. HTTP: PATCH /v1/monitors/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id', 'body'], 'properties': {'id': {'type': 'string', 'format': 'uuid', 'description': 'path parameter'}, 'body': {'$ref': '#/$defs/MonitorUpdateRequest'}}, 'additionalProperties': False}

post_by_id

HTTP: GET /v1/reddit/post_by_id/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'path parameter'}}, 'additionalProperties': False}

post_by_permalink

HTTP: GET /v1/reddit/post_by_permalink

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['permalink'], 'properties': {'permalink': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

privacy

Read public App Store privacy details Read public App Store privacy details. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/privacy

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'public application identifier.'}}, 'additionalProperties': False}

ratings

Read public app ratings Read public app ratings. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/ratings

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'id': {'type': 'string', 'description': 'public application identifier; provide this or appId.'}, 'appId': {'type': 'string', 'description': 'Bundle id; provide this or id.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}}, 'additionalProperties': False}

read_document

Read a public PDF as Markdown for AI agents Direct public HTTP POST to https://pdf.replynodes.com/ requires no account, API key, or cookie. POST converts one public PDF URL to Markdown. GET and HEAD on the root are documentation-only; allowed methods are GET, HEAD, POST. This PDF to Markdown response is designed for read PDF, PDF for AI agents, extract PDF text, and PDF context workflows. The MCP read_document / tools/call at https://mcp.replynodes.com/mcp requires the existing MCP authorization boundary; MCP is not anonymous. Limits: 10 MiB source/download, 50 pages, 60 seconds, 20 conversions/IP/hour, 2 active conversions/IP, and a maximum encoded JSON response of 1 MiB including the trailing newline. MCP discovery identifies the sole read_document tool at https://mcp.replynodes.com/mcp. HTTP: POST https://pdf.replynodes.com/

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'pattern': '^https?://', 'description': 'Public PDF URL to read.'}}, 'additionalProperties': False}

reviews

Read a page of public app reviews Read a page of public app reviews. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/reviews

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'id': {'type': 'string', 'description': 'public application identifier; provide this or appId.'}, 'page': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Review page; values outside 1..10 are rejected.'}, 'sort': {'type': 'string', 'description': 'Provider review sort constant.'}, 'appId': {'type': 'string', 'description': 'Bundle id; provide this or id.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}}, 'additionalProperties': False}

Search public App Store applications by term Search public App Store applications by term. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/search

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['term'], 'properties': {'num': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Number of results; values outside 1..50 are rejected.'}, 'lang': {'type': 'string', 'description': 'Language code.'}, 'page': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Result page.'}, 'term': {'type': 'string', 'description': 'Search term.'}, 'country': {'type': 'string', 'description': 'Two-letter storefront code.'}, 'idsOnly': {'type': 'boolean', 'description': 'Return ids without detail lookups.'}}, 'additionalProperties': False}

search_posts

HTTP: GET /v1/reddit/search_posts

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['query'], 'properties': {'sort': {'type': 'string', 'description': 'query parameter'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'query parameter'}, 'query': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

similar

List apps related to an application List apps related to an application. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/similar

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'properties': {'id': {'type': 'string', 'description': 'public application identifier; provide this or appId.'}, 'appId': {'type': 'string', 'description': 'Bundle id; provide this or id.'}}, 'additionalProperties': False}

subreddit_posts

HTTP: GET /v1/reddit/subreddit_posts/{subreddit}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['subreddit'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'query parameter'}, 'category': {'type': 'string', 'description': 'query parameter'}, 'subreddit': {'type': 'string', 'description': 'path parameter'}, 'time_filter': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

suggest

Suggest public App Store search terms Suggest public App Store search terms. Returns the normalized public contract; raw provider records are internal to the runtime boundary and never cross the public gateway. HTTP: GET /v1/appstore/suggest

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['term'], 'properties': {'term': {'type': 'string', 'description': 'Search term.'}}, 'additionalProperties': False}

user_activity

HTTP: GET /v1/reddit/user_activity/{username}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['username'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'query parameter'}, 'username': {'type': 'string', 'description': 'path parameter'}}, 'additionalProperties': False}

user_posts

HTTP: GET /v1/reddit/user_posts/{username}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['username'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'query parameter'}, 'category': {'type': 'string', 'description': 'query parameter'}, 'username': {'type': 'string', 'description': 'path parameter'}, 'time_filter': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

webcontext_brand

Extract public brand identity for a site Lightweight brand snapshot for one site URL: logos, colors, fonts, and basic public metadata. Prefer brand_retrieve for a fuller normalized brand profile or brand_search for fuzzy company-name discovery. HTTP: GET /v1/webcontext/brand

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address.'}}, 'additionalProperties': False}

webcontext_crawl

Crawl same-origin links from a URL Crawl same-origin links starting from a URL and return normalized page results. max_pages/max_depth are clamped server-side regardless of the requested value. HTTP: GET /v1/webcontext/crawl

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address.'}, 'max_depth': {'type': 'integer', 'maximum': 3, 'minimum': 1, 'description': 'Maximum link depth; clamped to 1..3.'}, 'max_pages': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum pages to crawl; clamped to 1..50.'}}, 'additionalProperties': False}

webcontext_map

Discover URLs belonging to a site Discover URLs belonging to a site without extracting page content. Results are deduplicated. HTTP: GET /v1/webcontext/map

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address.'}}, 'additionalProperties': False}

webcontext_scrape

Fetch one URL as clean Markdown Fetch one URL and return clean, main-content Markdown plus normalized metadata, links, and images. Backed by a privately deployed webclaw-server instance; upstream implementation details are never exposed. HTTP: GET /v1/webcontext/scrape

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Target URL to fetch. Rejected if it is malformed, uses a disallowed scheme, or resolves to a private/loopback/link-local/cloud-metadata address.'}, 'exclude_selectors': {'type': 'string', 'description': 'Comma-separated CSS selectors to exclude (e.g. "nav,.sidebar,footer").'}, 'include_selectors': {'type': 'string', 'description': 'Comma-separated CSS selectors to include (e.g. "article,.content").'}}, 'additionalProperties': False}

web_search

Search the public web Search the public web through the normalized Web Search provider contract. HTTP: GET /v1/web/search

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['text'], 'properties': {'date': {'type': 'string', 'description': 'Provider date filter.'}, 'lang': {'type': 'string', 'description': 'Language code.'}, 'site': {'type': 'string', 'description': 'Restrict results to a site or domain.'}, 'text': {'type': 'string', 'description': 'Search query text.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of results; values outside 1..100 are rejected.'}, 'start': {'type': 'integer', 'minimum': 0, 'description': 'Zero-based result offset.'}, 'region': {'type': 'string', 'description': 'Search region.'}, 'engines': {'type': 'string', 'description': 'Comma-separated search engines.'}}, 'additionalProperties': False}

youtube_channel

HTTP: GET /v1/youtube/channel/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'path parameter'}, 'language': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

youtube_comments

HTTP: GET /v1/youtube/comments/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'path parameter'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'query parameter'}}, 'additionalProperties': False}

youtube_playlist

HTTP: GET /v1/youtube/playlist/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'path parameter'}, 'language': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

youtube_related

HTTP: GET /v1/youtube/related/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'path parameter'}, 'language': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

youtube_search

HTTP: GET /v1/youtube/search

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['term'], 'properties': {'term': {'type': 'string', 'description': 'query parameter'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'query parameter'}, 'language': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

youtube_transcript

HTTP: GET /v1/youtube/transcript/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'path parameter'}, 'language': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

youtube_video

HTTP: GET /v1/youtube/video/{id}

Esquema de entrada

{'type': 'object', '$defs': {'Error': {'type': 'object', 'properties': {'error': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}}}}, 'Monitor': {'type': 'object', 'required': ['id', 'url', 'detector', 'frequency', 'paused'], 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'url': {'type': 'string', 'format': 'uri'}, 'paused': {'type': 'boolean'}, 'webhook': {'allOf': [{'$ref': '#/$defs/MonitorWebhook'}], 'description': 'Secret is write-only and never returned'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'sync_state': {'enum': ['none', 'pending', 'running', 'retryable', 'failed', 'synced'], 'type': 'string', 'description': 'External changedetection watch reconciliation state. PATCH persists frequency/paused immediately (the database is the scheduling authority); the worker applies the change to the engine\'s watch asynchronously and exposes convergence here. "none" means no external watch exists yet; "pending"/"retryable" are awaiting or retrying the application; "running" is being applied; "failed" exhausted the bounded retry budget and needs a new PATCH to re-arm; "synced" means the engine watch matches the record.'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'next_run_at': {'type': 'string', 'format': 'date-time', 'description': "Canonical next scheduled run in UTC. Reported only while the monitor is schedulable: a monitor whose private watch is still being initialized cannot be claimed (ClaimDue requires initialization_state='ready'), so the field is omitted until initialization completes instead of implying an imminent run. Paused-but-initialized monitors still report their stored schedule; it is suspended until resume."}, 'sync_error_reason': {'type': 'string', 'description': 'Most recent changedetection engine watch reconciliation failure reason'}, 'baseline_completed': {'type': 'boolean'}, 'sync_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable engine watch reconciliation'}, 'initialization_state': {'enum': ['pending', 'initializing', 'retryable', 'ready', 'failed'], 'type': 'string', 'description': 'Asynchronous changedetection watch initialization state'}, 'initialization_error_reason': {'type': 'string', 'description': 'Most recent changedetection initialization failure reason'}, 'initialization_next_retry_at': {'type': 'string', 'format': 'date-time', 'description': 'Next worker retry time for retryable initialization'}}}, 'MonitorRun': {'type': 'object', 'properties': {'id': {'type': 'string', 'format': 'uuid'}, 'status': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'credits': {'type': 'integer'}, 'baseline': {'type': 'boolean'}, 'timestamp': {'type': 'string', 'format': 'date-time'}}}, 'Pagination': {'type': 'object', 'properties': {'page': {'type': 'integer'}, 'limit': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'type': 'string'}}, 'additionalProperties': True}, 'ErrorDetail': {'type': 'object', 'required': ['code', 'message', 'request_id'], 'properties': {'code': {'type': 'string'}, 'message': {'type': 'string'}, 'request_id': {'type': 'string'}}, 'additionalProperties': False}, 'MonitorPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Monitor'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id'], 'properties': {'stale': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'availability': {'type': 'string'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'missing_fields': {'type': 'array', 'items': {'type': 'string'}}, 'contract_version': {'type': 'string'}}, 'additionalProperties': True}, 'BrandLogoData': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The snapshot target URL the logos were extracted from.'}, 'brand': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Public site/brand name detected on the page, when available.'}, 'logos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'kind': {'type': 'string', 'description': 'Asset slot and format (e.g. logo.svg, favicon.ico).'}}}, 'description': 'Candidate logo variants detected on the page.'}, 'logo_url': {'type': 'string', 'format': 'uri', 'description': 'Primary brand logo URL, when available.'}, 'og_image': {'type': 'string', 'format': 'uri'}, 'favicon_url': {'type': 'string', 'format': 'uri'}}}}, 'additionalProperties': False}, 'ErrorResponse': {'type': 'object', 'required': ['error'], 'properties': {'error': {'$ref': '#/$defs/ErrorDetail'}}, 'additionalProperties': False}, 'BrandFontsData': {'type': 'object', 'required': ['domain', 'url', 'count'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'count': {'type': 'integer', 'minimum': 0}, 'fonts': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'domain': {'type': 'string'}, 'words_count': {'type': 'integer', 'minimum': 0, 'description': 'Word count reported by the rendered page metadata, when available.'}}, 'additionalProperties': False}, 'MonitorWebhook': {'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'secret': {'type': 'string', 'writeOnly': True, 'description': 'HMAC secret used to sign deliveries. Write-only: it is never returned, logged, or rendered into the payload.'}}, 'description': "Signed webhook notification endpoint (issue #485). The URL must be a public HTTPS target; localhost/private/link-local/metadata/CGNAT destinations and non-HTTPS schemes are rejected unless the service is explicitly configured otherwise for a non-production harness. The secret is AES-256-GCM encrypted at rest. When a monitor change is detected the service POSTs the MonitorChangeEvent payload to this URL with headers X-ReplyNodes-Event-Id (<event_id>), X-ReplyNodes-Timestamp (Unix seconds of this attempt) and X-ReplyNodes-Signature (sha256=<hex> HMAC-SHA256 over timestamp + '.' + raw request body). Receivers should verify against the exact raw body bytes and enforce a 5-minute timestamp tolerance; retries re-sign with a fresh timestamp and the same event_id. Destination identity is URL-based and rotation is replace-on-update with no overlap: a PATCH changing only webhook.secret keeps the same destination identity and in-flight deliveries are signed with the current secret, while a PATCH changing the URL finalizes rows for the old URL as destination_replaced. When HTTPS is required, every redirect is revalidated and a redirect to a cleartext http target is rejected; the secret is write-only, AES-256-GCM encrypted at rest, and never returned or logged."}, 'RedditResponse': {'type': 'object', 'additionalProperties': True}, 'MonitorEnvelope': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/Monitor'}, 'meta': {'type': 'object', 'required': ['request_id'], 'properties': {'request_id': {'type': 'string'}, 'initialization': {'type': 'string', 'description': 'Present on the asynchronous 202 create response while the private watch is being initialized: "pending". The monitor is not schedulable until initialization completes, so next_run_at is omitted from the data block until then.'}}}}}, 'MonitorPageMeta': {'type': 'object', 'required': ['request_id', 'has_more'], 'properties': {'has_more': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'next_cursor': {'type': 'string'}}}, 'PaymentRequired': {'type': 'object', 'required': ['x402Version', 'error', 'resource', 'accepts', 'extensions'], 'properties': {'error': {'type': 'string'}, 'accepts': {'type': 'array', 'items': {'$ref': '#/$defs/PaymentRequirements'}, 'minItems': 1}, 'resource': {'type': 'object', 'required': ['url', 'mimeType'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'mimeType': {'type': 'string'}}, 'additionalProperties': False}, 'extensions': {'oneOf': [{'$ref': '#/$defs/PaymentRequiredAccountlessExtensions'}, {'$ref': '#/$defs/PaymentRequiredPrepaidExtensions'}]}, 'x402Version': {'enum': [2], 'type': 'integer'}}, 'additionalProperties': False}, 'SuccessResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandLogoResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandLogoData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'BrandFontsResponse': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'$ref': '#/$defs/BrandFontsData'}, 'meta': {'$ref': '#/$defs/ResponseMeta'}}, 'additionalProperties': False}, 'MonitorChangeEvent': {'type': 'object', 'required': ['event_version', 'event_id', 'event_type', 'monitor_id', 'run_id', 'detector', 'url', 'change_type', 'importance', 'summary', 'detected_at'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'Monitored public URL.'}, 'run_id': {'type': 'string', 'format': 'uuid'}, 'summary': {'type': 'string', 'description': 'Bounded, page-content-free human summary.'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'event_id': {'type': 'string', 'format': 'uuid', 'description': 'Stable canonical event identity (X-ReplyNodes-Event-Id); identical for every delivery attempt.'}, 'evidence': {'type': 'object', 'properties': {'bytes': {'type': 'integer', 'format': 'int64'}, 'commit': {'type': 'string'}, 'repository': {'type': 'string'}, 'manifest_path': {'type': 'string'}, 'manifest_sha256': {'type': 'string'}}, 'description': 'Durable evidence/diff reference for this run (repository identifiers and content hashes, never page content).'}, 'event_type': {'enum': ['monitor.change.detected'], 'type': 'string'}, 'importance': {'enum': ['low', 'medium', 'high'], 'type': 'string'}, 'monitor_id': {'type': 'string', 'format': 'uuid'}, 'change_type': {'type': 'string', 'description': 'Bounded detector change kind resolved by the detector/Jev judgement.'}, 'detected_at': {'type': 'string', 'format': 'date-time'}, 'event_version': {'type': 'integer', 'description': 'Canonical envelope version. Receivers must branch on it.'}, 'jev_confidence': {'type': 'number', 'description': 'Raw Jev provider probability for a valid semantic judgement; present only when applicable and not calibrated confidence.'}}, 'description': 'Versioned canonical change event delivered to a configured signed webhook. The payload is exact raw bytes persisted at event creation; Delivery re-signs those bytes on every attempt. organization_id and all secrets are internal and never appear in this document.'}, 'MonitorHistoryPage': {'type': 'object', 'required': ['data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MonitorRun'}}, 'meta': {'$ref': '#/$defs/MonitorPageMeta'}}}, 'CreditTopupRequired': {'type': 'object', 'required': ['code', 'balance_micro', 'price_micro', 'topup_url'], 'properties': {'code': {'enum': ['topup_required'], 'type': 'string'}, 'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}, 'price_micro': {'type': 'integer'}, 'balance_micro': {'type': 'integer'}}, 'additionalProperties': False}, 'PaymentRequirements': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}, 'additionalProperties': False}, 'MonitorCreateRequest': {'type': 'object', 'required': ['url', 'detector', 'frequency'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'webhook': {'$ref': '#/$defs/MonitorWebhook'}, 'detector': {'enum': ['price', 'saas_pricing', 'product_change'], 'type': 'string'}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}}, 'MonitorUpdateRequest': {'type': 'object', 'properties': {'paused': {'type': 'boolean'}, 'webhook': {'anyOf': [{'$ref': '#/$defs/MonitorWebhook'}, {'type': 'null'}]}, 'frequency': {'enum': ['15m', '1h', '6h', '12h', '24h'], 'type': 'string'}}, 'description': 'Update frequency, pause state, or webhook configuration. The database update is authoritative and committed immediately; the changedetection engine watch is reconciled asynchronously by the monitor worker and the returned monitor reports convergence through sync_state/sync_next_retry_at/sync_error_reason instead of claiming engine success. Reconciliation failures retry with a bounded backoff budget and surface as sync_state="failed" (a new PATCH re-arms it). An active monitor\'s schedule reflects the new preset promptly: changing frequency recomputes next_run_at from the change time using the new preset, and resuming a paused monitor schedules the next run one interval after the resume (never an immediate run), so the engine and the canonical schedule cannot drift onto different cadences. Immutable fields (url, detector) are rejected.'}, 'PaymentRequiredResponse': {'oneOf': [{'$ref': '#/$defs/PaymentRequired'}, {'$ref': '#/$defs/CreditTopupRequired'}]}, 'PaymentRequiredPrepaidExtensions': {'type': 'object', 'required': ['topup'], 'properties': {'topup': {'type': 'object', 'required': ['topup_url'], 'properties': {'topup_url': {'enum': ['/v1/billing/topup/intents'], 'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'PaymentRequiredAccountlessExtensions': {'type': 'object', 'required': ['x-replynodes-accountless'], 'properties': {'x-replynodes-accountless': {'type': 'object', 'required': ['payment_mode', 'bearer_supported', 'prepaid_supported'], 'properties': {'payment_mode': {'enum': ['x402_only'], 'type': 'string'}, 'bearer_supported': {'enum': [False], 'type': 'boolean'}, 'prepaid_supported': {'enum': [False], 'type': 'boolean'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'path parameter'}, 'language': {'type': 'string', 'description': 'query parameter'}}, 'additionalProperties': False}

Añadido

                            read_document
                        

1 de October de 2026 a las 02:54

Modificado

                            monitor_runs
                        

29 de September de 2026 a las 03:03

Modificado

                            monitor_changes
                        

29 de September de 2026 a las 03:03

Modificado

                            monitor_update
                        

29 de September de 2026 a las 03:03

Modificado

                            monitor_get
                        

29 de September de 2026 a las 03:03

Modificado

                            monitor_create
                        

29 de September de 2026 a las 03:03

Modificado

                            monitor_list
                        

29 de September de 2026 a las 03:03

Modificado

                            user_posts
                        

29 de September de 2026 a las 03:03

Modificado

                            user_activity
                        

29 de September de 2026 a las 03:03

Modificado

                            post_by_permalink
                        

29 de September de 2026 a las 03:03

Modificado

                            post_by_id
                        

29 de September de 2026 a las 03:03

Modificado

                            subreddit_posts
                        

29 de September de 2026 a las 03:03

Modificado

                            search_posts
                        

29 de September de 2026 a las 03:03

Añadido

                            brand_logo
                        

29 de September de 2026 a las 03:03

Modificado

                            brand_fonts
                        

29 de September de 2026 a las 03:03

Modificado

                            brand_styleguide
                        

29 de September de 2026 a las 03:03

Modificado

                            brand_search
                        

29 de September de 2026 a las 03:03

Modificado

                            brand_retrieve
                        

29 de September de 2026 a las 03:03

Modificado

                            webcontext_brand
                        

29 de September de 2026 a las 03:03

Modificado

                            webcontext_map
                        

29 de September de 2026 a las 03:03

Modificado

                            webcontext_crawl
                        

29 de September de 2026 a las 03:03

Modificado

                            webcontext_scrape
                        

29 de September de 2026 a las 03:03

Modificado

                            web_search
                        

29 de September de 2026 a las 03:03

Modificado

                            googleplay_data_safety
                        

29 de September de 2026 a las 03:03

Modificado

                            googleplay_availability
                        

29 de September de 2026 a las 03:03

Modificado

                            googleplay_suggest
                        

29 de September de 2026 a las 03:03

Modificado

                            googleplay_category_apps
                        

29 de September de 2026 a las 03:03

Modificado

                            googleplay_categories
                        

29 de September de 2026 a las 03:03

Modificado

                            googleplay_developer
                        

29 de September de 2026 a las 03:03

Modificado

                            googleplay_reviews
                        

29 de September de 2026 a las 03:03

Detalles del servidor

Versión

1.0.3

Transporte

Streamable HTTP

Herramientas

Latencia

10944 ms

Último escaneo

1 de October de 2026 a las 02:54

Detectado por primera vez

16 de September de 2026 a las 02:11

Endpoint

https://mcp.replynodes.com/mcp

Escaneos recientes

Correcto

1 de October de 2026 a las 02:54

Correcto

29 de September de 2026 a las 03:03

Correcto

27 de September de 2026 a las 02:53

Correcto

25 de September de 2026 a las 03:03

Correcto

23 de September de 2026 a las 02:54

Correcto

21 de September de 2026 a las 03:01

Correcto

19 de September de 2026 a las 02:52

Correcto

17 de September de 2026 a las 13:00

Correcto

17 de September de 2026 a las 12:37

ReplyNodes

Qué hace este MCP

Herramientas

Cambios recientes en herramientas

Servidores MCP similares

LiveDataLink

Stratalize Healthcare

Stratalize Governance

Stratalize Oracle

Stratalize Real Estate

Stratalize Crypto & DeFi

Valuein — SEC EDGAR Fundamentals & Smart-Money Data

equibles