API Module Domain suggestNameDomainRequest

From Openprovider API documentation

Revision as of 07:16, 11 May 2021 (view source) WikiSysop (Talk | contribs) (Created page with '==Module Domain > Name Suggestion == {| border="1" cellpadding="4" |- style="background-color:#BBBBBB;" |'''Module''' |domain |- style="background-color:#EEEEEE;" |'''Command nam…') ← Older edit		Current revision as of 06:33, 23 October 2025 (view source) WikiSysop (Talk | contribs) (→Module Domain > Name Suggestion)
(2 intermediate revisions not shown)
Line 13:		Line 13:
	|'''Input'''		|'''Input'''
	|		|
-	*name - the search term for to match to	+	*name - the search term which will be used to generate matches
-	*limit	+	*limit - maximum number of suggestions to return
-	*language	+	*language - The three-letter country code for the language in which responses should be generated (ISO 639-2/B format). Allowed languages: English (eng), Dutch (dut), French (fre), German (ger), Hindi (hin), Indonesian (ind), Italian (ita), Japanese (jpn), Korean (kor), Chinese (Mandarin) (chi), Portuguese (por), Spanish (spa), Turkish (tur), Vietnamese (vie).
-	*sensitive	+	*sensitive - 1/true to remove domain name suggestions deemed obscene by the supplier. 0/false to include obscene domain name suggestions.
	|- style="vertical-align:top;"		|- style="vertical-align:top;"
	|'''Output'''		|'''Output'''

---

Current revision as of 06:33, 23 October 2025

Contents 1 Module Domain > Name Suggestion 2 Examples 2.1 Using PHP class 2.2 Raw XML

Module Domain > Name Suggestion

Module	domain
Command name	suggestNameDomainRequest
Use	Returns a list of domain suggestions based on a search term
Input	name - the search term which will be used to generate matches limit - maximum number of suggestions to return language - The three-letter country code for the language in which responses should be generated (ISO 639-2/B format). Allowed languages: English (eng), Dutch (dut), French (fre), German (ger), Hindi (hin), Indonesian (ind), Italian (ita), Japanese (jpn), Korean (kor), Chinese (Mandarin) (chi), Portuguese (por), Spanish (spa), Turkish (tur), Vietnamese (vie). sensitive - 1/true to remove domain name suggestions deemed obscene by the supplier. 0/false to include obscene domain name suggestions.
Output	returns array of domain suggestions with the following format: name (domain and TLD seperated by '.') domain (domain name, not including the tld) tld (only the tld )

Examples

Using PHP class

$request = new OP_Request;
$request->setCommand('suggestNameDomainRequest')
 ->setAuth(array('username' => 'username', 'password' => 'password'))
 ->setArgs(array(
   'name' => 'wac', //search term 
   'limit'  => 3,
   'language' => 'spa',
   'sensitive' => 1,
 ));

Raw XML

Please note that newlines and leading spaces are added only for readability. Those whitespaces should be excluded from your XML command before sending it to Openprovider.

<?xml version="1.0" encoding="UTF-8"?>
<openXML>
  <credentials>
    <username>username</username>
    <password>password</password>
  </credentials>
  <suggestNameDomainRequest>
    <name>wac</name>
    <limit>3</limit>
    <language>spa</language>
    <sensitive>1</sensitive>
    <tlds>
      <array>
        <item>com</item>
        <item>info</item>
        <item>com.es</item>
      </array>
    </tlds>
  </suggestNameDomainRequest>
</openXML>

<?xml version="1.0" encoding="UTF-8"?>"
<openXML>
  <reply>
  0
<desc></desc>
<data>
  <array>
    <item>
      <name>SheWac.com</name>
      <domain>SheWac</domain>
      <tld>com</tld>
    </item>
    <item>
      <name>HeWac.info</name>
      <domain>HeWac</domain>
      <tld>info</tld>
    </item>
    <item>
      <name>HeWac.com.es</name>
      <domain>HeWac</domain>
      <tld>com.es</tld>
    </item>
  </array>
</data>
</reply>
</openXML>