Getting Started
Welcome to CodePunch. This page explains what you received after your purchase and how to start getting data.
What you received
After your purchase you should have received an email containing two things:
API Key
A long string of characters that identifies your account. Looks something like a1b2c3d4e5f6g7h8. This is not a secret — it identifies who you are.
API Secret
A second string that proves you are the owner of the key. Treat this like a password — do not share it. Together the key and secret allow you to access the data.
Did not receive your credentials? Check your spam folder first. If you still cannot find them, contact us with the email address you used for the purchase and your PayPal or FastSpring transaction ID.
What is an API?
An API is a way for computer programs to talk to each other. When you subscribed to a CodePunch data feed, you purchased access to a data service that your own programs or tools can query.
Think of it like a tap. The data is flowing constantly on our end — millions of domain registrations every day. Your API key and secret are the combination that opens the tap and lets you pull out the data you need.
You do not visit a website to download a file. Instead you send a request to our API and it sends back structured data that your program can work with. This is what the email credentials are for.
If this sounds technical, do not worry. We have options below that require no coding at all.
Three ways to get data
Depending on your technical background, there are three ways to start using your subscription:
Note: The simple Python tools, including ToolPad, the daily ZIP downloader, and the command line tool, are provided only for the Domain Activity feed. They are not intended for other API endpoints, data feeds, or CodePunch products.
Easiest
ToolPad
A point-and-click browser tool. No installation, no code. Just paste your key and secret and start searching.
Some setup
Python Script
A simple script to download the full daily ZIP, or a more powerful tool for filtered queries. Requires Python installed on your computer.
Developers
Build your own
Use the REST API directly from any language or tool. Full documentation with code examples available.
Option 1: ToolPad (no code required)
The ToolPad is a browser-based tool hosted on DnPedia. It is the fastest way to start searching the domain feed without writing any code.
Step 1 — Open the ToolPad
Go to dnpedia.com/toolpad in your browser.
Step 2 — Enter your credentials
Paste your API Key into the API Key field and your API Secret into the API Secret field. Click Authenticate. If successful, the search panel appears.
Step 3 — Search for domains
Type a keyword into the search box and press Enter or click Find Domains. For example:
%apple% in:added tlds:com,net days:7
This returns all domains added in the last 7 days in .com and .net that contain the word "apple".
Step 4 — Export the results
Click Copy to copy the domain list to your clipboard, or Download CSV to save it as a file.
See the ToolPad documentation for the full query syntax including date filters, pagination, and more.
Option 2: Python Scripts
If you are comfortable with a terminal or command line, we have two ready-made Python scripts. Both require Python 3 with the requests package — install it with pip install requests.
Option 2a — Download the daily ZIP (simplest)
If you just want to grab the full list of added or deleted domains each day as a file, this is the easiest option. Download the script, paste your credentials in, and run it.
# Download added domains (default) python dnfeed-daily-zip.py # Download deleted domains python dnfeed-daily-zip.py deleted # Output: Saved added_20260424.zip (4,231 KB)
Option 2b — Query with filters
If you want to search by keyword, date, or TLD rather than downloading everything, use the full CLI tool instead.
Download dnfeed-app.py, open it in a text editor, paste your credentials, and run:
python dnfeed-app.py -d 7 -kw "%apple%" -tlds com,net
To see all available options: python dnfeed-app.py -h
See the Python CLI Tool documentation for all options including more ZIP download flags.
Option 3: Build your own integration
If you want to integrate the domain feed into your own application or pipeline, the API works with any language that can make HTTP requests. Authentication is a two-step process:
Step 1 — Exchange your key and secret for a session token:
GET https://api.codepunch.com/dnfeed/v2/auth/YOUR_API_KEY/YOUR_API_SECRET/ # Response { "status": true, "token": "a1b2c3d4..." }
Step 2 — Use the token in the URL path of every subsequent request:
GET https://api.codepunch.com/dnfeed/v2/a1b2c3d4/added?kw=%25apple%25&tlds=com,net
See the full API documentation for all endpoints, parameters, and response schemas. Working Python and PHP examples are in the code samples.
Need help?
If you are stuck at any point, please contact us. Include the following in your message and we will get back to you within 4 to 12 hours:
The product you subscribed to (Domain Activity, DNS and Subdomains, SSL/TLS Certificates, or Network Bundle)
The email address you used for the purchase
What you have tried so far and what error or result you are seeing