Domain (gTLD) Data Feed

This data feed is meant only for trademark and malware analysis. Use of this feed data for any marketing purposes is fully prohibited. Please contact us for obtaining access to the data feed (requires a paid monthly subscription).

API URL

Requests to our Domain API are sent to the following URL:

https://domainpunch.com/tlds/feed.php

Note that requests should be sent over https (secure socket) for security.

Authorization

To get started with the API you need to first send the access and secret keys. These are provided to you after purchase. After successful authentication you will receive a token key that can be used for further API calls.

https://domainpunch.com/tlds/feed.php?c=auth&k=xxxxxx&s=yyyyyy

xxxxxxx is your access key and yyyyyy is your secret key

If the authentication is successful, you should see...

OK: zzzzzzzzzz

Otherwise you will get...

Error: Access Denied

zzzzzzzz is the token you would use to make the rest of your API calls. You should make further calls only from the same IP address that was used for authorization.

Obtaining Domain Data

https://domainpunch.com/tlds/feed.php?t=zzzzzzz&d=20171215&f=text

The above will dump the domain names that were added on 2017-12-15 as a simple text list. Use the token obtained after authorization as the t parameter.

Output Formats

Use the f parameter to specify the output format. The options are...

text,xml,raw and json

The default is json

Specifying the date

Use the d parameter to specify the date in yyyymmdd format (20171218, 20180123, etc.)

If the d parameter is absent, the current date will be applied. You can obtain the data for up to 7 previous days.

Data Limits

The API will return only 2000 results at a time. You can use the start and limit parameters and multiple calls to obtain the full data.

https://domainpunch.com/tlds/feed.php?t=zzzzzzz&d=20171215&start=2000&limit=3000

The maximum allowable value for limit parameter is 5000. Use the m=stats parameter to obtain the total count first and the use multiple calls with different start values to obtain the full data.

Obtaining Domain Counts

You can use the m parameter set to stats obtain only the domain counts.

http://local.domainpunch.com/tlds/feed.php?t=zzzzzz&d=20171217&m=stats

TLDs

Use z=xxx to restrict results to a specific TLD. For example...

http://local.domainpunch.com/tlds/feed.php?t=zzzzzz&d=20171217&z=com

http://local.domainpunch.com/tlds/feed.php?t=zzzzzz&d=20171217&z=net

International Domain Names

Use idn=n to restrict results based on IDN. For example...

http://local.domainpunch.com/tlds/feed.php?t=zzzzzz&d=20171217&idn=0

will return only non IDNs

http://local.domainpunch.com/tlds/feed.php?t=zzzzzz&d=20171217&idn=1

will return only IDNs