{ "openapi": "3.1.0", "info": { "title": "Hosaka", "version": "1.0.0", "description": "Company data for AI agents, paid per call in USDC. Reads a company's own DNS to find every third-party vendor it can be proven to use, and returns the record proving each one.", "x-guidance": "Every endpoint takes a JSON body with one field: {\"domain\": \"figma.com\"}. A URL works too; the scheme and path are stripped. Start with POST /lookup ($0.005) for a summary, POST /dossier ($0.02) for every vendor with the DNS record or loaded script that proves it, POST /contacts ($0.02) for the addresses a company publishes about itself, POST /people ($0.35) for named employees, and POST /executives ($0.4) for only those who can sign. Payment is x402 v2: call without a payment header, read the terms from the 402, sign, retry. Settles in USDC on Base, Solana, Polygon, Arbitrum, Algorand and Monad, and in USDG on Robinhood Chain, so a buyer pays on whichever chain it already holds a dollar. Nothing settles unless the answer is produced.", "contact": { "email": "dreamquayco@gmail.com" }, "license": { "name": "MIT", "identifier": "MIT" } }, "servers": [ { "url": "https://hosaka-agents.vercel.app" } ], "paths": { "/lookup": { "post": { "operationId": "lookup", "summary": "Use when you have a company domain and need to know what the company is before spending more. Returns the company name and site title, domain age, registrar, mail provider, DNS provider, DMARC and HTTPS status, and a count of the third-party vendors detected. One call, no signup, no API key. The cheapest way to qualify a domain before buying a fuller record.", "tags": [ "company-data", "enrichment", "domain", "software-detection" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.005000" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain, e.g. figma.com" } }, "required": [ "domain" ] } } } }, "responses": { "200": { "description": "The answer.", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "ageYears": { "type": "number" }, "registeredOn": { "type": "string" }, "registrar": { "type": "string" }, "mailProvider": { "type": "string" }, "dnsProvider": { "type": "string" }, "dmarc": { "type": "boolean" }, "https": { "type": "boolean" }, "title": { "type": "string" }, "vendorCount": { "type": "number" } } }, "example": { "domain": "figma.com", "ageYears": 27, "registeredOn": "1999-05-04T00:00:00Z", "registrar": "Amazon Registrar, Inc.", "mailProvider": "Google Workspace", "dnsProvider": "AWS Route 53", "dmarc": true, "https": true, "title": "Figma: The collaborative canvas for design, code, and AI", "vendorCount": 17 } } } }, "400": { "description": "The body was not a usable domain." }, "402": { "description": "Payment required. The PAYMENT-REQUIRED header carries the price and terms on every supported chain." } } } }, "/dossier": { "post": { "operationId": "dossier", "summary": "Use when you need a company's technology and vendor stack from its domain alone. Returns every third-party service it runs on — the software and tools behind its mail, DNS, CDN, analytics, payments, support and hosting — each with the DNS record or loaded script that proves it, plus registration, certificate and site facts. Technographics and SaaS detection without a subscription.", "tags": [ "technographics", "vendor-stack", "software-detection", "tools" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain, e.g. figma.com" } }, "required": [ "domain" ] } } } }, "responses": { "200": { "description": "The answer.", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "vendors": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "category": { "type": "string" }, "evidence": { "type": "string" }, "confidence": { "type": "string" } } } }, "registration": { "type": "object", "properties": { "value": { "type": "object", "properties": { "ageYears": { "type": "number" }, "registrar": { "type": "string" } } }, "from": { "type": "string" } } }, "gaps": { "type": "array", "items": { "type": "object" } } } }, "example": { "domain": "figma.com", "vendors": [ { "name": "Stripe", "category": "payments", "evidence": "DNS TXT: stripe-verification=82ce…", "confidence": "high" }, { "name": "Greenhouse", "category": "hr", "evidence": "SPF: include:greenhouse.io", "confidence": "high" } ], "registration": { "value": { "ageYears": 27, "registrar": "Amazon Registrar, Inc." }, "from": "observed" }, "gaps": [] } } } }, "400": { "description": "The body was not a usable domain." }, "402": { "description": "Payment required. The PAYMENT-REQUIRED header carries the price and terms on every supported chain." } } } }, "/people": { "post": { "operationId": "people", "summary": "Finds the people who work at a company from its domain alone: named employees with job title, seniority, location and profile link. Use it when the domain is all you have, because most people-data endpoints want an email or a LinkedIn URL before they will answer. Also returns the company's proven third-party vendor stack in the same call, so one purchase answers who works there and what they run.", "tags": [ "people-data", "lead-enrichment", "prospecting", "enrichment" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.350000" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain, e.g. figma.com" } }, "required": [ "domain" ] } } } }, "responses": { "200": { "description": "The answer.", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "company": { "type": "object", "properties": { "vendors": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "category": { "type": "string" }, "evidence": { "type": "string" } } } } } }, "contacts": { "type": "object", "properties": { "data": { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object" } } } }, "source": { "type": "string" }, "kind": { "type": "string" }, "costUsd": { "type": "number" } } } } }, "example": { "domain": "figma.com", "company": { "vendors": [ { "name": "Greenhouse", "category": "hr", "evidence": "SPF: include:mg-spf.greenhouse.io" } ] }, "contacts": { "data": { "results": [] }, "source": "FullEnrich People Search", "kind": "named-people", "costUsd": 0.15 } } } } }, "400": { "description": "The body was not a usable domain." }, "402": { "description": "Payment required. The PAYMENT-REQUIRED header carries the price and terms on every supported chain." } } } }, "/executives": { "post": { "operationId": "executives", "summary": "Finds the decision makers at a company from its domain alone: owners, founders, C-level, partners, VPs, heads and directors, each with title, location and profile link. Use it when the domain is all you have, because endpoints that enrich a known person want an email or a profile URL first. Also returns the company's proven vendor stack, so one call answers who decides and what they already run.", "tags": [ "decision-makers", "people-data", "prospecting", "enrichment" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.400000" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain, e.g. figma.com" } }, "required": [ "domain" ] } } } }, "responses": { "200": { "description": "The answer.", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "company": { "type": "object", "properties": { "vendors": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "category": { "type": "string" }, "evidence": { "type": "string" } } } } } }, "contacts": { "type": "object", "properties": { "summary": { "type": "object", "properties": { "count": { "type": "number" }, "people": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "headline": { "type": "string" }, "location": { "type": "string" }, "profile": { "type": "string" } } } } } }, "kind": { "type": "string" }, "costUsd": { "type": "number" } } } } }, "example": { "domain": "figma.com", "company": { "vendors": [ { "name": "Greenhouse", "category": "hr", "evidence": "SPF: include:mg-spf.greenhouse.io" } ] }, "contacts": { "summary": { "count": 1, "people": [ { "name": "Jane Doe", "headline": "VP Engineering", "location": "London, United Kingdom", "profile": "https://www.linkedin.com/in/…" } ] }, "kind": "decision-makers", "costUsd": 0.15 } } } } }, "400": { "description": "The body was not a usable domain." }, "402": { "description": "Payment required. The PAYMENT-REQUIRED header carries the price and terms on every supported chain." } } } }, "/contacts": { "post": { "operationId": "contacts", "summary": "Use when you need to reach a company rather than a named person: the emails, phone numbers and social accounts it publishes about itself, gathered from its own site. Also returns every third-party vendor the company can be proven to use, with the record proving each. For support, sales and abuse contact discovery from a domain.", "tags": [ "contacts", "email-lookup", "company-data", "enrichment" ], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [ { "x402": {} } ] }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string", "description": "Company domain, e.g. figma.com" } }, "required": [ "domain" ] } } } }, "responses": { "200": { "description": "The answer.", "content": { "application/json": { "schema": { "type": "object", "properties": { "domain": { "type": "string" }, "company": { "type": "object", "properties": { "vendors": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "category": { "type": "string" }, "evidence": { "type": "string" } } } } } }, "contacts": { "type": "object", "properties": { "data": { "type": "object", "properties": { "emails": { "type": "array", "items": { "type": "string" } }, "phones": { "type": "array", "items": { "type": "object" } } } }, "source": { "type": "string" }, "kind": { "type": "string" }, "costUsd": { "type": "number" } } } } }, "example": { "domain": "figma.com", "company": { "vendors": [ { "name": "Greenhouse", "category": "hr", "evidence": "SPF: include:mg-spf.greenhouse.io" } ] }, "contacts": { "data": { "emails": [ "support@figma.com" ], "phones": [] }, "source": "OpenWebNinja website contacts scraper", "kind": "published-contact-points", "costUsd": 0.003 } } } } }, "400": { "description": "The body was not a usable domain." }, "402": { "description": "Payment required. The PAYMENT-REQUIRED header carries the price and terms on every supported chain." } } } } } }