{ "openapi": "3.1.0", "info": { "title": "OmniVenture B2B Lead Gen & Data Enrichment Suite", "version": "1.0.0", "description": "High-velocity data verification, identity classification, and deliverability scoring for outbound sales pipelines, CRM data hygiene, and signup fraud prevention.\n\n### Included Endpoints:\n1. **B2B Email & MX Deliverability Verifier** (`POST /v1/m2m/verify/email`): RFC syntax validation, zero-cost DNS MX checks, disposable burner domain detection, and corporate classification.\n2. **Edge IP & Network Taxonomy Lookup** (`POST /v1/m2m/lookup/ip`): CIDR routing taxonomy, loopback/private CIDR detection, and reverse DNS PTR lookups.\n3. **High-Speed User-Agent & Bot Classifier** (`POST /v1/m2m/parse/useragent`): Classifies clients into AI crawlers (GPTBot, ClaudeBot, Google), scrapers, or browsers in sub-millisecond time.\n4. **Agnostic Schema Normalizer & Transformer** (`POST /v1/m2m/transform`): Deep nested JSON flattening and null value cleansing.", "contact": { "name": "OmniVenture Autonomous Fleet", "email": "dalnaspidal@gmail.com" }, "x-category": "Data" }, "paths": { "/v1/m2m/transform": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Agnostic Schema Normalizer & JSON Pruner", "description": "Cleanses, flattens, and normalizes unstructured or deeply nested JSON payloads into canonical dictionaries with null values stripped.\n\n### Use when:\n- Pre-processing large, messy API responses or database dumps before injecting into an LLM context window.\n- Stripping extraneous null and empty fields to minimize prompt token consumption.\n- Normalizing nested dictionary hierarchies into flat underscore-delimited key structures.\n\n### Do not use when:\n- The input JSON is malformed or has invalid syntax (call `POST /v1/m2m/repair/json` first).\n- The input is raw unstructured prose or HTML (call `POST /v1/m2m/distill` or `POST /v1/m2m/extract/markdown`).\n\n### Token & Latency Advantage:\n- Eliminates 40% to 70% of whitespace and null-value token overhead.\n- Executed on bare-metal dual Xeon edge compute in sub-5ms latency.\n\n### Pricing:\n- \u00a30.02 GBP / call.", "operationId": "transform_endpoint_v1_m2m_transform_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/verify/email": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "B2B Email & MX Deliverability Verifier", "description": "Validates email RFC 5322 syntax, verifies live DNS MX records, detects disposable/burner domains, flags free consumer providers, and scores corporate deliverability reputation.\n\n### Use when:\n- Autonomous outbound sales agents or lead-generation bots evaluate email lists for delivery risk.\n- Screening user registrations in real time to block burner/temporary inboxes (Mailinator, TempMail).\n- Classifying B2B corporate addresses versus freemail providers (Gmail, Yahoo, Outlook).\n\n### Do not use when:\n- Validating phone numbers, physical addresses, or non-email identifiers.\n\n### Token & Latency Advantage:\n- Sub-15ms direct DNS MX resolution without third-party vendor rate limits or expensive SaaS API subscriptions.\n\n### Pricing:\n- \u00a30.01 GBP / call.", "operationId": "verify_email_endpoint_v1_m2m_verify_email_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/parse/useragent": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "High-Speed User-Agent & Bot Classifier", "description": "Classifies HTTP User-Agent strings into AI agents (GPTBot, ClaudeBot, Perplexity, Gemini), search crawlers (Googlebot, Bingbot), programmatic scrapers (curl, httpx, Scrapy), or human browsers with client OS detection.\n\n### Use when:\n- Rate limiters, WAFs, and edge gateways identify incoming AI crawlers versus human traffic.\n- Autonomous scrapers verify how their client identity appears to destination servers.\n- Categorizing traffic streams without heavyweight external IP/UA databases.\n\n### Do not use when:\n- Evaluating IP addresses or network CIDRs (call `POST /v1/m2m/lookup/ip`).\n\n### Token & Latency Advantage:\n- Sub-2ms edge regex taxonomy with zero third-party API dependencies.\n\n### Pricing:\n- \u00a30.01 GBP / call.", "operationId": "parse_useragent_endpoint_v1_m2m_parse_useragent_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/m2m/lookup/ip": { "post": { "tags": [ "M2M Agnostic Micro-Services" ], "summary": "Edge IP & Network Taxonomy Lookup", "description": "Resolves IP network routing taxonomy, identifies private/loopback/bogon CIDRs, and performs reverse DNS PTR lookups.\n\n### Use when:\n- Autonomous webhook receivers and API sentries audit incoming client IP addresses.\n- Detecting whether an IP is private/internal RFC 1918 or a publicly routable edge host.\n- Performing reverse DNS host resolution for automated telemetry.\n\n### Do not use when:\n- Parsing User-Agent strings (call `POST /v1/m2m/parse/useragent`).\n\n### Token & Latency Advantage:\n- Sub-5ms native socket resolution with zero third-party geolocation API cost.\n\n### Pricing:\n- \u00a30.01 GBP / call.", "operationId": "lookup_ip_endpoint_v1_m2m_lookup_ip_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "x-payment-token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Payment-Token" } }, { "name": "x-rapidapi-key", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Key" } }, { "name": "x-rapidapi-proxy-secret", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-Proxy-Secret" } }, { "name": "x-rapidapi-user", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Rapidapi-User" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/M2MPayloadRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "DirectiveRequest": { "properties": { "message": { "type": "string", "title": "Message" } }, "type": "object", "required": [ "message" ], "title": "DirectiveRequest" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "M2MPayloadRequest": { "properties": { "client_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Client Id", "description": "Machine caller identifier or agent loop instance ID for telemetry.", "default": "m2m_client" }, "payload": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Payload", "description": "Arbitrary JSON payload or dictionary to normalize, transform, or cryptographically hash." }, "raw_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Raw Text", "description": "Raw unstructured text string for entity distillation, keyword extraction, or compression." }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url", "description": "Target web URL (e.g. 'https://example.com/doc') to scrape and compress into clean Markdown." }, "raw_html": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Raw Html", "description": "Raw HTML markup string to convert into clean, token-efficient Markdown." }, "html": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Html", "description": "Alias for raw_html." }, "include_links": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Include Links", "description": "When converting HTML/URL to Markdown, whether to retain hyperlinks in [text](url) format.", "default": false }, "max_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Tokens", "description": "Maximum token budget for Markdown extraction or text output.", "default": 4000 }, "series_a": { "anyOf": [ {}, { "type": "null" } ], "title": "Series A", "description": "Primary numerical value or array of floats for discrepancy/anomaly comparison." }, "series_b": { "anyOf": [ {}, { "type": "null" } ], "title": "Series B", "description": "Secondary baseline numerical value or array of floats for discrepancy comparison." }, "threshold_pct": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Threshold Pct", "description": "Percentage divergence threshold (e.g. 5.0%) above which a delta is flagged as an anomaly.", "default": 5.0 }, "expected_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expected Hash", "description": "Optional expected 64-char hexadecimal SHA-256 digest to verify against payload digest." }, "strip_nulls": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Strip Nulls", "description": "When transforming JSON, whether to recursively prune keys with null/empty values.", "default": true }, "max_keywords": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Keywords", "description": "Maximum number of salient keywords to extract in context distillation.", "default": 5 }, "email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Email", "description": "Target email address to validate for RFC compliance, DNS MX records, and burner domain status." }, "check_mx": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Check Mx", "description": "Whether to perform live DNS MX lookup verification for deliverability scoring.", "default": true }, "raw_json": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Raw Json", "description": "Malformed or unparsed JSON string emitted by an LLM to repair into RFC 8259 valid JSON." }, "broken_json": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Broken Json", "description": "Alias for raw_json: malformed JSON string (with code fences, single quotes, trailing commas)." }, "text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Text", "description": "Input text string for PII redaction and sensitive data masking." }, "host": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Host", "description": "Fully qualified domain name or hostname (e.g. 'api.github.com') to audit SSL/TLS certificates." }, "port": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Port", "description": "TLS port number (defaults to 443).", "default": 443 }, "timeout_seconds": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Timeout Seconds", "description": "Network socket connection timeout in seconds.", "default": 3.0 }, "user_agent": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "User Agent", "description": "Raw User-Agent header string to classify into AI bot, crawler, scraper, or browser." }, "mask_character": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mask Character", "description": "Optional character used to mask PII tokens (defaults to placeholder tags like [REDACTED_EMAIL])." }, "base_currency": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Base Currency", "description": "Base currency symbol for FX oracle rates (e.g. 'GBP', 'USD', 'BTC')." }, "data": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Data", "description": "Data payload or invoice string to encode into SVG QR matrix." }, "ip": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ip", "description": "IPv4 or IPv6 address string to evaluate for routing taxonomy, reverse PTR, and private CIDR." } }, "type": "object", "title": "M2MPayloadRequest" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" } } }, "servers": [ { "url": "https://automatically-welcome-dad-extensive.trycloudflare.com", "description": "Production Edge Execution Gateway (Sub-15ms Bare-Metal Xeon)" }, { "url": "https://omniventure-api.web.app", "description": "Permanent Canonical Gateway Authority & Developer Hub" } ], "externalDocs": { "description": "OmniVenture Developer Hub & Agent Discovery", "url": "https://omniventure-api.web.app" } }