MCP-Server

ReplyNodes

            com.replynodes/mcp
        

Daten & Analytik Suche & Recherche Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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/

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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}

Eingabeschema

{'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}

Eingabeschema

{'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}

Eingabeschema

{'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

Eingabeschema

{'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}

Eingabeschema

{'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}

Eingabeschema

{'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}

Hinzugefügt

                            read_document
                        

1. October 2026 02:54

Geändert

                            monitor_runs
                        

29. September 2026 03:03

Geändert

                            monitor_changes
                        

29. September 2026 03:03

Geändert

                            monitor_update
                        

29. September 2026 03:03

Geändert

                            monitor_get
                        

29. September 2026 03:03

Geändert

                            monitor_create
                        

29. September 2026 03:03

Geändert

                            monitor_list
                        

29. September 2026 03:03

Geändert

                            user_posts
                        

29. September 2026 03:03

Geändert

                            user_activity
                        

29. September 2026 03:03

Geändert

                            post_by_permalink
                        

29. September 2026 03:03

Geändert

                            post_by_id
                        

29. September 2026 03:03

Geändert

                            subreddit_posts
                        

29. September 2026 03:03

Geändert

                            search_posts
                        

29. September 2026 03:03

Hinzugefügt

                            brand_logo
                        

29. September 2026 03:03

Geändert

                            brand_fonts
                        

29. September 2026 03:03

Geändert

                            brand_styleguide
                        

29. September 2026 03:03

Geändert

                            brand_search
                        

29. September 2026 03:03

Geändert

                            brand_retrieve
                        

29. September 2026 03:03

Geändert

                            webcontext_brand
                        

29. September 2026 03:03

Geändert

                            webcontext_map
                        

29. September 2026 03:03

Geändert

                            webcontext_crawl
                        

29. September 2026 03:03

Geändert

                            webcontext_scrape
                        

29. September 2026 03:03

Geändert

                            web_search
                        

29. September 2026 03:03

Geändert

                            googleplay_data_safety
                        

29. September 2026 03:03

Geändert

                            googleplay_availability
                        

29. September 2026 03:03

Geändert

                            googleplay_suggest
                        

29. September 2026 03:03

Geändert

                            googleplay_category_apps
                        

29. September 2026 03:03

Geändert

                            googleplay_categories
                        

29. September 2026 03:03

Geändert

                            googleplay_developer
                        

29. September 2026 03:03

Geändert

                            googleplay_reviews
                        

29. September 2026 03:03

Serverdetails

Version

1.0.3

Transport

Streamable HTTP

Tools

Latenz

10944 ms

Letzter Scan

1. October 2026 02:54

Erstmals gesehen

16. September 2026 02:11

Endpunkt

https://mcp.replynodes.com/mcp

Letzte Scans

Erfolgreich

1. October 2026 02:54

Erfolgreich

29. September 2026 03:03

Erfolgreich

27. September 2026 02:53

Erfolgreich

25. September 2026 03:03

Erfolgreich

23. September 2026 02:54

Erfolgreich

21. September 2026 03:01

Erfolgreich

19. September 2026 02:52

Erfolgreich

17. September 2026 13:00

Erfolgreich

17. September 2026 12:37

ReplyNodes

Was dieses MCP kann

Tools

Letzte Tool-Änderungen

Ähnliche MCP-Server

LiveDataLink

Stratalize Healthcare

Stratalize Governance

Stratalize Oracle

Stratalize Real Estate

Stratalize Crypto & DeFi

Valuein — SEC EDGAR Fundamentals & Smart-Money Data

equibles