Databuddy Query API
Interactive API explorer - select query types and see real responses
Query Builder
Response
API Documentation
Endpoint details and authentication requirements
Available Query Types
Use these parameter names in your queries to get specific analytics data.
active_statspathcountryregion+10 moreai_agent_pagesagent_idpathai_content_formatsai_crawler_activityagent_idai_crawlersai_failed_requestsagent_idai_landing_pagespathai_product_visitorsai_productsai_recent_requestsagent_idai_visitor_outcomesai_weekly_digestbrowser_nameCustomizablepathcountryregion+10 moreLimit 100browser_versionsCustomizablepathcountryregion+10 moreLimit 100browsersCustomizablepathcountryregion+10 moreLimit 25browsers_groupedCustomizablepathcountryregion+10 moreLimit 100cityCustomizablepathcountryregion+10 moreLimit 100countryCustomizablepathcountryregion+10 moreLimit 100custom_event_propertiesCustomizableprofile_idpathnamespace+6 morecustom_event_segmentsevent_namepathcustom_eventsCustomizableprofile_idpathnamespace+5 morecustom_events_by_pathCustomizableprofile_idpathevent_name+1 morecustom_events_discoveryprofile_idpathevent_name+1 morecustom_events_property_cardinalityprofile_idpathevent_name+2 morecustom_events_property_classificationprofile_idpathevent_name+2 morecustom_events_property_distributionprofile_idpathevent_name+2 morecustom_events_property_top_valuesprofile_idpathevent_name+2 morecustom_events_recentprofile_idpathevent_name+1 morecustom_events_summaryprofile_idpathevent_name+1 morecustom_events_trendsprofile_idpathevent_name+1 morecustom_events_trends_by_eventprofile_idpathevent_name+1 moredevice_typesCustomizablepathcountryregion+10 moreLimit 20engagement_quality_by_pageentry_pagesCustomizablepathcountryregion+12 moreerror_chart_datamessagepatherror_typeerror_customer_impactmessagepatherror_fingerprintsCustomizablemessagepatherror_typeerror_frequencymessagepatherror_typeerror_route_continuation_comparisonmessagepatherror_segmentsmessagepatherror_typeerror_summaryCustomizablemessagepatherror_typeerror_trendsmessagepatherror_typeerror_typesCustomizablemessagepatherror_typeLimit 50errors_by_pageCustomizablepathmessageerror_typeLimit 20errors_by_typeCustomizablepathmessageerror_typeLimit 20events_by_dateCustomizablepathcountryregion+10 moreexit_pagesCustomizablepathcountryregion+12 moreform_abandonment_by_pagefrustration_by_pageidentified_profile_retentionactivation_eventreturn_eventhorizon_days+2 moreinteraction_summaryCustomizablepathcountryregion+10 moreinteresting_sessionspathcountryregion+12 morelanguageCustomizablepathcountryregion+10 moreLimit 100link_clicks_by_dayreferrercountryregion+3 morelink_countries_by_dayreferrercountryregion+3 morelink_referrers_by_dayreferrercountryregion+3 morelink_top_browsersreferrercountryregion+3 moreLimit 10link_top_citiesreferrercountryregion+3 moreLimit 10link_top_countriesreferrercountryregion+3 moreLimit 10link_top_devicesreferrercountryregion+3 morelink_top_referrersreferrercountryregion+3 moreLimit 10link_top_regionsreferrercountryregion+3 moreLimit 10link_total_clicksreferrercountryregion+3 moremcp_calls_seriesclienttoolerror_code+3 moremcp_clientsclienttoolerror_code+3 moremcp_errorsclienttoolerror_code+3 moremcp_summaryclienttoolerror_code+3 moremcp_toolsclienttoolerror_code+3 moreoperating_systemsCustomizablepathcountryregion+10 moreLimit 100os_nameCustomizablepathcountryregion+10 moreLimit 100os_versionsCustomizablepathcountryregion+10 moreLimit 25outbound_domainsCustomizablepathcountryregion+15 moreoutbound_linksCustomizablepathcountryregion+15 morepage_performanceCustomizablepathcountryregion+12 moreLimit 100page_scroll_performanceCustomizablepathcountryregion+10 moreLimit 100page_time_analysisCustomizablepathcountryregion+12 moreprofile_detailanonymous_idprofile_listpathcountryregion+15 moreprofile_revenueanonymous_idprofile_sessionsanonymous_idrealtime_citiespathcountryregion+10 moreLimit 30realtime_countriespathcountryregion+10 moreLimit 50realtime_feedpathcountryregion+10 moreLimit 30realtime_pagespathcountryregion+10 moreLimit 10realtime_referrersrealtime_sessionsrealtime_velocityrecent_errorsCustomizablepathbrowser_nameos_name+5 morerecent_transactionsCustomizablecurrencyprovidertype+11 moreregionCustomizablepathcountryregion+10 moreLimit 100revenue_attribution_overviewcurrencyprovidertype+11 morerevenue_by_ai_productcurrencyprovidertype+11 morerevenue_by_browserCustomizablecurrencyprovidertype+11 morerevenue_by_cityCustomizablecurrencyprovidertype+11 morerevenue_by_countryCustomizablecurrencyprovidertype+11 morerevenue_by_deviceCustomizablecurrencyprovidertype+11 morerevenue_by_entry_pageCustomizablecurrencyprovidertype+11 morerevenue_by_osCustomizablecurrencyprovidertype+11 morerevenue_by_productCustomizablecurrencyprovidertype+13 morerevenue_by_providercurrencyprovidertype+11 morerevenue_by_referrerCustomizablecurrencyprovidertype+11 morerevenue_by_regionCustomizablecurrencyprovidertype+11 morerevenue_by_utm_campaignCustomizablecurrencyprovidertype+11 morerevenue_by_utm_mediumCustomizablecurrencyprovidertype+11 morerevenue_by_utm_sourceCustomizablecurrencyprovidertype+11 morerevenue_overviewcurrencyproviderproduct_id+12 morerevenue_time_seriescurrencyprovidertype+11 morescreen_resolutionCustomizablepathcountryregion+10 moreLimit 100screen_resolutionsCustomizablepathcountryregion+10 moreLimit 100scroll_depth_distributionCustomizablepathcountryregion+10 morescroll_depth_summaryCustomizablepathcountryregion+10 moresearch_engine_activitysearch_engine_crawlerssession_duration_distributionCustomizablepathcountryregion+12 moresession_eventsCustomizablepathcountryregion+11 moreLimit 500session_flowCustomizablepathcountryregion+12 moresession_listpathcountryregion+12 moresession_metricsCustomizablepathcountryregion+12 moresession_pagesCustomizablepathcountryregion+12 moreLimit 100sessions_by_browserCustomizablepathcountryregion+12 moreLimit 100sessions_by_deviceCustomizablepathcountryregion+12 moresessions_time_seriesCustomizablepathcountryregion+12 moresummary_metricsCustomizablepathcountryregion+12 moretimezoneCustomizablepathcountryregion+10 moreLimit 100today_metricsCustomizablepathcountryregion+10 moretop_pagesCustomizablepathcountryregion+12 moreLimit 100top_referrersCustomizablepathcountryregion+10 moreLimit 100traffic_segmentspathtraffic_sourcesCustomizablepathcountryregion+10 moreLimit 100uptime_recent_checksCustomizableuptime_response_time_trendsCustomizableuptime_time_seriesCustomizableutm_campaignsCustomizablepathcountryregion+10 moreLimit 100utm_contentCustomizablepathcountryregion+11 moreLimit 100utm_mediumsCustomizablepathcountryregion+10 moreLimit 100utm_sourcesCustomizablepathcountryregion+10 moreLimit 100utm_termsCustomizablepathcountryregion+11 moreLimit 100viewport_patternsCustomizablepathcountryregion+10 moreLimit 50viewport_vs_resolutionCustomizablepathcountryregion+10 moreLimit 200vitals_by_browserCustomizablepathcountryregion+4 morevitals_by_cityCustomizablepathcountryregion+4 morevitals_by_countryCustomizablepathcountryregion+4 morevitals_by_pageCustomizablepathcountryregion+4 morevitals_by_regionCustomizablepathcountryregion+4 morevitals_overviewvitals_time_seriesweb_vitals_by_browserCustomizableweb_vitals_by_countryCustomizableweb_vitals_by_deviceCustomizableweb_vitals_by_osCustomizableweb_vitals_by_pageCustomizableweb_vitals_by_regionCustomizableweb_vitals_time_seriesCustomizableAuthentication
Include your API key in the X-Api-Key header.
X-Api-Key: YOUR_API_KEYRequired Parameters
Include these query parameters with every request.
website_id
Your website identifier (e.g., web_abc123)
start_date
Start date (YYYY-MM-DD format)
end_date
End date (YYYY-MM-DD format)
Rate Limits
API requests are limited to ensure fair usage across all users.
1,000
requests per hour
10,000
requests per day
200,000
requests per month