{
  "openapi": "3.1.0",
  "info": {
    "title": "Namewhere API",
    "version": "1.0.0",
    "summary": "Company name to domain API and company website finder: official domain, confidence 0-1, evidence (Wikidata, DNS, homepage brand match), alternatives, social links. Clearbit NameToDomain alternative. REST + MCP server.",
    "description": "Paid API keys from $19/month (Lookup: 25,000 company lookups a month); free tier 25 company lookups a day per IP with no key. Buy: https://namewhere.cybermax-tools.workers.dev/buy/lookup?s=lead · all plans: https://namewhere.cybermax-tools.workers.dev/docs#pricing\n\nPricing: free tier 25 company lookups/day per IP, no key. Paid API keys: Lookup $19/month = 25,000 company lookups/month; Team $49/month = 80,000 company lookups/month; Scale $99/month = 200,000 company lookups/month; Pay as you go $5 = 5,000 company lookups (one-time pack); Lookup yearly $190/year = 25,000 company lookups/month; Team yearly $490/year = 80,000 company lookups/month; Scale yearly $990/year = 200,000 company lookups/month. Get a key: https://namewhere.cybermax-tools.workers.dev/docs#pricing\n\nSend a company name and get its official website domain with a confidence score, the evidence (Wikidata, homepage brand check), runner-up domains and social links; parked and look-alike domains are rejected. Free tier, no key; paid keys from $5 (one-time pack) or $19/month, card checkout, no Apify account.\n\nFree tier: One company per call; 10 calls a minute per IP on the free tier. Free tier: 25 lookups a day per IP, no key. Paid keys from $5 (one-time pack) or $19/month (see Get an API key). Every lookup is live: Wikidata, DNS and the candidate homepages are checked on each call; nothing is stored. A miss or a low-confidence answer is returned honestly with status not-found or low-confidence. No key needed. Remote MCP server: https://namewhere.cybermax-tools.workers.dev/mcp",
    "contact": {
      "name": "CyberMax",
      "url": "https://cybermax-tools-cybermax.static.hf.space/"
    },
    "license": {
      "name": "Proprietary (free tier + paid API keys)",
      "identifier": "LicenseRef-CyberMax"
    },
    "x-pricing": {
      "api": "Namewhere API",
      "currency": "USD",
      "free": {
        "price": 0,
        "callsPerDayPerIp": 25,
        "perMinutePerIp": 10,
        "key": "none needed"
      },
      "plans": [
        {
          "id": "lookup",
          "name": "Lookup",
          "price": 19,
          "billing": "per month",
          "calls": 25000,
          "per": "calendar month (UTC)",
          "perMinute": 30,
          "buy": "https://namewhere.cybermax-tools.workers.dev/buy/lookup?s=openapi"
        },
        {
          "id": "team",
          "name": "Team",
          "price": 49,
          "billing": "per month",
          "calls": 80000,
          "per": "calendar month (UTC)",
          "perMinute": 60,
          "buy": "https://namewhere.cybermax-tools.workers.dev/buy/team?s=openapi"
        },
        {
          "id": "scale",
          "name": "Scale",
          "price": 99,
          "billing": "per month",
          "calls": 200000,
          "per": "calendar month (UTC)",
          "perMinute": 120,
          "buy": "https://namewhere.cybermax-tools.workers.dev/buy/scale?s=openapi"
        },
        {
          "id": "payg",
          "name": "Pay as you go",
          "price": 5,
          "billing": "one-time",
          "calls": 5000,
          "per": "until used",
          "perMinute": 30,
          "buy": "https://namewhere.cybermax-tools.workers.dev/buy/payg?s=openapi"
        },
        {
          "id": "lookup-yearly",
          "name": "Lookup yearly",
          "price": 190,
          "billing": "per year",
          "calls": 25000,
          "per": "calendar month (UTC)",
          "perMinute": 30,
          "buy": "https://namewhere.cybermax-tools.workers.dev/buy/lookup-yearly?s=openapi"
        },
        {
          "id": "team-yearly",
          "name": "Team yearly",
          "price": 490,
          "billing": "per year",
          "calls": 80000,
          "per": "calendar month (UTC)",
          "perMinute": 60,
          "buy": "https://namewhere.cybermax-tools.workers.dev/buy/team-yearly?s=openapi"
        },
        {
          "id": "scale-yearly",
          "name": "Scale yearly",
          "price": 990,
          "billing": "per year",
          "calls": 200000,
          "per": "calendar month (UTC)",
          "perMinute": 120,
          "buy": "https://namewhere.cybermax-tools.workers.dev/buy/scale-yearly?s=openapi"
        }
      ],
      "unit": "company lookups",
      "howToUse": {
        "header": "x-api-key: YOUR_KEY",
        "alt": [
          "Authorization: Bearer YOUR_KEY",
          "?key=YOUR_KEY"
        ],
        "mcp": "send the key as Authorization: Bearer YOUR_KEY",
        "usage": "https://namewhere.cybermax-tools.workers.dev/key"
      },
      "manageKey": "https://namewhere.cybermax-tools.workers.dev/manage",
      "payments": "Stripe Checkout: card, Apple Pay, Google Pay, Link; sales tax/VAT handled by Stripe. Cancel any time at https://namewhere.cybermax-tools.workers.dev/manage."
    }
  },
  "servers": [
    {
      "url": "https://namewhere.cybermax-tools.workers.dev"
    }
  ],
  "paths": {
    "/api/domain": {
      "get": {
        "tags": [
          "Namewhere"
        ],
        "summary": "Company name to its official website domain, with confidence and evidence",
        "description": "For one company name (optionally with an ISO-2 country): the official domain and website, confidence 0-1 and label, status (resolved, low-confidence, not-found, invalid), the evidence (Wikidata entity, domain-name match, homepage title and brand match), up to 3 alternatives, rejected look-alikes (parked, for sale, dead) and social links. A domain, URL or email as input is verified instead.",
        "operationId": "companyToDomainGet",
        "parameters": [
          {
            "name": "company",
            "in": "query",
            "required": false,
            "description": "Company name, e.g. Acme Brick Company. A domain, URL or email is verified instead.",
            "schema": {
              "type": "string"
            },
            "example": "Monzo Bank"
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Optional ISO-2 country code to prefer that country (e.g. us, gb, de)",
            "schema": {
              "type": "string"
            },
            "example": "gb"
          },
          {
            "name": "minConfidence",
            "in": "query",
            "required": false,
            "description": "Confidence needed for status \"resolved\" (default 0.6)",
            "schema": {
              "type": "number",
              "default": 0.6
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "example": {
                  "results": [
                    {
                      "input": "Acme Brick Company",
                      "name": "Acme Brick Company",
                      "country": null,
                      "status": "resolved",
                      "domain": "brick.com",
                      "website": "https://brick.com/",
                      "confidence": 0.99,
                      "confidenceLabel": "high",
                      "companyName": "Acme Brick",
                      "description": "American brick manufacturer",
                      "sources": [
                        "dns-guess",
                        "redirect-from:acmebrick.co",
                        "redirect-from:acmebrick.com",
                        "wikidata"
                      ],
                      "evidence": {
                        "wikidata": {
                          "id": "Q4674391",
                          "url": "https://www.wikidata.org/wiki/Q4674391",
                          "label": "Acme Brick",
                          "description": "American brick manufacturer",
                          "nameMatch": 1,
                          "countryMatch": null
                        },
                        "domainNameMatch": 0.9,
                        "homepage": {
                          "reachable": true,
                          "botProtected": false,
                          "title": "Acme Brick - Acme Brick",
                          "siteName": "Acme Brick",
                          "brandMatch": 1,
                          "matchedField": "siteName"
                        }
                      },
                      "alternatives": [
                        {
                          "domain": "acmebrick.net",
                          "confidence": 0.6,
                          "sources": [
                            "dns-guess"
                          ],
                          "title": null
                        },
                        {
                          "domain": "acmebrick.org",
                          "confidence": 0.6,
                          "sources": [
                            "dns-guess"
                          ],
                          "title": null
                        }
                      ],
                      "rejected": [],
                      "checkedAt": "2026-09-24T07:09:21.713Z"
                    },
                    {
                      "input": "Monzo Bank",
                      "name": "Monzo Bank",
                      "country": null,
                      "status": "resolved",
                      "domain": "monzo.com",
                      "website": "https://monzo.com/",
                      "confidence": 0.99,
                      "confidenceLabel": "high",
                      "companyName": "Monzo",
                      "description": "online bank based in the United Kingdom",
                      "sources": [
                        "wikidata"
                      ],
                      "evidence": {
                        "wikidata": {
                          "id": "Q25206290",
                          "url": "https://www.wikidata.org/wiki/Q25206290",
                          "label": "Monzo",
                          "description": "online bank based in the United Kingdom",
                          "nameMatch": 1,
                          "countryMatch": null
                        },
                        "domainNameMatch": 1,
                        "homepage": {
                          "reachable": true,
                          "botProtected": false,
                          "title": "Monzo | Open a Free Account",
                          "siteName": "Monzo",
                          "brandMatch": 1,
                          "matchedField": "siteName"
                        }
                      },
                      "socials": {
                        "linkedin": "https://www.linkedin.com/company/monzo-bank",
                        "x": "https://twitter.com/monzo",
                        "facebook": "https://www.facebook.com/monzobank",
                        "instagram": "https://www.instagram.com/monzo"
                      },
                      "alternatives": [
                        {
                          "domain": "monzobank.ai",
                          "confidence": 0.6,
                          "sources": [
                            "dns-guess"
                          ],
                          "title": null
                        }
                      ],
                      "rejected": [],
                      "checkedAt": "2026-09-24T07:09:21.944Z"
                    },
                    {
                      "input": "Octopus Energy",
                      "name": "Octopus Energy",
                      "country": null,
                      "status": "resolved",
                      "domain": "octopusenergy.group",
                      "website": "https://octopusenergy.group/",
                      "confidence": 0.99,
                      "confidenceLabel": "high",
                      "companyName": "Octopus Energy",
                      "description": "British energy company",
                      "sources": [
                        "wikidata"
                      ],
                      "evidence": {
                        "wikidata": {
                          "id": "Q63242134",
                          "url": "https://www.wikidata.org/wiki/Q63242134",
                          "label": "Octopus Energy",
                          "description": "British energy company",
                          "nameMatch": 1,
                          "countryMatch": null
                        },
                        "domainNameMatch": 1,
                        "homepage": {
                          "reachable": true,
                          "botProtected": false,
                          "title": "Octopus Energy Group",
                          "siteName": "Octopus Energy",
                          "brandMatch": 1,
                          "matchedField": "siteName"
                        }
                      },
                      "socials": {
                        "x": "https://twitter.com/g__j"
                      },
                      "alternatives": [
                        {
                          "domain": "octopus.energy",
                          "confidence": 0.97,
                          "sources": [
                            "dns-guess"
                          ],
                          "title": "Octopus Energy: The UK's most awarded energy supplier"
                        },
                        {
                          "domain": "octopusenergy.it",
                          "confidence": 0.86,
                          "sources": [
                            "wikidata"
                          ],
                          "title": "Energia più equa, pulita e accessibile - Octopus Energy"
                        },
                        {
                          "domain": "octopusenergy.fr",
                          "confidence": 0.69,
                          "sources": [
                            "wikidata"
                          ],
                          "title": null
                        }
                      ],
                      "rejected": [
                        {
                          "domain": "octopus-energy.com",
                          "reason": "no working website (timeout)"
                        },
                        {
                          "domain": "octopusenergy.ai",
                          "reason": "parked, for sale or redirects to a third-party page"
                        },
                        {
                          "domain": "octopusenergy.net",
                          "reason": "parked, for sale or redirects to a third-party page"
                        },
                        {
                          "domain": "octopusenergy.org",
                          "reason": "parked, for sale or redirects to a third-party page"
                        }
                      ],
                      "checkedAt": "2026-09-24T07:09:35.418Z"
                    }
                  ],
                  "count": 3
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Invalid or revoked API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Free tier used up (25/day per IP) or rate/plan limit reached; the body has an upgrade link.",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "504": {
            "description": "Took too long; ask for fewer items",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Namewhere"
        ],
        "summary": "Company name to its official website domain, with confidence and evidence",
        "description": "For one company name (optionally with an ISO-2 country): the official domain and website, confidence 0-1 and label, status (resolved, low-confidence, not-found, invalid), the evidence (Wikidata entity, domain-name match, homepage title and brand match), up to 3 alternatives, rejected look-alikes (parked, for sale, dead) and social links. A domain, URL or email as input is verified instead.",
        "operationId": "companyToDomainPost",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "company": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  },
                  "minConfidence": {
                    "type": "number"
                  }
                },
                "required": [
                  "company"
                ]
              },
              "example": {
                "company": "Acme Brick Company",
                "country": "us"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Results (same field names as the bulk version's dataset records) plus the free-tier limits.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                },
                "example": {
                  "results": [
                    {
                      "input": "Acme Brick Company",
                      "name": "Acme Brick Company",
                      "country": null,
                      "status": "resolved",
                      "domain": "brick.com",
                      "website": "https://brick.com/",
                      "confidence": 0.99,
                      "confidenceLabel": "high",
                      "companyName": "Acme Brick",
                      "description": "American brick manufacturer",
                      "sources": [
                        "dns-guess",
                        "redirect-from:acmebrick.co",
                        "redirect-from:acmebrick.com",
                        "wikidata"
                      ],
                      "evidence": {
                        "wikidata": {
                          "id": "Q4674391",
                          "url": "https://www.wikidata.org/wiki/Q4674391",
                          "label": "Acme Brick",
                          "description": "American brick manufacturer",
                          "nameMatch": 1,
                          "countryMatch": null
                        },
                        "domainNameMatch": 0.9,
                        "homepage": {
                          "reachable": true,
                          "botProtected": false,
                          "title": "Acme Brick - Acme Brick",
                          "siteName": "Acme Brick",
                          "brandMatch": 1,
                          "matchedField": "siteName"
                        }
                      },
                      "alternatives": [
                        {
                          "domain": "acmebrick.net",
                          "confidence": 0.6,
                          "sources": [
                            "dns-guess"
                          ],
                          "title": null
                        },
                        {
                          "domain": "acmebrick.org",
                          "confidence": 0.6,
                          "sources": [
                            "dns-guess"
                          ],
                          "title": null
                        }
                      ],
                      "rejected": [],
                      "checkedAt": "2026-09-24T07:09:21.713Z"
                    },
                    {
                      "input": "Monzo Bank",
                      "name": "Monzo Bank",
                      "country": null,
                      "status": "resolved",
                      "domain": "monzo.com",
                      "website": "https://monzo.com/",
                      "confidence": 0.99,
                      "confidenceLabel": "high",
                      "companyName": "Monzo",
                      "description": "online bank based in the United Kingdom",
                      "sources": [
                        "wikidata"
                      ],
                      "evidence": {
                        "wikidata": {
                          "id": "Q25206290",
                          "url": "https://www.wikidata.org/wiki/Q25206290",
                          "label": "Monzo",
                          "description": "online bank based in the United Kingdom",
                          "nameMatch": 1,
                          "countryMatch": null
                        },
                        "domainNameMatch": 1,
                        "homepage": {
                          "reachable": true,
                          "botProtected": false,
                          "title": "Monzo | Open a Free Account",
                          "siteName": "Monzo",
                          "brandMatch": 1,
                          "matchedField": "siteName"
                        }
                      },
                      "socials": {
                        "linkedin": "https://www.linkedin.com/company/monzo-bank",
                        "x": "https://twitter.com/monzo",
                        "facebook": "https://www.facebook.com/monzobank",
                        "instagram": "https://www.instagram.com/monzo"
                      },
                      "alternatives": [
                        {
                          "domain": "monzobank.ai",
                          "confidence": 0.6,
                          "sources": [
                            "dns-guess"
                          ],
                          "title": null
                        }
                      ],
                      "rejected": [],
                      "checkedAt": "2026-09-24T07:09:21.944Z"
                    },
                    {
                      "input": "Octopus Energy",
                      "name": "Octopus Energy",
                      "country": null,
                      "status": "resolved",
                      "domain": "octopusenergy.group",
                      "website": "https://octopusenergy.group/",
                      "confidence": 0.99,
                      "confidenceLabel": "high",
                      "companyName": "Octopus Energy",
                      "description": "British energy company",
                      "sources": [
                        "wikidata"
                      ],
                      "evidence": {
                        "wikidata": {
                          "id": "Q63242134",
                          "url": "https://www.wikidata.org/wiki/Q63242134",
                          "label": "Octopus Energy",
                          "description": "British energy company",
                          "nameMatch": 1,
                          "countryMatch": null
                        },
                        "domainNameMatch": 1,
                        "homepage": {
                          "reachable": true,
                          "botProtected": false,
                          "title": "Octopus Energy Group",
                          "siteName": "Octopus Energy",
                          "brandMatch": 1,
                          "matchedField": "siteName"
                        }
                      },
                      "socials": {
                        "x": "https://twitter.com/g__j"
                      },
                      "alternatives": [
                        {
                          "domain": "octopus.energy",
                          "confidence": 0.97,
                          "sources": [
                            "dns-guess"
                          ],
                          "title": "Octopus Energy: The UK's most awarded energy supplier"
                        },
                        {
                          "domain": "octopusenergy.it",
                          "confidence": 0.86,
                          "sources": [
                            "wikidata"
                          ],
                          "title": "Energia più equa, pulita e accessibile - Octopus Energy"
                        },
                        {
                          "domain": "octopusenergy.fr",
                          "confidence": 0.69,
                          "sources": [
                            "wikidata"
                          ],
                          "title": null
                        }
                      ],
                      "rejected": [
                        {
                          "domain": "octopus-energy.com",
                          "reason": "no working website (timeout)"
                        },
                        {
                          "domain": "octopusenergy.ai",
                          "reason": "parked, for sale or redirects to a third-party page"
                        },
                        {
                          "domain": "octopusenergy.net",
                          "reason": "parked, for sale or redirects to a third-party page"
                        },
                        {
                          "domain": "octopusenergy.org",
                          "reason": "parked, for sale or redirects to a third-party page"
                        }
                      ],
                      "checkedAt": "2026-09-24T07:09:35.418Z"
                    }
                  ],
                  "count": 3
                }
              }
            }
          },
          "400": {
            "description": "Invalid input",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "401": {
            "description": "Invalid or revoked API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Free tier used up (25/day per IP) or rate/plan limit reached; the body has an upgrade link.",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "504": {
            "description": "Took too long; ask for fewer items",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          },
          "message": {
            "type": "string"
          },
          "retryAfterSeconds": {
            "type": "integer"
          },
          "limits": {
            "type": "object"
          }
        },
        "required": [
          "error",
          "message"
        ]
      }
    },
    "securitySchemes": {
      "ApiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key",
        "description": "Optional. Paid plan key from https://namewhere.cybermax-tools.workers.dev/docs#pricing; leave out for the free tier."
      },
      "BearerKey": {
        "type": "http",
        "scheme": "bearer",
        "description": "Same key as a Bearer token."
      }
    }
  },
  "x-mcp-server": "https://namewhere.cybermax-tools.workers.dev/mcp",
  "externalDocs": {
    "description": "Get an API key (pricing)",
    "url": "https://namewhere.cybermax-tools.workers.dev/docs#pricing"
  },
  "security": [
    {},
    {
      "ApiKeyHeader": []
    },
    {
      "BearerKey": []
    }
  ]
}