API Documentation
We offer JSON-format API for all our customers with unlimited access
In order to get access to the API, first please get your token from the settings page; you will need it for all your API calls.
Any questions? Please don't hesitate to contact us!
In order to get access to the API, first please get your token from the settings page; you will need it for all your API calls.
API Methods
| Method | Description | Parameters bold = required, italic = optional | Example URL |
|---|---|---|---|
| domain_info | Get domain name, alexa rank and technologies currently used | domain | http://api.datanyze.com/domain_info/?email=your_email&token=your_token&domain=www.test.com |
| domain_history | Get history of changes for specific domain | domain same as above | http://api.datanyze.com/domain_history/?email=your_email&token=your_token&domain=www.test.com |
| add_domain | Add domain to Datanyze to start tracking it. | domain same as above | http://api.datanyze.com/add_domain/?email=your_email&token=your_token&domain=www.test.com |
| technologies | Get list of technologies | - | http://api.datanyze.com/technologies/?email=your_email&token=your_token |
| technology_types | Get technology types such as CDN, DNS, Web Analytics, etc | - | http://api.datanyze.com/technology_types/?email=your_email&token=your_token |
| customers | Get list of customers for specific technology |
technology_id - id of technology from 'technologies' call limit - limit of how many domains to show. It's 100 by default and it can't be larger than 100 page - 1 by default. Since only 100 domains can be provided at one time, use this parameter to access more domains |
10 top domains that use Google Analytics http://api.datanyze.com/customers/?email=your_email&token=your_token&technology_id=67&page=1&limit=10 101-200 ranked domains that use Google Analytics http://api.datanyze.com/customers/?email=your_email&token=your_token&technology_id=67&page=2 |
| categories | Get list of categories | - | http://api.datanyze.com/categories/?email=your_email&token=your_token |
| category_domains | Get list of domains in specific category | category_id - id of category from 'categories' call | http://api.datanyze.com/categories/?email=your_email&token=your_token&category_id=243 |
| alerts | Get alerts for specific date | date - date in YYYY-MM-DD format. Today by default. Can go back up to 30 days maximum. | http://api.datanyze.com/alerts/?email=your_email&token=your_token&date=2013-05-25 |
| targeting | Get alerts for specific date |
action - use 1 for 'added', 2 for 'dropped' and 3 for 'currently use' technology_id - id of technology from 'technologies' call date_range - use 1 for 'day', 2 for 'week' and 3 for 'month'. Used only in 'added' or 'dropped' calls. |
Domains that added Google Analytics within last month: http://api.datanyze.com/targeting/?email=your_email&token=your_token&action=1&technology_id=67&date_range=3 Domains that dropped Google Analytics within last week: http://api.datanyze.com/targeting/?email=your_email&token=your_token&action=2&technology_id=67&date_range=2 Domains that currently use Google Analytics (use 'customers' method to get more than 100 domains): http://api.datanyze.com/targeting/?email=your_email&token=your_token&action=3&technology_id=67 |
Errors
| Error code | Description |
|---|---|
| 101 | Access denied. You have not provided correct username and token. |
| 102 | Access denied. Your username and token are OK, but your account does not have access to our API. |
| 103 | Requested domain was not found. Make sure that you specified 'domain' field. If you still think it's correct, that means we don't have any information about this domain in our system. |
| 104 | No history found for this domain. Make sure that you specified 'domain' field. If you still think it's correct, that means we don't have any information about this domain in our system. |
| 105 | No domains were found. This happens when we could not find domains for specific technology with parameters that you specified. One common reason for that is you specified a page number that is too high. |
| 106 | No alerts found for this date. Make sure you specified correct date in YYYY-MM-DD format. Alerts that are older than 30 days are not accessible. |
| 107 | No domains found in this category. Make sure you specified correct category. If you still see this error, we don't have any domains in this category. |
| 108 | Domain is already in the system. This happens when you try to add a domain that we already track. |
| 404 | You requested a call that does not exist. |