{"openapi":"3.1.0","x-pricing":{"currency":"USDC","network":"eip155:8453","mode":"live","model":"variable-cost-v2","formula":"max(minimum_usdc, multiplier × estimated_variable_cost_usd), rounded up to 0.000001 USDC","multiplier":3,"minimum_usdc":0.03,"cost_basis":"worst_case_single_attempt","calibration":{"measured_at":"2026-09-28","method":"Live pipeline with the production page fetcher against 6 real business websites (EN, DE, JA, RU, FR); zero paid search needed.","measured_max":{"cpu_seconds":0.38,"wall_seconds":7.7,"result_bytes":14283,"searches":0}},"tiers":[{"tier":"quick","amount":"0.061761","currency":"USDC","model_id":"8bf64b49eb4e31e7","formula":"max(minimum_usdc, multiplier × estimated_variable_cost_usd), rounded up to 0.000001 USDC","multiplier":3,"minimum_usdc":0.03,"estimated_variable_cost_usd":0.020586856533,"cost_basis":"worst_case_single_attempt","cost_components_usd":{"search":0.016,"page_provider":0,"model":0,"browser":0,"email_verification":0,"compute_cpu":0.000062222222,"compute_memory":0.000329777778,"invocations":0.0000024,"edge_requests":0.000008,"transfer":0.0000688128,"storage":0.000115643733,"database":0.003,"settlement":0.001,"other":0},"searches":2,"pages":3,"priced_attempts":1,"included_attempts":3,"assumptions":{"memory_gb":2,"cpu_seconds_base":1,"cpu_seconds_page":0.25,"overhead_seconds":10,"page_timeout_seconds":12,"search_seconds":5,"result_bytes":65536,"replay_bytes":8192,"storage_amplification":2,"retrieval_allowance":2,"retention_days":30,"wall_seconds_per_attempt":56},"rates":{"search_credit_usd":0.008,"settlement_usd":0.001,"cpu_hour_usd":0.128,"memory_gb_hour_usd":0.0106,"invocation_usd":6e-7,"edge_request_usd":0.000002,"transfer_gb_usd":0.21,"storage_gb_month_usd":0.35,"database_attempt_usd":0.003,"other_attempt_usd":0}},{"tier":"standard","amount":"0.086565","currency":"USDC","model_id":"8bf64b49eb4e31e7","formula":"max(minimum_usdc, multiplier × estimated_variable_cost_usd), rounded up to 0.000001 USDC","multiplier":3,"minimum_usdc":0.03,"estimated_variable_cost_usd":0.028854967644,"cost_basis":"worst_case_single_attempt","cost_components_usd":{"search":0.024,"page_provider":0,"model":0,"browser":0,"email_verification":0,"compute_cpu":0.000088888889,"compute_memory":0.000571222222,"invocations":0.0000024,"edge_requests":0.000008,"transfer":0.0000688128,"storage":0.000115643733,"database":0.003,"settlement":0.001,"other":0},"searches":3,"pages":6,"priced_attempts":1,"included_attempts":3,"assumptions":{"memory_gb":2,"cpu_seconds_base":1,"cpu_seconds_page":0.25,"overhead_seconds":10,"page_timeout_seconds":12,"search_seconds":5,"result_bytes":65536,"replay_bytes":8192,"storage_amplification":2,"retrieval_allowance":2,"retention_days":30,"wall_seconds_per_attempt":97},"rates":{"search_credit_usd":0.008,"settlement_usd":0.001,"cpu_hour_usd":0.128,"memory_gb_hour_usd":0.0106,"invocation_usd":6e-7,"edge_request_usd":0.000002,"transfer_gb_usd":0.21,"storage_gb_month_usd":0.35,"database_attempt_usd":0.003,"other_attempt_usd":0}},{"tier":"deep","amount":"0.111608","currency":"USDC","model_id":"8bf64b49eb4e31e7","formula":"max(minimum_usdc, multiplier × estimated_variable_cost_usd), rounded up to 0.000001 USDC","multiplier":3,"minimum_usdc":0.03,"estimated_variable_cost_usd":0.03720263431,"cost_basis":"worst_case_single_attempt","cost_components_usd":{"search":0.032,"page_provider":0,"model":0,"browser":0,"email_verification":0,"compute_cpu":0.000124444444,"compute_memory":0.000883333333,"invocations":0.0000024,"edge_requests":0.000008,"transfer":0.0000688128,"storage":0.000115643733,"database":0.003,"settlement":0.001,"other":0},"searches":4,"pages":10,"priced_attempts":1,"included_attempts":3,"assumptions":{"memory_gb":2,"cpu_seconds_base":1,"cpu_seconds_page":0.25,"overhead_seconds":10,"page_timeout_seconds":12,"search_seconds":5,"result_bytes":65536,"replay_bytes":8192,"storage_amplification":2,"retrieval_allowance":2,"retention_days":30,"wall_seconds_per_attempt":150},"rates":{"search_credit_usd":0.008,"settlement_usd":0.001,"cpu_hour_usd":0.128,"memory_gb_hour_usd":0.0106,"invocation_usd":6e-7,"edge_request_usd":0.000002,"transfer_gb_usd":0.21,"storage_gb_month_usd":0.35,"database_attempt_usd":0.003,"other_attempt_usd":0}}],"policy":"Prepaid fixed tier: max(minimum, 3 × variable cost of one research attempt that uses the full tier budget). Cost covers search credits, compute, database, transfer, storage and CDP settlement; there are no model, browser or translation calls. Actual per-request cost is recorded separately and is usually lower (known-domain lookups often need no paid search). No retrospective surcharge or automatic refund. Zero-contact and ambiguous results are paid outcomes. Provider failures allow two free retries with the identical key/body. Unknown settlements require reconciliation."},"info":{"title":"Contact Finder","version":"1.0.0","description":"Public business contact discovery. Publication is not deliverability. Public professional context only. Unicode and original evidence preserved. Prices: GET /api/v1/pricing. x402 v2 exact USDC on Base; see /docs and /llms.txt."},"servers":[{"url":"https://contactfinder.online"}],"paths":{"/api/v1/find":{"post":{"summary":"Find public business contacts","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":16,"maxLength":128},"description":"Random secret token. Also used to retrieve results. Reuse the same key/body on retries."},{"name":"PAYMENT-SIGNATURE","in":"header","schema":{"type":"string"},"description":"Base64 x402 v2 payment payload from an x402 client."},{"name":"Authorization","in":"header","schema":{"type":"string"},"description":"Bearer <same Idempotency-Key>. Send on retries/replays without a new payment. Unsigned requests without it receive a 402 challenge and no stored lookup."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindInput"},"example":{"target":{"domain":"example.com"},"contact_goal":"sales","max_results":5}}}},"responses":{"200":{"description":"Completed or ambiguous entity; same schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindResult"}}}},"202":{"description":"In progress; check Location again with the bearer token"},"400":{"description":"invalid_request, invalid_json, invalid_url, idempotency_key_required"},"402":{"description":"x402 payment required; PAYMENT-REQUIRED response header contains the base64 challenge","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"}}}},"409":{"description":"payment_reused or idempotency_conflict"},"413":{"description":"request_too_large"},"415":{"description":"unsupported_media_type"},"429":{"description":"rate_limited; Retry-After"},"503":{"description":"not_configured, provider_unavailable or settlement_unknown; preserve key and request ID"}}}},"/api/v1/requests/{id}":{"get":{"summary":"Retrieve a retained result","security":[{"ResultToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindResult"}}}},"202":{"description":"In progress"},"401":{"description":"Missing bearer token"},"404":{"description":"Unknown, expired or unauthorized result"},"503":{"description":"Failed or uncertain payment"}}}},"/api/v1/health":{"get":{"parameters":[{"name":"ready","in":"query","schema":{"type":"string","enum":["1"]},"description":"Omit for a configuration-only check that never touches the database. ready=1 adds a rate-limited database check cached for 5 minutes."}],"responses":{"200":{"description":"Configured (and database ready when ready=1)"},"503":{"description":"Not configured or database unavailable"}}}},"/api/v1/pricing":{"get":{"responses":{"200":{"description":"Current prices and bounded budgets","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/v1/contact-types":{"get":{"responses":{"200":{"description":"Supported contact types and goals"}}}},"/api/v1/quote":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindInput"}}}},"responses":{"200":{"description":"Price and payment challenge, no charge"},"400":{"description":"Invalid input"},"503":{"description":"Not ready"}}}}},"components":{"securitySchemes":{"ResultToken":{"type":"http","scheme":"bearer","description":"Original secret Idempotency-Key"}},"schemas":{"FindInput":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"target":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":500},"domain":{"type":"string","minLength":1,"maxLength":500},"website":{"type":"string","minLength":1,"maxLength":500},"organization":{"type":"string","minLength":1,"maxLength":500},"professional_name":{"type":"string","minLength":1,"maxLength":500},"known_url":{"type":"string","minLength":1,"maxLength":500},"location":{"type":"string","minLength":1,"maxLength":500},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"region":{"type":"string","minLength":1,"maxLength":500},"city":{"type":"string","minLength":1,"maxLength":500},"service_area":{"type":"string","minLength":1,"maxLength":500},"industry":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false},"contact_goal":{"default":"general","type":"string","enum":["general","sales","support","billing","partnerships","press","careers","legal","procurement","management","other"]},"goal_description":{"type":"string","minLength":1,"maxLength":500},"preferred_methods":{"default":[],"maxItems":8,"type":"array","items":{"type":"string","enum":["email","phone","contact_form","support_page","sales_page","booking","contact_page","social"]}},"max_results":{"default":5,"type":"integer","minimum":1,"maximum":10},"tier":{"default":"standard","type":"string","enum":["quick","standard","deep"]},"request_language":{"type":"string","minLength":1,"maxLength":500},"source_languages":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"preferred_output_language":{"type":"string","minLength":1,"maxLength":500},"aliases":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"local_terms":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}}},"required":["target","contact_goal","preferred_methods","max_results","tier","source_languages","aliases","local_terms"],"additionalProperties":false},"FindResult":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"request_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"},"status":{"type":"string","enum":["completed","ambiguous_entity"]},"target":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":500},"domain":{"type":"string","minLength":1,"maxLength":500},"website":{"type":"string","minLength":1,"maxLength":500},"organization":{"type":"string","minLength":1,"maxLength":500},"professional_name":{"type":"string","minLength":1,"maxLength":500},"known_url":{"type":"string","minLength":1,"maxLength":500},"location":{"type":"string","minLength":1,"maxLength":500},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"region":{"type":"string","minLength":1,"maxLength":500},"city":{"type":"string","minLength":1,"maxLength":500},"service_area":{"type":"string","minLength":1,"maxLength":500},"industry":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false},"query":{"type":"object","properties":{"target":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":500},"domain":{"type":"string","minLength":1,"maxLength":500},"website":{"type":"string","minLength":1,"maxLength":500},"organization":{"type":"string","minLength":1,"maxLength":500},"professional_name":{"type":"string","minLength":1,"maxLength":500},"known_url":{"type":"string","minLength":1,"maxLength":500},"location":{"type":"string","minLength":1,"maxLength":500},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"region":{"type":"string","minLength":1,"maxLength":500},"city":{"type":"string","minLength":1,"maxLength":500},"service_area":{"type":"string","minLength":1,"maxLength":500},"industry":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false},"contact_goal":{"default":"general","type":"string","enum":["general","sales","support","billing","partnerships","press","careers","legal","procurement","management","other"]},"goal_description":{"type":"string","minLength":1,"maxLength":500},"preferred_methods":{"default":[],"maxItems":8,"type":"array","items":{"type":"string","enum":["email","phone","contact_form","support_page","sales_page","booking","contact_page","social"]}},"max_results":{"default":5,"type":"integer","minimum":1,"maximum":10},"tier":{"default":"standard","type":"string","enum":["quick","standard","deep"]},"request_language":{"type":"string","minLength":1,"maxLength":500},"source_languages":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"preferred_output_language":{"type":"string","minLength":1,"maxLength":500},"aliases":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}},"local_terms":{"default":[],"maxItems":5,"type":"array","items":{"type":"string","minLength":1,"maxLength":500}}},"required":["target","contact_goal","preferred_methods","max_results","tier","source_languages","aliases","local_terms"],"additionalProperties":false},"entity_candidates":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string","format":"uri"}},"required":["name","url"],"additionalProperties":false}},"contacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"type":{"type":"string","enum":["email","phone","contact_form","support_page","sales_page","booking","contact_page","social"]},"value":{"type":"string"},"display_value":{"type":"string"},"purpose":{"type":"string","enum":["general","sales","support","billing","partnerships","press","careers","legal","procurement","management","other"]},"original_department":{"anyOf":[{"type":"string"},{"type":"null"}]},"confidence":{"type":"number","minimum":0,"maximum":1},"verification_status":{"type":"string","enum":["published_on_official_site","published_on_external_source","inferred","unverified"]},"verification_class":{"type":"string","enum":["verified","likely","inferred","unknown"]},"source_url":{"type":"string","format":"uri"},"organization":{"anyOf":[{"type":"string"},{"type":"null"}]},"checked_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"email_checks":{"type":"object","properties":{"syntax_valid":{"type":"boolean"},"mail_domain_valid":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"deliverability_checked":{"type":"boolean"}},"required":["syntax_valid","mail_domain_valid","deliverability_checked"],"additionalProperties":false},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}]},"extension":{"type":"string"},"evidence":{"minItems":1,"type":"array","items":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"source_type":{"type":"string","enum":["official","external","fixture"]},"original_text":{"type":"string"},"source_language":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_script":{"anyOf":[{"type":"string"},{"type":"null"}]},"freshness":{"type":"string","enum":["currently_observed","unknown"]},"method":{"type":"string","const":"page_observation"}},"required":["url","title","retrieved_at","source_type","original_text","source_language","freshness","method"],"additionalProperties":false}},"conflicts":{"type":"array","items":{"type":"string"}}},"required":["id","type","value","display_value","purpose","original_department","confidence","verification_status","verification_class","source_url","organization","checked_at","evidence","conflicts"],"additionalProperties":false}},"best_contact":{"anyOf":[{"type":"string"},{"type":"null"}]},"limitations":{"type":"array","items":{"type":"string"}},"checked_at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"},"mode":{"type":"string","enum":["demo","live"]},"price":{"type":"object","properties":{"amount":{"type":"string"},"currency":{"type":"string","const":"USDC"},"tier":{"type":"string"}},"required":["amount","currency","tier"],"additionalProperties":false},"output_language":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["request_id","status","target","query","entity_candidates","contacts","best_contact","limitations","checked_at","mode","price","output_language"],"additionalProperties":false}}}}