{"id":175230,"date":"2025-07-30T15:19:09","date_gmt":"2025-07-30T06:19:09","guid":{"rendered":"https:\/\/support.questetra.com\/?p=175230"},"modified":"2025-08-04T15:58:01","modified_gmt":"2025-08-04T06:58:01","slug":"ip2whois-domain-whois-api-obtain-domain-info-2025","status":"publish","type":"post","link":"https:\/\/support.questetra.com\/en\/addons\/ip2whois-domain-whois-api-obtain-domain-info-2025\/","title":{"rendered":"IP2WHOIS #Domain-WHOIS-API: Obtain Domain-Info"},"content":{"rendered":"\n

IP2WHOIS #Domain-WHOIS-API: Obtain Domain-Info<\/strong><\/h4>\n\n\n\n

translate<\/span> IP2WHOIS #Domain-WHOIS-API: \u30c9\u30e1\u30a4\u30f3\u60c5\u5831\u3092\u53d6\u5f97<\/a><\/p>\n\n\n\n

Obtains domain information (WHOIS records: “Registered Domain Name” and “Domain Age”) from domain names including subdomains. An error is returned if the domain is not registered. The free API license is limited to a maximum of 500 queries per month.<\/p>\n\n\n\n

\"Auto<\/figure>\n\n\n\n
\n
Configs for this Auto Step<\/summary>
\n
\n
AuthzConfU<\/dt>
U: Select HTTP_Authz Setting for API LICENSE KEY (Fixed Value) *<\/span><\/dd>\n
StrConfA<\/dt>
A: Set Domain (eg: “example.com”, “https:\/\/sub.example.jp&#8221<\/a>;) *<\/span>#{EL}<\/sup><\/span><\/dd>\n
SelectConfB1<\/dt>
B1: Select DATA to store Registered Domain Name (update)<\/dd>\n
SelectConfB2<\/dt>
B2: Select DATA to store Domain Name Age in Days (update)<\/dd>\n<\/div>\n
SelectConfX<\/dt>
X: Select DATA to store Response JSON (update)<\/dd>\n<\/div>\n\n<\/dl>\n<\/div><\/details><\/div>\n<\/div>\n\n\n\n
\n
Script (click to open)<\/summary>
\n
\/\/ Script Example of Business Process Automation\n\/\/ for 'engine type: 3' ("GraalJS standard mode")\n\/\/ cf. 'engine type: 2' ("GraalJS Nashorn compatible mode") (renamed from "GraalJS" at 20230526)\n\n\/\/\/\/\/\/\/\/ START "main()" \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\n\nmain();\nfunction main(){ \n\n\/\/\/\/\/\/ == Config Retrieving \/ \u5de5\u7a0b\u30b3\u30f3\u30d5\u30a3\u30b0\u306e\u53c2\u7167 ==\nconst authApiKey                = configs.getObject( "AuthzConfU" );     \/\/\/ REQUIRED\nconst strApiKey                 = authApiKey.getToken();\n\/\/  engine.log( " AutomatedTask Config: ApiKey: " + strApiKey );\n\nconst strDomainName             = configs.get      ( "StrConfA" );       \/\/\/ REQUIRED\n  if( strDomainName === "" ){\n    throw new Error( "\\n AutomatedTask ConfigError:" +\n                     " Config {A: DomainName} is empty \\n" );\n  }\n  let strDomainExtracted        = extractLooseDomain( strDomainName );\n  if (strDomainExtracted === null) {\n    throw new Error( "\\n AutomatedTask ConfigError:" +\n                     " Could not extract domain from Config {A: DomainName} \\n");\n  }\nconst strPocketRegisteredDomain = configs.getObject( "SelectConfB1" );   \/\/ not required\nconst numPocketAgeInDays        = configs.getObject( "SelectConfB2" );   \/\/ not required\nconst strPocketResponseJson     = configs.getObject( "SelectConfX" );    \/\/ not required\n\n\n\n\/\/\/\/\/\/ == Data Retrieving \/ \u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u30c7\u30fc\u30bf\u306e\u53c2\u7167 ==\n\/\/ (Nothing. Retrieved via Expression Language in Config Retrieving)\n\n\n\n\/\/\/\/\/\/ == Calculating \/ \u6f14\u7b97 ==\n\n\/\/\/\/ Domain WHOIS REST API > WHOIS lookup REST API\n\/\/\/\/ https:\/\/www.ip2whois.com\/developers-api\n\/\/\/\/ https:\/\/www.ip2location.io\/ip2whois-documentation\n\n\/\/\/ request1, prepare\nlet request1Uri = "https:\/\/api.ip2whois.com\/v2";\nlet request1 = httpClient.begin(); \/\/ HttpRequestWrapper\n    request1 = request1.queryParam( "key", strApiKey ); \n    request1 = request1.queryParam( "domain", strDomainExtracted ); \n\n\/\/\/ request1, try\nconst response1     = request1.get( request1Uri );     \/\/ HttpResponseWrapper\nengine.log( " AutomatedTask ApiRequest1 Start: " + request1Uri );\nconst response1Code = response1.getStatusCode() + "";  \/\/ JavaNum to string\nconst response1Body = response1.getResponseAsString();\nengine.log( " AutomatedTask ApiResponse1 Status: " + response1Code );\nif( response1Code !== "200"){\n  throw new Error( "\\n AutomatedTask UnexpectedResponseError: " +\n                    response1Code + "\\n" + response1Body + "\\n" );\n}\n\/\/ engine.log( response1Body ); \/\/ debug\n\/* response sample\n{\n  "domain": "google.com",\n  "domain_id": "2138514_DOMAIN_COM-VRSN",\n  "status": "clientUpdateProhibited (https:\/\/www.icann.org\/epp#clientUpdateProhibited)",\n  "create_date": "1997-09-15T07:00:00+0000",\n  "update_date": "2024-08-02T02:17:33+0000",\n  "expire_date": "2028-09-13T07:00:00+0000",\n  "domain_age": 10179,\n  "whois_server": "whois.markmonitor.com",\n  "registrar": { ... },\n  "registrant": { ... },\n  "admin": { ... },\n  "tech": { ... },\n  "billing": { ... },\n  "nameservers: [\n    "ns4.google.com",\n    "ns1.google.com",\n    "ns2.google.com",\n    "ns3.google.com"\n  ]\n}\n*\/\n\n\/\/ response1, parse\nconst response1Obj = JSON.parse( response1Body );\n\n\n\/\/\/\/\/\/ == Data Updating \/ \u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u30c7\u30fc\u30bf\u3078\u306e\u4ee3\u5165 ==\nif( strPocketRegisteredDomain !== null ){\n  engine.setData( strPocketRegisteredDomain, response1Obj.domain  );\n}\nif( numPocketAgeInDays !== null ){\n  engine.setData( numPocketAgeInDays, new java.math.BigDecimal(response1Obj.domain_age)  );\n}\nif( strPocketResponseJson !== null ){\n  engine.setData( strPocketResponseJson, response1Body  );\n}\n\n\n} \/\/\/\/\/\/\/\/ END "main()" \/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\/\n\n\n\/**\n * From the given text, extract the first domain string (a string that looks like a domain, including subdomains).\n *\n * @param {string} text - The string from which you want to extract the domain.\n * @returns {string|null} - Returns the first domain string found, or null if there is no match.\n *\n * @example\n * \/\/ Basic Domain Extraction\n * extractLooseDomain("My website is example.com."); \/\/ 'example.com'\n *\n * @example\n * \/\/ Extracts a domain, including subdomains.\n * extractLooseDomain("My website is example.com."); \/\/ 'sub.domain.co.jp' Returns a domain name.\n *\n * @example\n * \/\/ Extracting domains included as part of a URL\n * extractLooseDomain("The URL is https:\/\/www.google.com\/search?q=test."); \/\/ 'www.google.com' Returns the domain.\n *\n * @example\n * \/\/ Returns a Punycode-formatted domain extract.\n * extractLooseDomain("Punycode domain: xn--abc-xyz.jp."); \/\/ 'xn--abc-xyz.jp' \n *\n * @example\n * \/\/ Returns null if the domain is not found\n * extractLooseDomain("It is a sentence without a domain."); \/\/\n *\/\nfunction extractLooseDomain(text) {\n  const emailMatch = text.match(\/[a-zA-Z0-9._%+-]+@([a-zA-Z0-9.-]+\\.[a-zA-Z]{2,})\/);\n  if (emailMatch) {\n    return emailMatch[1]; \/\/ @\u306e\u53f3\u5074\u306e\u30c9\u30e1\u30a4\u30f3\u90e8\u3092\u8fd4\u3059\n  }\n\n  \/\/ A regular expression that extracts "domain-like strings" including subdomains.\n  \/\/ It supports TLD length, hyphens, numbers, Punycode format, and is case-insensitive.\n  const domainRegex = \/(?:[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?\\.)+(?:[a-zA-Z]{2,20}|xn--[a-zA-Z0-9]{1,61})(?:\\.[a-zA-Z]{2})?\/i;\n  \n  const match = text.match(domainRegex);\n\n  if (match) {\n    return match[0]; \/\/ Returns the entire matched string (domain part)\n  }\n\n  return null; \/\/ If there is no match, returns null\n}\n\n\n\n\n\/*\nNotes:\n- By placing this [Automated Step] in the workflow diagram, the API request will occur every time a process arrives.\n    - A request is made from the Questetra BPM Suite server to the IP2WHOIS server.\n- This [Automated Step] obtains the Domain Information via IP2WHOIS API.\n    - Registered domain name (officially registered and available for use)\n    - Number of days since the domain was created\n    - The full JSON response can be stored as a string.\n- [HTTP Authz Settings] is required for workflow apps that include this [Automated Step].\n    - An API key is required to use IP2WHOIS API. Please obtain an API key in advance.\n        - `https:\/\/www.ip2location.io\/dashboard`\n    - Set 'Secret API Key' as the communication token. [HTTP Authz Settings] > [Token Fixed Value]\n\nAPPENDIX\n- The queries for 1221 TLDs and 634 ccTLDs are supported. (by IP2WHOIS as of 202507)\n- Matches domain names in the format 'example.com' or 'subdomain.example.co.jp'.\n    - output: `example.com`\n    - output: `subdomain.example.co.jp`\n- Extracts the registered domain portion even from strings like 'http:\/\/example.com\/.' or 'suzuki@subdomain.example.co.jp'.\n    - output: `example.com`\n    - output: `subdomain.example.co.jp`\n\nNotes-ja:\n- \u3053\u306e\uff3b\u81ea\u52d5\u5de5\u7a0b\uff3d\u3092\u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u56f3\u306b\u914d\u7f6e\u3059\u308c\u3070\u3001\u6848\u4ef6\u304c\u5230\u9054\u3059\u308b\u305f\u3073\u306bAPI\u30ea\u30af\u30a8\u30b9\u30c8\u304c\u767a\u751f\u3057\u307e\u3059\u3002\n    - Questetra BPM Suite \u30b5\u30fc\u30d0\u304b\u3089 IP2WHOIS \u30b5\u30fc\u30d0\u306b\u5bfe\u3057\u3066\u30ea\u30af\u30a8\u30b9\u30c8\u3057\u307e\u3059\u3002\n- \u3053\u306e\uff3b\u81ea\u52d5\u5de5\u7a0b\uff3d\u306f\u3001IP2WHOIS API \u3092\u901a\u3058\u3066\u3001\u30c9\u30e1\u30a4\u30f3\u60c5\u5831\u3092\u53d6\u5f97\u3057\u307e\u3059\u3002\n    - \u767b\u9332\u6e08\u307f\u30c9\u30e1\u30a4\u30f3\u540d\uff08\u6b63\u5f0f\u306b\u767b\u9332\u3055\u308c\u5229\u7528\u53ef\u80fd\u306a\u72b6\u614b\u306b\u306a\u3063\u3066\u3044\u308b\u30c9\u30e1\u30a4\u30f3\uff09\n    - \u30c9\u30e1\u30a4\u30f3\u304c\u751f\u6210\u3055\u308c\u3066\u304b\u3089\u306e\u65e5\u6570\n    - JSON response \u306e\u5168\u6587\u3082\u683c\u7d0d\u53ef\u80fd\u3067\u3059\u3002\n- \u3053\u306e\uff3b\u81ea\u52d5\u5de5\u7a0b\uff3d\u3092\u542b\u3080\u30ef\u30fc\u30af\u30d5\u30ed\u30fc\u30a2\u30d7\u30ea\u306b\u306f\u3001\uff3bHTTP \u8a8d\u8a3c\u8a2d\u5b9a\uff3d\u304c\u5fc5\u8981\u3067\u3059\u3002\n    - IP2WHOIS API \u306e\u5229\u7528\u306b\u306f API key \u304c\u5fc5\u8981\u3067\u3059\u3002\u3042\u3089\u304b\u3058\u3081 API Key \u3092\u53d6\u5f97\u3057\u3066\u304a\u3044\u3066\u304f\u3060\u3055\u3044\u3002\n        - `https:\/\/www.ip2location.io\/dashboard`\n    - 'Secret API Key' \u3092\u901a\u4fe1\u30c8\u30fc\u30af\u30f3\u3068\u3057\u3066\u30bb\u30c3\u30c8\u3057\u307e\u3059\u3002\uff3bHTTP \u8a8d\u8a3c\u8a2d\u5b9a\uff3d\uff1e\uff3b\u30c8\u30fc\u30af\u30f3\u76f4\u63a5\u6307\u5b9a\uff3d\n\nAPPENDIX-ja\n- 1221\u306eTLD\u3068634\u306eccTLD\u306e\u30af\u30a8\u30ea\u3092\u30b5\u30dd\u30fc\u30c8\u3057\u3066\u3044\u307e\u3059\u3002 (by IP2WHOIS as of 202507)\n- 'example.com' \u3084 'subdomain.example.co.jp' \u306e\u3088\u3046\u306a\u5f62\u5f0f\u306e\u30c9\u30e1\u30a4\u30f3\u540d\u306b\u30de\u30c3\u30c1\u3057\u307e\u3059\u3002\n    - output: `example.com`\n    - output: `subdomain.example.co.jp`\n- 'http:\/\/example.com\/.' \u3084 'suzuki@subdomain.example.co.jp' \u306e\u3088\u3046\u306a\u6587\u5b57\u5217\u3067\u3082\u767b\u9332\u30c9\u30e1\u30a4\u30f3\u90e8\u3092\u62bd\u51fa\u3057\u307e\u3059\u3002\n    - output: `example.com`\n    - output: `subdomain.example.co.jp`\n*\/\n\n<\/code><\/pre><\/div>\n<\/div><\/details><\/div>\n<\/div>\n\n\n\n
Download<\/span><\/h3>\n\n\n\n