API reference
Sorry, no examples yet. Coming soon! (In the meantime, just try the endpoints you need out. Breaking changes won't be introduced lightly - the old POST version of Clickclickclick is still there and works, even though it's probably never going to be used anymore!)
Searching for records (exact match)
Endpoint: /Clickclickclick
Method: GET
Parameters (query string):
- q
- Domains to search for (space-separated)
- ids (optional)
- Set to any value to search by primary key rather than by domain name. Used in Save DNS Now
- json
- Set this parameter to return JSON.
Read record data (minus date) by primary key
Endpoint: /Read/<id>
Method: GET
Parameters (URL):
- id
- The primary key of the document.
JSON: You can access full record data (including the date!) as JSON by tacking on .json to the URL. Note however that this data is returned in the search results (/Clickclickclick) if JSON is requested. As such, if you are using the search results and following the links, just request JSON in your search results for one less request.
Read record data (minus date) by site and timestamp
Endpoint: /Read/<site>/<timestamp>
Method: GET
Parameters (URL):
- site
- The domain name
- timestamp
- The timestamp (UNIX epoch) of the record
JSON: You can access full record data (including the date!) as JSON by tacking on .json to the URL. Note however that this data is returned in the search results (/Clickclickclick) if JSON is requested. As such, if you are using the search results and following the links, just request JSON in your search results for one less request.
Save DNS Now
Endpoint: /Save
Method: POST
Parameters (request body):
- site
- The DNS domains to save, space-separated
JSON: There is no JSON counterpart here; if you want to get the data, you will need to use HTML parsing.