--- title: API Queries - Domain Report description: API Queries - Domain Report --- [Skip to content](https://support.above.com/-api-queries-domain-report#main-content) ![above-logo-466-1](https://support.above.com/hs-fs/hubfs/above-logo-466-1.png?width=230&height=43&name=above-logo-466-1.png) - [Buy Domains](https://www.above.com/marketplace/index.html) - [Sell Domains](https://www.above.com/sell-my-domains.html) - [Monetize](https://www.above.com/monetization.html) - [Register](https://www.above.com/registrar/index.html) - About Show submenu for About - [About Us](https://www.above.com/about.html) - [Above & Beyond Club](https://www.above.com/above-beyond-club.html) - [Brokerage](https://www.above.com/domain-brokerage.html) - [Contact Us](https://www.above.com/contact.html) - [Our Team](https://www.above.com/our-team.html) - [Log In](https://www.above.com/login.html) Open main navigation Close main navigation - [Buy Domains](https://www.above.com/marketplace/index.html) - [Sell Domains](https://www.above.com/sell-my-domains.html) - [Monetize](https://www.above.com/monetization.html) - [Register](https://www.above.com/registrar/index.html) - About Show submenu for About - [About Us](https://www.above.com/about.html) - [Above & Beyond Club](https://www.above.com/above-beyond-club.html) - [Brokerage](https://www.above.com/domain-brokerage.html) - [Contact Us](https://www.above.com/contact.html) - [Our Team](https://www.above.com/our-team.html) - [Log In](https://www.above.com/login.html) How can we help you? - There are no suggestions because the search field is empty. 1. [Above.com FAQ](https://support.above.com/?hsLang=en) 2. [Portfolio Manager Manual](https://support.above.com/portfolio-manager-manual?hsLang=en) 3. [Monetization API](https://support.above.com/portfolio-manager-manual?hsLang=en#monetization-api) # API Queries - Domain Report The domainreport function retrieves statistics on specified list of domains (up to 1,000 at a time - see note below). Additional parameters are required for this function. #### **Additional Parameters** - domains - The domain or domains to retrieves statistics for, comma separated (up to 1,000 per query - see note below). (Required) - from\_date & to\_date - The report date range. Dates must be in the format YYYY-MM-DD. (Required) - start - The starting offset for results. Default is 0 (Optional) - num - The number of results to show from the report. Default is 100, maximum is 1,000 (Optional) - demographics - This will display the hits from the top 10 countries. Default is "0" (disabled). Accepted values are "0" (disabled) and "1" (enabled). (Optional) - format : Default= xml. Accepted values are 'csv' or 'xml' (Optional) Note: For larger queries (when adding more than 100 domains at a time), you MUST use a POST request to ensure you do not reach any request length limitations. Note: Make sure to URL encode all values. #### **Example query and response:** In this example, we will retrieve a report for domains abc123.com, efg456.com and lmn789.net (domains=abc123.com,efg456.com,lmn789.net) from 2009-03-01 (from\_date=2009-03-01) to 2009-03-02 (to\_date=2009-03-02). Example query: https://www.above.com/api.php?**username**=**user**&**password**=**pass**&**api\_key**=**key**&**mode**=**domainreport**&**domains**=**abc123.com,efg456.com,lmn789.net**&**from\_date**=**2009-03-01**&**to\_date**=**2009-03-31**&**start**=**0**&**num**=**100** Response: ``` Domain,Date,Service,Hits,Uniques,Reported,Clicks,Revenue,CTR,EPC,RPM,nCTR,nRPMabc123.com,2010-01-01,1,16966,9786,0,0,0,0.00,0.00,0.00,0.00,0.00abc123.com,2010-01-01,2,320790,36126,43969,161,123.66,0.37,0.77,2.81,0.45,3.42abc123.com,2010-01-02,1,0,0,7,0,0,0.00,0.00,0.00,0.00,0.00efg456.com,2010-01-01,4,0,0,1,0,0,0.00,0.00,0.00,0.00,0.00efg456.com,2010-01-01,10,0,0,1,0,0,0.00,0.00,0.00,0.00,0.00efg456.com,2010-01-02,1,2,2,2,2,0.06,100.00,0.03,30.00,100.00,30.00efg456.com,2010-01-02,2,0,0,1,0,0,0.00,0.00,0.00,0.00,0.00lmn789.net,2010-01-01,1,531,273,321,61,7.532,19.00,0.12,23.46,22.34,27.59lmn789.net,2010-01-01,2,0,0,1,0,0,0.00,0.00,0.00,0.00,0.00lmn789.net,2010-01-01,5,1274,706,718,133,30.66,18.52,0.23,42.70,18.84,43.43 ```     #### **Error Responses:** Possible error responses for this function are: - [410 - At least one domain must be specified](https://www.above.com/manual/api/pm/api-manual-error-codes.html#410) - [412 - Period, from\_date and to\_date combination or value is invalid](https://www.above.com/manual/api/pm/api-manual-error-codes.html#412) - General errors, such as [200 - Internal Error](https://www.above.com/manual/api/pm/api-manual-error-codes.html#200) or [300 - Username or password invalid](https://www.above.com/manual/api/pm/api-manual-error-codes.html#300). For a complete list of error responses, see the [Error Codes manual page](https://www.above.com/manual/api/pm/api-manual-error-codes.html). - [Above.com Help Guides](https://support.above.com/above-com-help-guides?hsLang=en) - [Monetization FAQs](https://support.above.com/monetization-faqs?hsLang=en#main-content) - [Getting Started](https://support.above.com/monetization-faqs?hsLang=en#getting-started) - [Above Maximizer](https://support.above.com/monetization-faqs?hsLang=en#above-maximizer) - [Account Maintenance](https://support.above.com/monetization-faqs?hsLang=en#account-maintenance) - [Getting Paid](https://support.above.com/monetization-faqs?hsLang=en#getting-paid) - [Stats and Reports](https://support.above.com/monetization-faqs?hsLang=en#stats-and-reports) - [Monetization & Portfolio Manager API](https://support.above.com/monetization-faqs?hsLang=en#monetization-portfolio-manager-api) - [Other Questions](https://support.above.com/monetization-faqs?hsLang=en#other-questions) - [Marketplace FAQs](https://support.above.com/marketplace-faqs?hsLang=en#main-content) - [Selling](https://support.above.com/marketplace-faqs?hsLang=en#selling) - [Buying](https://support.above.com/marketplace-faqs?hsLang=en#buying) - [Other](https://support.above.com/marketplace-faqs?hsLang=en#other) - [Registrar FAQs](https://support.above.com/registrar-faqs?hsLang=en#main-content) - [Registration](https://support.above.com/registrar-faqs?hsLang=en#registration) - [Transfer](https://support.above.com/registrar-faqs?hsLang=en#transfer) - [DNS](https://support.above.com/registrar-faqs?hsLang=en#dns) - [Verification](https://support.above.com/registrar-faqs?hsLang=en#verification) - [Two Step Authentication](https://support.above.com/registrar-faqs?hsLang=en#two-step-authentication) - [API](https://support.above.com/registrar-faqs?hsLang=en#api) - [Other](https://support.above.com/registrar-faqs?hsLang=en#other) - [Portfolio Manager FAQs](https://support.above.com/portfolio-manager-faqs?hsLang=en#main-content) - [Features](https://support.above.com/portfolio-manager-faqs?hsLang=en#features) - [Account Maintenance](https://support.above.com/portfolio-manager-faqs?hsLang=en#account-maintenance) - [Stats and Reports](https://support.above.com/portfolio-manager-faqs?hsLang=en#stats-and-reports) - [Monetization & Portfolio Manager API](https://support.above.com/portfolio-manager-faqs?hsLang=en#monetization-portfolio-manager-api) - [Domain Consolidate](https://support.above.com/portfolio-manager-faqs?hsLang=en#domain-consolidate) - [Other](https://support.above.com/portfolio-manager-faqs?hsLang=en#other) - [Portfolio Manager Manual](https://support.above.com/portfolio-manager-manual?hsLang=en#main-content) - [Introduction](https://support.above.com/portfolio-manager-manual?hsLang=en#introduction) - [Interface](https://support.above.com/portfolio-manager-manual?hsLang=en#interface) - [Portfolio Manager](https://support.above.com/portfolio-manager-manual?hsLang=en#portfolio-manager) - [Sell Domains](https://support.above.com/portfolio-manager-manual?hsLang=en#sell-domains) - [Offers Received](https://support.above.com/portfolio-manager-manual?hsLang=en#offers-received) - [Registrar](https://support.above.com/portfolio-manager-manual?hsLang=en#registrar) - [Monetization API](https://support.above.com/portfolio-manager-manual?hsLang=en#monetization-api) - [Registrar API](https://support.above.com/portfolio-manager-manual?hsLang=en#registrar-api) - [My Account Manual](https://support.above.com/portfolio-manager-manual?hsLang=en#my-account-manual) - [Column Descriptions](https://support.above.com/portfolio-manager-manual?hsLang=en#column-descriptions) - [Domain Details](https://support.above.com/portfolio-manager-manual?hsLang=en#domain-details) - [Supported Domains (TLDs)](https://support.above.com/portfolio-manager-manual?hsLang=en#supported-domains-tlds) - [Support and Help](https://support.above.com/portfolio-manager-manual?hsLang=en#support-and-help) - [Monetization Quick-Start Guide](https://support.above.com/monetization-quick-start-guide?hsLang=en) [![Above.com Logo](https://support.above.com/hs-fs/hubfs/above-logo-466.png?width=466&height=88&name=above-logo-466.png "Above.com Logo")](https://www.above.com) [mailto:email@email.com](mailto:email@email.com) Copyright © 2026, Trillion Pty Ltd Domain Registrar [Register Domains](https://www.above.com/registrar/index.html) [Pricing](https://www.above.com/registrar/domain-pricing.html) [FAQs](https://www.above.com/registrar/faq.html) [Dispute Policy](https://www.above.com/registrar/domain-dispute-policy.html) [Terms of Service](https://www.above.com/terms-of-service.html#Above.com_Registrar_Terms) [WHOIS](https://www.above.com/registrar/whois.html) Marketplace [Sell My Domains](https://www.above.com/sell-my-domains.html) [Buy Domains](https://www.above.com/marketplace/index.html) [Escrow](https://www.above.com/marketplace/escrow.html) [FAQs](https://www.above.com/marketplace/faq.html) [Terms of Service](https://www.above.com/terms-of-service.html#Above.com_Marketplace_Terms) Monetization [Monetization](https://www.above.com/monetization.html) [Reporting](https://www.above.com/reporting.html) [FAQs](https://www.above.com/faq.html) [Terms of Service](https://www.above.com/terms-of-service.html#Above.com_MAP_Terms) Brokerage [Domain Brokerage](https://www.above.com/domain-brokerage.html) [Sell a Domain](https://www.above.com/domain-brokerage.html#sell-domain) [Buy a Domain](https://www.above.com/domain-brokerage.html#buy-domain) [How It Works](https://www.above.com/domain-brokerage.html#how-it-works) [Meet the Brokers](https://www.above.com/domain-brokerage.html#broker-team) Above/Support [Contact Us](https://www.above.com/contact.html) [About Us](https://www.above.com/about.html) [Our Team](https://www.above.com/our-team.html) [Above & Beyond Club](https://www.above.com/above-beyond-club.html) [Careers](https://www.trillion.com/careers.html) [Blog](https://www.above.com/blog/) [Site Map](https://www.above.com/sitemap.html) Socials [LinkedIn](https://www.linkedin.com/company/abovedomain/) [X.com](https://twitter.com/above_domain) [Facebook](https://www.facebook.com/above.domain) [Instagram](https://www.instagram.com/above_com) Accreditations - ![](https://www.above.com/img/icann_logo.png) - ![](https://www.above.com/img/auda-logo-black.png) - ![](https://www.above.com//img/iso_black.png) Copyright © 2008 - Above.com Pty Ltd - All rights reserved. [Privacy Policy](https://www.above.com/privacy-policy.html)