{"article":{"id":360045245692,"url":"https://singular.zendesk.com/api/v2/help_center/en-us/articles/360045245692.json","html_url":"https://support.singular.net/hc/en-us/articles/360045245692-Reporting-API-Reference","author_id":375435680992,"comments_disabled":true,"draft":false,"promoted":false,"position":2,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":360013729751,"created_at":"2020-06-30T19:43:10Z","updated_at":"2026-11-11T15:09:30Z","name":"Reporting API Reference","title":"Reporting API Reference","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-11T15:09:30Z","user_segment_id":null,"permission_group_id":1693812,"content_tag_ids":[],"label_names":["datasheet","[English] Reporting API Reference"],"body":"<div class=\"callout callout--warning\">\n<p><strong>We recommend reading </strong><a href=\"https://support.singular.net/hc/en-us/articles/207553433\" target=\"_self\"><strong>Getting Started with the Singular Reporting API</strong></a><strong> first </strong>to get familiar with the concepts behind the API and find the right queries for your use case.</p>\n<p>See also: <a href=\"https://support.singular.net/hc/en-us/articles/360056377792\" target=\"_self\"><span class=\"wysiwyg-underline\">SKAdNetwork</span> API Reference</a>, <a href=\"https://support.singular.net/hc/en-us/articles/360045674511\" target=\"_self\"><span class=\"wysiwyg-underline\">Ad Monetization</span> API Reference</a>.</p>\n<p>This API is available to Singular customers (advertisers). <strong>If you are a Singular partner, see the</strong><a href=\"https://support.singular.net/hc/en-us/articles/8657996894619\" target=\"_self\"><strong> Reporting API for Partners</strong></a><strong> instead.</strong><br> </p>\n</div><p> </p><h1 id=\"h_01HA20VSYMXJTGQMFB75TVQ9HJ\">General Information</h1><h2 id=\"h_01HA20VSYMJXWB5NBP25YS1HS2\">Authentication</h2><p>All API requests require an API key. To retrieve the key, log into your account and go to <strong>Developer Tools &gt; API Keys. </strong>You can insert the key in the <strong>api_key</strong> parameter in your request, or provide the token under an Authorization HTTP header.</p><h2 id=\"h_01HA20VSYMJWY1108SGA7EGG58\">Rate Limits</h2><p>The default limits for the Singular API are:</p><ul class=\"list-bullet\">\n<li data-list-item-id=\"e459f9a31afcd29272cf630aebf2ea0cc\">\n<strong>Async Reports</strong>: up to 100 async reports running concurrently.</li>\n<li data-list-item-id=\"e13f4878c72161c66a33c00c9f61f4db4\">\n<strong>Synchronous Reports</strong>: up to 3 synchronous reports running concurrently.</li>\n<li data-list-item-id=\"ef957c447ab22db09072d8ac8bdcc20ee\">\n<strong>Single Report Row Limit</strong>: up to 200K rows per query.</li>\n<li data-list-item-id=\"eee1051a56b99cf5de7a0415f434761e7\">\n<strong>Daily Global Row Limit</strong>: up to 3M rows on a single day (shared among all your queries).</li>\n</ul><p>Singular reserves the right to adjust the rate limit for given endpoints in order to continue and provide a high quality of service to all of our customers. Contact us if there's a specific need to exceed the default limitation.</p><h1 id=\"h_01HA20VSYM4AYP0K4RVPAQYSSB\">List of Reporting API Endpoints</h1><p>The following API endpoints are available:</p><table class=\"table\" style=\"margin-left: 0px; margin-right: auto;\">\n<tbody>\n<tr>\n<td><strong><a href=\"#h_d474bc2d-4dc1-427c-a06a-c4f436b5c060\" target=\"_self\">Create Async Report</a></strong></td>\n<td><em>POST</em></td>\n<td><em>https://api.singular.net/api/v2.0/create_async_report</em></td>\n<td>Returns aggregated statistics.</td>\n</tr>\n<tr>\n<td><strong><a href=\"#h_c0d273fa-4b94-401a-9567-83bf303f6e7f\" target=\"_self\">Data Availability</a></strong></td>\n<td><em>GET</em></td>\n<td><em>https://api.singular.net/api/v2.0/data_availability_status</em></td>\n<td>Before querying Create Async Report, use this endpoint to determine whether for a given day, data is available for each of your sources (data connectors).</td>\n</tr>\n<tr>\n<td><strong><a href=\"#h_9866a50e-46c9-42bc-8658-4ea9893e5070\" target=\"_self\">Get Report Status</a></strong></td>\n<td><em>GET</em></td>\n<td><em>https://api.singular.net/api/v2.0/get_report_status</em></td>\n<td>Returns the status of a given report.</td>\n</tr>\n<tr>\n<td><strong><a href=\"#h_7050513d-5f83-45f5-94fa-4b4a4c4314d0\" target=\"_self\">Filters</a></strong></td>\n<td><em>GET</em></td>\n<td><em>https://api.singular.net/api/v2.0/reporting/filters</em></td>\n<td>Returns all filtering options available for your reports.</td>\n</tr>\n<tr>\n<td><strong><a href=\"#h_120d40ba-cc7d-4afc-9d5a-bdde24a0362b\" target=\"_self\">Custom Dimensions</a></strong></td>\n<td><em>GET</em></td>\n<td><em>https://api.singular.net/api/custom_dimensions</em></td>\n<td>Returns all the custom dimensions available for your reports.</td>\n</tr>\n<tr>\n</tr>\n<tr>\n<td><strong><a href=\"#h_creative_ai_dimensions_endpoint\" target=\"_self\">Creative AI Dimensions</a></strong></td>\n<td><em>GET</em></td>\n<td><em>https://api.singular.net/api/creative_ai_dimensions</em></td>\n<td>Returns all the Creative IQ AI tags available for your reports.</td>\n</tr>\n<tr>\n<td><strong><a href=\"#h_a89bb16a-6214-448f-b3ab-4443b20cc571\" target=\"_self\"><span class=\"wysiwyg-underline\">Cohort</span> Metrics</a></strong></td>\n<td><em>GET</em></td>\n<td><em>https://api.singular.net/api/cohort_metrics</em></td>\n<td>Returns all the cohort metrics and cohort periods available for your reports.</td>\n</tr>\n<tr>\n<td><strong><a href=\"#h_a89bb16a-6214-448f-b3ab-4443b20cc571\" target=\"_self\">Conversion Metrics</a></strong></td>\n<td><em>GET</em></td>\n<td><em>https://api.singular.net/api/conversion_metrics</em></td>\n<td>Returns all the conversion metrics available for your reports.</td>\n</tr>\n</tbody>\n</table><h1 id=\"h_d474bc2d-4dc1-427c-a06a-c4f436b5c060\">Create Async Report Endpoint</h1><div class=\"shared_content\" id=\"create_async_report_endpoint\">\n<figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table><tbody><tr>\n<td><em><strong>POST</strong></em></td>\n<td><em><strong>https://api.singular.net/api/v2.0/create_async_report</strong></em></td>\n</tr></tbody></table></figure><h3 id=\"h_01HA20VSYM7PFA6PSESBGH3VP8\">Usage</h3>\n<p>This is the main endpoint for getting reporting data from Singular. The endpoint generates an asynchronous report query based on the reporting dimensions, metrics, dates, and other details that you specify, and returns the <strong>Report ID</strong>. The next step is to query the <a href=\"#h_9866a50e-46c9-42bc-8658-4ea9893e5070\" target=\"_self\">Get Report Status endpoint</a> to see when the report is done and to get a download URL.</p>\n<p class=\"wysiwyg-text-align-center\"><img src=\"https://support.singular.net/hc/article_attachments/360067259511\" alt=\"Screen_Shot_2020-07-01_at_0.17.35.png\" width=\"398\" height=\"99\"></p>\n<p class=\"wysiwyg-text-align-left\">To learn more, see the <a href=\"https://support.singular.net/hc/en-us/articles/207553433#The_Querying_Process\" target=\"_self\"><strong>Querying Process</strong></a> section in the <a href=\"https://support.singular.net/hc/en-us/articles/207553433\" target=\"_self\">Guide to the Singular Reporting API</a>.</p>\n<h3 id=\"h_01HA20VSYM464M85N7ET2FE59K\">Limitations</h3>\n<ul class=\"list-bullet\">\n<li data-list-item-id=\"e2b052d157eeda13c07775c4572e31d7c\">An API request for a single day does not have a limit on the count of rows returned.</li>\n<li data-list-item-id=\"e6965c478ce17897dce2e11d633074b68\">A single request can query up to 30 days and has a maximum of 100,000 queried records. Requests querying more than 100,000 records will not succeed and will require additional filtering.</li>\n<li data-list-item-id=\"ea1f4d703e444bf1f83b32afe617edfdb\">When integrating with our API for daily or weekly data pulls we generally recommend splitting multi-day queries to single-day, and iterating over the entire time period.</li>\n</ul>\n<h3 id=\"h_01HA20VSYM866C3PH2FDFGNHKC\">Sample Query</h3>\n<pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">import requests\n  url = \"https://api.singular.net/api/v2.0/create_async_report\"\n  query_params = {\"api_key\": \"&lt;API KEY&gt;\"}\n  payload = {\n    \"dimensions\":\"app,source,os,country_field\",\n    \"metrics\": \"custom_impressions,custom_clicks,custom_installs\",\n    \"start_date\":\"2020-01-01\",\n    \"end_date\": \"2020-01-01\",\n    \"time_breakdown\": \"all\",\n    \"format\": \"csv\",\n    \"country_code_format\": \"iso\"\n  }\n  response = requests.post(url=url, params=query_params, data=payload)\n  print(response.text)</code></pre>\n<h3 id=\"h_01HA20VSYM1GMB2ZRRJCXXAWRR\">Query Parameters</h3>\n<figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n<td><strong>Example</strong></td>\n</tr></thead>\n<tbody>\n<tr><td style=\"text-align: center;\" colspan=\"4\"><strong>Basic Parameters</strong></td></tr>\n<tr>\n<td><strong>api_key</strong></td>\n<td>String</td>\n<td>API key provided in the Singular console</td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>start_date</strong></td>\n<td>Date</td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>end_date</strong></td>\n<td>Date</td>\n<td> </td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>time_breakdown</strong></td>\n<td>String</td>\n<td>Results breakdown by 'day', 'week', 'month' or 'all', which aggregated data over the entire time period</td>\n<td> </td>\n</tr>\n<tr><td style=\"text-align: center;\" colspan=\"4\"><strong>Field Selection Parameters</strong></td></tr>\n<tr>\n<td><strong>dimensions</strong></td>\n<td>String</td>\n<td>A comma-separated list of dimensions. See <a href=\"https://support.singular.net/hc/en-us/articles/207553433#API_Report_Types\" target=\"_self\">API Report Types</a> for the list of dimensions available based on the type of data you are looking for. See <a href=\"https://support.singular.net/hc/en-us/articles/203389179\">Metrics and Dimensions</a> for more information about each dimension.</td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>metrics</strong></td>\n<td>String</td>\n<td>A comma-separated list of metrics. See <a href=\"https://support.singular.net/hc/en-us/articles/207553433#API_Report_Types\" target=\"_self\">API Report Types</a> for the list of metrics available based on the type of data you are looking for. See <a href=\"https://support.singular.net/hc/en-us/articles/203389179\">Metrics and Dimensions</a> for more information about each metric.</td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>cohort_metrics</strong></td>\n<td>String</td>\n<td>A comma-separated list of cohort metrics by name (see <a href=\"https://support.singular.net/hc/en-us/articles/205046069-Reports-FAQ#what_are_cohort_metrics_periods\">What are cohort metrics?</a>). Cohort metrics include any post-conversion events you have <a href=\"https://support.singular.net/hc/en-us/articles/208385833-Custom-Events-FAQ\">defined in the <strong>Events</strong> page</a>. To retrieve a list of all the available cohort metrics in your account, use the <a href=\"#h_a89bb16a-6214-448f-b3ab-4443b20cc571\" target=\"_self\">Cohort Metrics</a> endpoint.</td>\n<td>'cohort_metrics': '815782610a1ddf,revenue'</td>\n</tr>\n<tr>\n<td><strong>cohort_periods</strong></td>\n<td>String</td>\n<td>A comma-separated list of cohort periods (see <a href=\"https://support.singular.net/hc/en-us/articles/205046069-Reports-FAQ#what_are_cohort_metrics_periods\">What are cohort metrics?</a>). To retrieve a list of the available cohort periods, use the <a href=\"#h_a89bb16a-6214-448f-b3ab-4443b20cc571\" target=\"_self\">Cohort Metrics</a> endpoint.</td>\n<td>'cohort_periods': '7d,14d,ltv'</td>\n</tr>\n<tr>\n<td><strong>creatives_ai_dimensions</strong></td>\n<td>String</td>\n<td>A comma-separated list of Creative IQ AI tag IDs. Each tag is added to the report as a column with the tag value for each creative. To retrieve the AI tag IDs available in your account, use the <a href=\"#h_creative_ai_dimensions_endpoint\" target=\"_self\">Creative AI Dimensions</a> endpoint. Requires Creative IQ (CIQ) to be enabled for your account.</td>\n<td><code>'creatives_ai_dimensions': '3f6c1a2e-8b4d-4e5f-9a7b-1c2d3e4f5a6b,9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d'</code></td>\n</tr>\n<tr><td style=\"text-align: center;\" colspan=\"4\"><strong>Filtering Parameters</strong></td></tr>\n<tr>\n<td><strong>app</strong></td>\n<td>String</td>\n<td>A comma-separated list of app names to filter the query results by. To retrieve a list of app names, use the <a href=\"#h_7050513d-5f83-45f5-94fa-4b4a4c4314d0\" target=\"_self\">Filters endpoint</a>.</td>\n<td>'app': 'my_app1,my_app2'</td>\n</tr>\n<tr>\n<td><strong><span class=\"wysiwyg-underline\">Source</span></strong></td>\n<td>String</td>\n<td>A comma-separated list of ad networks (and other  sources) to filter by. To retrieve a list of ad network names, use the <a href=\"#h_7050513d-5f83-45f5-94fa-4b4a4c4314d0\" target=\"_self\">Filters endpoint</a>.</td>\n<td>'source': 'facebook,adwords'</td>\n</tr>\n<tr>\n<td><strong>filters</strong></td>\n<td>JSON</td>\n<td>A JSON list of filter objects where each contains a dimension, operator, and value(s). Use this parameter to apply more advanced filtering. Note that if you specify more than one filter they will be applied with an AND relation. To retrieve a full list of dimensions you can filter by and their potential values, use the <a href=\"#h_7050513d-5f83-45f5-94fa-4b4a4c4314d0\" target=\"_self\">Filters endpoint</a>.</td>\n<td>'filters': '[{\"dimension\": \"os\", \"operator\": \"in\",\"values\": [1, 4]}, {\"dimension\": \"source\", \"operator\": \"not in\", \"values\": [\"adwords\"]}]'</td>\n</tr>\n<tr><td style=\"text-align: center;\" colspan=\"4\"><strong>Formatting Parameters</strong></td></tr>\n<tr>\n<td><strong>format</strong></td>\n<td>String</td>\n<td>The format in which the query results will be delivered. Options: \"json\" (default) or \"csv\".</td>\n<td>\"format\":\"csv\"</td>\n</tr>\n<tr>\n<td><strong>country_code_format</strong></td>\n<td>String</td>\n<td>Either \"iso3\" (default) or \"iso\"</td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>display_alignment</strong></td>\n<td>Boolean</td>\n<td>\n<p>When set to \"true\", results will include an alignment row to account for any difference between campaign and creative statistics.</p>\n<p>See <a href=\"https://support.singular.net/hc/en-us/articles/360028754072-Reporting-API-FAQ-and-Troubleshooting#creative_metrics_contain_negative_values\">Why do the creative metrics contain negative values?</a></p>\n</td>\n<td> </td>\n</tr>\n<tr>\n<td>\n<strong>display_unenriched</strong><br> </td>\n<td>Boolean</td>\n<td>\n<p>When set to \"true\", results will contain the unenriched data.</p>\n<p>See <a href=\"https://support.singular.net/hc/en-us/articles/4406043928859\" target=\"_blank\" rel=\"noopener noreferrer\">Why are there missing (N/A) values in the report?</a></p>\n</td>\n<td>\"display_unenriched\":true</td>\n</tr>\n<tr>\n<td>\n<strong>allow_multiple_breakdowns</strong><br> </td>\n<td>Boolean</td>\n<td>When set to \"true\", results will contain <a href=\"https://support.singular.net/hc/en-us/articles/22525086653979-Multiple-Breakdowns-FAQ\">multiple breakdowns</a>. The \"breakdown_type\" dimension is required when set to \"true\".</td>\n<td>\"allow_multiple_breakdowns\":true</td>\n</tr>\n</tbody>\n</table></figure><h3 id=\"h_01M75JD46RREB0GATFEX21E2YD\">Sample Query: creative report with AI tags</h3>\n<pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">import requests\n\nurl = \"https://api.singular.net/api/v2.0/create_async_report\"\nparams = {\n    \"api_key\": \"&lt;API KEY&gt;\",\n    \"start_date\": \"2026-11-01\",\n    \"end_date\": \"2026-11-07\",\n    \"time_breakdown\": \"all\",\n    \"dimensions\": \"app,source,adn_creative_id,adn_creative_name\",\n    \"metrics\": \"adn_cost,adn_impressions,adn_clicks\",\n    \"creatives_ai_dimensions\": \"&lt;AI TAG ID 1&gt;,&lt;AI TAG ID 2&gt;\",\n}\nresult = requests.post(url=url, params=params)\nprint(result.json())</code></pre>\n<h3 id=\"h_01HA20VSYMMCCJ69S53GW1RY38\">Sample Output</h3>\n<pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">{\n      \"status\": 0,\n      \"substatus\": 0,\n      \"value\": {\n          \"report_id\": \"5cfdb747dd464cd09a9c463e5be9691f\"\n      }\n  }</code></pre>\n</div><h2 id=\"h_01HA20VSYMSKVF4WC46F3YRXDR\">Available Dimensions and Metrics</h2><p><strong>See the </strong><a href=\"https://support.singular.net/hc/en-us/articles/203389179-Metrics-and-Dimensions\"><strong>Metrics and Dimensions Glossary</strong></a><strong> for a description of each field.</strong></p><h3 id=\"h_01HA20VSYMB8DY5T9YV1X77XQ6\"><span class=\"wysiwyg-underline\">Network Data</span></h3><div class=\"accordion accordion--colored\">\n<div class=\"accordion__item\" id=\"network_dimensions\">\n<div class=\"accordion__item-title\">Network Dimensions</div>\n<div class=\"accordion__item-content\">\n<div style=\"float: right; margin-left: 20px;\"><a style=\"font-size: small;\" href=\"#network_dimensions\">#</a></div>\n<p><strong>Basic dimensions (should be available for all networks):</strong><br><br> </p>\n<p>app<br>source<br>adn_campaign_id<br>adn_campaign_name<br>adn_campaign_url<br>data_connector_id<br>data_connector_source_name<br>data_connector_username<br>data_connector_timestamp_utc</p>\n<p><br><strong>Optional additional dimensions (support varies by network):</strong><br><br> </p>\n<p>breakdown_type - used when \"allow_multiple_breakdowns\" is set to true<br>os<br>platform<br>country_field<br>region_field<br>city_field<br>dma_id_field<br>dma_name_field<br>adn_sub_adnetwork_name<br>adn_account_id<br>adn_account_name<br>adn_sub_campaign_id<br>adn_sub_campaign_name</p>\n<p><br><strong>Keyword and/or publisher breakdown (support varies by network, cannot be pulled in the same query as creative breakdown):</strong><br><br> </p>\n<p>keyword_id<br>keyword<br>publisher_id<br>publisher_site_id<br>publisher_site_name</p>\n<p><br><strong>Creative breakdown (support varies by network, usually cannot be pulled in the same query as keyword/publisher):</strong><br><br> </p>\n<p>creative_type<br>adn_creative_id<br>adn_creative_name<br>creative_url<br>creative_image<br>creative_text<br>creative_width<br>creative_height<br>creative_is_video<br>asset_id<br>asset_name</p>\n<p><br><strong>Campaign properties (</strong><a href=\"https://support.singular.net/hc/en-us/articles/360032548672\" target=\"_self\"><strong>learn more</strong></a><strong>):</strong><br><br> </p>\n<p>bid_type<br>bid_strategy<br>bid_amount<br>campaign_objective<br>standardized_bid_type<br>standardized_bid_strategy<br>original_bid_amount<br>campaign_status<br>min_roas<br>original_metadata_currency</p>\n<p><br><strong>Custom Dimensions:</strong><br><br>If you have defined <a href=\"https://support.singular.net/hc/en-us/articles/208579346\">custom dimensions</a> based on these default network dimensions, you can pull them using their IDs. Use the <a href=\"https://support.singular.net/hc/en-us/articles/360045245692#Custom_Dimensions_Endpoint\">Custom Dimensions Endpoint</a> to get all the custom dimensions defined in your account and their IDs.</p>\n</div>\n</div>\n<div class=\"accordion__item\" id=\"network_metrics\">\n<div class=\"accordion__item-title\">Network Metrics</div>\n<div class=\"accordion__item-content\">\n<div style=\"float: right; margin-left: 20px;\"><a style=\"font-size: small;\" href=\"#network_metrics\">#</a></div>\n<p><strong>Default Metrics:</strong><br><br> </p>\n<p>adn_cost<br>adn_original_cost<br>adn_original_currency<br>adn_impressions<br>adn_clicks<br>adn_installs</p>\n<p><br><strong>Custom Metrics:</strong><br> </p>\n<p><br>If your organization uses special custom metrics (created for you by Singular Support), the name of the metric in the API is in lowercase, with spaces replaced by underlines. For example: <strong>Custom Metric 1 </strong>in the web platform = <strong>custom_metric_1</strong> in the API.</p>\n</div>\n</div>\n</div><h3 id=\"h_81ede3c3-3f23-40d2-b528-a90c9598e020\"><span class=\"wysiwyg-underline\">Tracker Data</span></h3><div class=\"accordion accordion--colored\">\n<div class=\"accordion__item\" id=\"tracker_dimensions\">\n<div class=\"accordion__item-title\">Tracker Dimensions</div>\n<div class=\"accordion__item-content\">\n<div style=\"float: right; margin-left: 20px;\"><a style=\"font-size: small;\" href=\"#tracker_dimensions\">#</a></div>\n<p><strong>Basic dimensions (should be available for all networks):</strong><br><br> </p>\n<p>app<br>source<br>tracker_campaign_id</p>\n<p><br><strong>Optional additional dimensions (support varies by tracker):</strong><br><br> </p>\n<p>tracker_campaign_name<br>os<br>platform<br>country_field</p>\n<p><br><strong>Custom dimensions:</strong><br><br>If you have defined <a href=\"https://support.singular.net/hc/en-us/articles/208579346\">custom dimensions</a> based on these default tracker dimensions, you can pull them using their IDs. Use the <a href=\"https://support.singular.net/hc/en-us/articles/360045245692#Custom_Dimensions_Endpoint\">Custom Dimensions Endpoint</a> to get all the custom dimensions defined in your account and their IDs.</p>\n</div>\n</div>\n<div class=\"accordion__item\" id=\"tracker_metrics\">\n<div class=\"accordion__item-title\">Tracker Metrics</div>\n<div class=\"accordion__item-content\">\n<div style=\"float: right; margin-left: 20px;\"><a style=\"font-size: small;\" href=\"#tracker_metrics\">#</a></div>\n<p><strong>Basic metrics:</strong><br><br> </p>\n<p>tracker_impressions<br>tracker_clicks<br>tracker_installs<br>tracker_conversions<br>tracker_reengagements<br>daily_active_users</p>\n<p><br><strong>Cohort metrics:</strong><br><br> </p>\n<p>revenue<br>original_revenue</p>\n<p><br> </p>\n<div class=\"callout callout--warning\">\n<p>For a full list of the cohort metrics you can use, see the <a href=\"https://support.singular.net/hc/en-us/articles/360045245692#Cohort_Metrics_Endpoint\">Cohort Metrics Endpoint</a>. For more information, see <a href=\"https://support.singular.net/hc/en-us/articles/205046069-Reports-FAQ#what_are_cohort_metrics_periods\">What are cohort metrics?</a></p>\n<p>Note that cohort metrics include ratio-based calculations such as CPE and CPI. We do not recommend using these in API reports (<a href=\"https://support.singular.net/hc/en-us/articles/360028754072#values_dont_make_sense_in_cpe_cpi\">learn more</a>).</p>\n</div>\n<p><br><strong>Events:</strong><br><br>You can pull the stats for any <a href=\"https://support.singular.net/hc/en-us/articles/208385833\">event</a> you have defined. Note that instead of using the event's name as defined in the Singular app, you have to use the event's auto-generated ID, which you can get from the <a href=\"https://support.singular.net/hc/en-us/articles/360045245692#Cohort_Metrics_Endpoint\">Cohort Metrics Endpoint</a>.<br><br><strong>Custom Metrics:</strong><br><br>If your organization uses special custom metrics (created for you by Singular Support), the name of the metric in the API is in lowercase, with spaces replaced by underlines. For example: <strong>Custom Metric 1 </strong>in the web platform = <strong>custom_metric_1</strong> in the API.</p>\n</div>\n</div>\n</div><h3 id=\"h_01HA20VSYMEDB936C2V90Z9EJA\">Combined Data</h3><div class=\"accordion accordion--colored\">\n<div class=\"accordion__item\" id=\"combined_dimensions\">\n<div class=\"accordion__item-title\">Dimensions</div>\n<div class=\"accordion__item-content\">\n<div style=\"float: right; margin-left: 20px;\"><a style=\"font-size: small;\" href=\"#combined_dimensions\">#</a></div>\n<p><strong>Basic dimensions (should be available for all networks and trackers):</strong><br><br> </p>\n<p>app<br>source<br>unified_campaign_id<br>unified_campaign_name</p>\n<p><br><strong>Optional additional dimensions (support varies by network/tracker):</strong><br><br> </p>\n<p>os<br>platform<br>country_field<br>adn_sub_adnetwork_ name<br>adn_account_id<br>adn_account_name<br>sub_campaign_id<br>sub_campaign_name</p>\n<p><br><strong>Keyword and/or publisher breakdown (support varies by network/tracker, cannot be pulled in the same query as creative breakdown):</strong><br><br> </p>\n<p>keyword_id<br>keyword<br>publisher_id<br>publisher_site_id<br>publisher_site_name</p>\n<p><br><strong>Creative breakdown (support varies by network, only available for users of Singular's attribution service):</strong><br><br> </p>\n<p>creative_type<br>adn_creative_id<br>adn_creative_name<br>creative_url<br>creative_image<br>creative_text<br>creative_width<br>creative_height<br>creative_is_video<br>asset_id<br>asset_name</p>\n<p><br><strong>Custom Dimensions:</strong><br><br>If you have defined <a href=\"https://support.singular.net/hc/en-us/articles/208579346\">custom dimensions</a> based on these default dimensions, you can pull them using their IDs. Use the <a href=\"https://support.singular.net/hc/en-us/articles/360045245692#Custom_Dimensions_Endpoint\">Custom Dimensions Endpoint</a> to get all the custom dimensions defined in your account and their IDs.</p>\n</div>\n</div>\n<div class=\"accordion__item\" id=\"combined_metrics\">\n<div class=\"accordion__item-title\">Metrics</div>\n<div class=\"accordion__item-content\">\n<div style=\"float: right; margin-left: 20px;\"><a style=\"font-size: small;\" href=\"#combined_metrics\">#</a></div>\n<p><strong>Basic metrics:</strong><br><br> </p>\n<p>adn_cost<br>adn_original_cost<br>adn_original_currency<br>custom_impressions<br>custom_clicks<br>custom_installs<br>tracker_conversions<br>tracker_reengagements<br>daily_active_users</p>\n<p><br><strong>Metrics for video creatives and video-based campaigns:</strong><br><br> </p>\n<p>video_views<br>video_views_25pct<br>video_views_50pct<br>video_views_75pct<br>completed_video_views<br>completed_video_view_rate</p>\n<p><br><strong>Cohort metrics:</strong><br><br> </p>\n<p>revenue<br>original_revenue</p>\n<p><br> </p>\n<div class=\"callout callout--warning\">\n<p>For a full list of the cohort metrics you can use, see the <a href=\"https://support.singular.net/hc/en-us/articles/360045245692#Cohort_Metrics_Endpoint\">Cohort Metrics Endpoint</a>. For more information, see <a href=\"https://support.singular.net/hc/en-us/articles/205046069-Reports-FAQ#what_are_cohort_metrics_periods\">What are cohort metrics?</a></p>\n<p>Note that cohort metrics include ratio-based calculations such as CPE and CPI. We do not recommend using these in API reports (<a href=\"https://support.singular.net/hc/en-us/articles/360028754072#values_dont_make_sense_in_cpe_cpi\">learn more</a>).</p>\n</div>\n<p><br><strong>Events:</strong><br><br>You can pull the stats for any <a href=\"https://support.singular.net/hc/en-us/articles/208385833\">event</a> you have defined. Note that instead of using the event's name as defined in the Singular app, you have to use the event's auto-generated ID, which you can get from the <a href=\"https://support.singular.net/hc/en-us/articles/360045245692#Cohort_Metrics_Endpoint\">Cohort Metrics Endpoint</a>.<br><br><strong>Custom Metrics:</strong><br><br>If your organization uses special custom metrics (created for you by Singular Support), the name of the metric in the API is in lowercase, with spaces replaced by underlines. For example: <strong>Custom Metric 1 </strong>in the web platform = <strong>custom_metric_1</strong> in the API.</p>\n</div>\n</div>\n</div><div class=\"callout callout--warning\">\n<p><strong>Notes:</strong></p>\n<ul class=\"list-bullet\">\n<li data-list-item-id=\"e1ccd726415cd1909274dbec61a636f37\">Singular tries to give you the highest level of granularity available, but <strong>not all networks and trackers support all breakdowns</strong>. See <a href=\"https://support.singular.net/hc/en-us/sections/360007779491\">Data Connectors in Detail</a> for more information about what data Singular pulls from each source.</li>\n<li data-list-item-id=\"eba55798c53f8e2221c4fc5fa7c2cf607\">Stats such as impressions, clicks, and installs reported by an <strong>ad network</strong> may not match the stats reported by your <strong>tracker</strong>.</li>\n<li data-list-item-id=\"e36001d30e115a9ad212699b3d6489560\">\n<strong>Creative-level combined reports</strong> are only available for users of Singular's attribution service.</li>\n<li data-list-item-id=\"e848a85b98c6e4bfe57ff268419031bd5\">\n<strong>Custom metrics may not be available for creative breakdowns.</strong> Depending on the content of the custom metric (i.e., if it is based on a calculation that involves tracker metrics), if you include it in a report broken down by creative, you may see <a href=\"https://support.singular.net/hc/en-us/articles/360056059811-Understanding-Singular-Reporting-Data#Which_dimensions_prevent_Singular_from_joining_the_data\">\"broken rows\"</a>.</li>\n<li data-list-item-id=\"e6860e800f17e46181941d4168a54c05b\">Reports that include <code>creatives_ai_dimensions</code> run at the creative level.</li>\n<li data-list-item-id=\"ea63586651a743b86cfa8c5b7d537c165\">AI tag IDs that are unknown or not enabled for your account are ignored and don't add a column.</li>\n<li data-list-item-id=\"eb94f947bc065239e6f8ebd0209f79e8f\">You can't filter a report by AI tag values. Don't include AI tag IDs in the <code>filters</code> parameter.</li>\n</ul>\n</div><h1 id=\"h_c0d273fa-4b94-401a-9567-83bf303f6e7f\">Data Availability Endpoint</h1><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table><tbody><tr>\n<td><em><strong>GET</strong></em></td>\n<td><em><strong>https://api.singular.net/api/v2.0/data_availability_status</strong></em></td>\n</tr></tbody></table></figure><h3 id=\"h_01HA20VSYM8PPCCZYE9A13KD9X\">Usage</h3><p>This endpoint returns whether, for a given day, data is available for each of your sources or data connectors.</p><p>We recommend using this endpoint to check whether data is already available for yesterday before you run your daily report(s).</p><p><strong>Using Aggregated ETL (data destinations)?</strong> See the sister API: <a href=\"https://support.singular.net/hc/en-us/articles/11259397533467-Data-Destinations-ETL-Availability-API\" target=\"_self\">Data Destinations (ETL) Availability API</a>, which checks whether your ETL data destination has been fully updated for a given date.</p><p>This endpoint returns whether, for a given day, data is available for each of your sources or data connectors.</p><p>We recommend using this endpoint to check whether data is already available for yesterday before you run your daily report(s).</p><h3 id=\"h_01HA20VSYM06VV1D1TYZV626WV\">Sample Query (Python)</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">import requests\n\n  url = \"https://api.singular.net/api/v2.0/data_availability_status\"\n  queryparams = {\n    \"api_key\":\"&lt;API_KEY&gt;\",\n    \"expanded\":\"true\",\n    \"format\": \"json\",\n    \"data_date\":\"2021-02-01\",\n    \"display_non_active_sources\":\"true\"\n  }\n  \n  response = requests.get(url=url, params=queryparams)</code></pre><h3 id=\"h_01HA20VSYMC2APFX22TBTVNY47\">Query Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>api_key</strong></td>\n<td>String</td>\n<td>API key provided in the Singular console.</td>\n</tr>\n<tr>\n<td>\n<strong>expanded</strong><br> </td>\n<td>Boolean</td>\n<td>Set to \"true\" to get the results for each data connector including the data_connector_id field. Then when you run a report in the Create Async Report endpoint, you can filter the results by data_connector_id. <strong>Default is \"false\" for backward compatibility</strong>.</td>\n</tr>\n<tr>\n<td><strong>format</strong></td>\n<td>String</td>\n<td>Output format: \"json\" or \"csv\".</td>\n</tr>\n<tr>\n<td><strong>data_date</strong></td>\n<td>Date</td>\n<td>The day to check data availability for.</td>\n</tr>\n<tr>\n<td><strong>display_non_active_sources</strong></td>\n<td>Boolean</td>\n<td>\n<strong>[Optional]</strong> Set to \"true\" to include non-active data connectors (data connectors that haven't had data in the last 30 days) in the check.</td>\n</tr>\n</tbody>\n</table></figure><h3 id=\"h_01HA20VSYNPNB49BCMF626MDQ2\">Sample Output (when expanded=true)</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto json\">{\n      \"status\": 0, \n      \"substatus\": 0, \n      \"value\": {\n          \"is_all_data_available\": false,\n          \"data_connectors\": [{\n              \"data_connector_id\": \"dgd7934875\", \n              \"data_connector_source_name\": \"Vungle\", \n              \"data_connector_username\": \"ua@mycompany.com\", \n              \"is_active_last_30_days\": true, \n              \"is_available\": true, \n              \"is_empty_data\": false, \n              \"last_updated_utc\": \"2021-02-08T10:10:07\", \n              \"data_connector_timestamp_utc\": \"2021-02-08T10:10:07\", \n              \"status\": \"data populated\"\n          }, {\n              \"data_connector_id\": \"youi293478\", \n              \"data_connector_source_name\": \"IronSource\", \n              \"data_connector_username\": \"ua@mycompany.com\", \n              \"is_active_last_30_days\": true, \n              \"is_available\": false, \n              \"is_empty_data\": \"N/A\", \n              \"last_updated_utc\": \"N/A\", \n              \"data_connector_timestamp_utc\": \"N/A\", \n              \"status\": \"data not populated\"\n          }]\n      }\n  }</code></pre><h3 id=\"h_01HA20VSYNVPHWB8VANYMZKPMJ\">Output Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>is_all_data_available</strong></td>\n<td>Boolean</td>\n<td>True if there is data available from all data connectors for the given date. Otherwise false.</td>\n</tr>\n<tr>\n<td>\n<strong>data_connectors</strong><br> </td>\n<td> </td>\n<td>An array containing a JSON object for each of your data connectors.</td>\n</tr>\n<tr><td style=\"text-align: center;\" colspan=\"3\">\n<strong>Parameters per Data Connector</strong><br> </td></tr>\n<tr>\n<td>\n<strong>data_connector_id</strong><br> </td>\n<td>String</td>\n<td>A unique identifier for the data connector. You can use this identifier to filter your reports in Create Async Report.</td>\n</tr>\n<tr>\n<td><strong>is_available</strong></td>\n<td>Boolean</td>\n<td>True if there is data from the specific data connector for the given date.</td>\n</tr>\n<tr>\n<td><strong>data_connector_timestamp_utc</strong></td>\n<td>Timestamp</td>\n<td>The date and time in which data was last pulled from this data connector for the given date. Use this field if you are auditing historical data and want to see if Singular has fresher data than the one you currently have in your BI platform.</td>\n</tr>\n<tr>\n<td><strong>is_empty_data</strong></td>\n<td>Boolean</td>\n<td>True if data was pulled successfully from the specific data connector, but the data is empty (all zeros or N/A values). False if data was pulled and contains actual values. Note that if data has not been pulled yet, this field contains \"N/A\".</td>\n</tr>\n<tr>\n<td><strong>status</strong></td>\n<td>String</td>\n<td>\n<p>Additional information about the status of the data. Possible values:</p>\n<ul class=\"list-bullet\">\n<li class=\"wysiwyg-list-bold\" data-list-item-id=\"e05caf85b796c3e7a712fca0e28311e1f\"><strong>\"Data Populated\"</strong></li>\n<li data-list-item-id=\"e49d31dd3eadaad221e32eb40154415dc\">\n<strong>\"Data not Populated\":</strong> No data yet, but no known issues either.</li>\n<li data-list-item-id=\"e39f4bf2ff02e21af8e9c82c7cbf8608b\">\n<strong>\"Login Error\":</strong> Singular couldn’t pull the data because there is a problem with the credentials.</li>\n<li data-list-item-id=\"eb993f8d0cf5421ea4a3d45c846b65a9f\">\n<strong>\"Setup\" or \"Not configured\":</strong> The data connector for this source has not been set up, or there is a problem with the configuration.</li>\n<li data-list-item-id=\"e867f0562ad5d16f033639954ede601ef\">\n<strong>\"Disabled\":</strong> The data connector has been manually disabled.</li>\n</ul>\n</td>\n</tr>\n<tr>\n<td><strong>is_active_last_30_days</strong></td>\n<td>Boolean</td>\n<td>True if this data connector had non-empty data at least once in the last 30 days.</td>\n</tr>\n<tr>\n<td><strong>last_updated_utc</strong></td>\n<td>Timestamp</td>\n<td>The latest time in which data was saved in the Singular database for this data connector. <strong>Note:</strong> There may be a gap of up to several hours from the moment in which the data is pulled through the data connector to the time it is saved in the database.</td>\n</tr>\n</tbody>\n</table></figure><div class=\"accordion accordion--colored\"><div class=\"accordion__item\" id=\"data_availability_sample_output_old\">\n<h3 class=\"accordion__item-title\" id=\"h_01HA20VSYNQDF7DK2S430M0GND\">Sample Output (when \"expanded\" parameter not included or set to false)</h3>\n<div class=\"accordion__item-content\">\n<div style=\"float: right; margin-left: 20px;\"><a style=\"font-size: small;\" href=\"#data_availability_sample_output_old\">#</a></div>\n<pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">{'is_all_data available': false,\n  'data_sources': [\n  {'username': u'facebook@singular.net',\n   'status': 'data populated',\n   'is_empty_data': false,\n   'is_active_last_30_days': true,\n   'last_updated_utc': '2018-05-03T10:12:18'\n   'source': u'Facebook',\n   'is_available': true},\n   {'username': u'vungle@singular.net',\n   'status': 'data populated',\n   'is_empty_data': true,\n   'is_active_last_30_days': true,\n   'last_updated_utc': '2018-05-03T10:12:18'\n   'source': u'Vungle',\n   'is_available': true},\n   {'username': u'applovin@singular.net',\n   'status': 'data not populated',\n   'is_empty_data': N/A,\n   'is_active_last_30_days': true,\n   'last_updated_utc': N/A\n   'source': u'Applovin',\n   'is_available': false}\n  ]}</code></pre>\n<h3 id=\"h_01HA20VSYNGX5N53Q1ANSVRW34\">Output Parameters</h3>\n<figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>is_all_data_available</strong></td>\n<td>Boolean</td>\n<td>True if there is data from all data connectors for the given date. Otherwise false.</td>\n</tr>\n<tr>\n<td><strong>is_available</strong></td>\n<td>Boolean</td>\n<td>True if there is data from the specific data connector for the given date. Otherwise false.</td>\n</tr>\n<tr>\n<td><strong>is_empty_data</strong></td>\n<td>Boolean</td>\n<td>True if data was pulled successfully from the specific source, but the data is empty (all zeros or \"N/A\" values).</td>\n</tr>\n<tr>\n<td><strong>status</strong></td>\n<td>String</td>\n<td>\n<p>Additional information about the status of the data. The possible values are:</p>\n<ul class=\"list-bullet\">\n<li class=\"wysiwyg-list-bold\" data-list-item-id=\"e039db61e89cc2272e4113b54d93a20db\"><strong>\"Data Populated\"</strong></li>\n<li data-list-item-id=\"edc8cc100911d1c1c26e7757f5f7ccf58\">\n<strong>\"Data not Populated\":</strong> No data yet, but no known issues either.</li>\n<li data-list-item-id=\"e17bbb68143222b7158bce9b42d4148c7\">\n<strong>\"Login Error\":</strong> Singular couldn’t pull the data because there is a problem with the credentials.</li>\n<li data-list-item-id=\"e42abd7556ae63477bbd28eafa364dcd4\">\n<strong>\"Setup\" or \"Not configured\":</strong> The data connector for this source has not been set up, or there is a problem with the configuration.</li>\n<li data-list-item-id=\"e85936cb72de115033ebc2cf5d3c7d092\">\n<strong>\"Disabled\":</strong> The data connector has been manually disabled.</li>\n</ul>\n<p>See <a href=\"https://support.singular.net/hc/en-us/articles/360028754072#source_is_not_populated\" target=\"_self\">I queried the data availability endpoint and data is missing for one or more networks. What should I do?</a></p>\n</td>\n</tr>\n<tr>\n<td><strong>is_active_last_30_days</strong></td>\n<td>Boolean</td>\n<td>True if data was non-zeroes for at least one day in the last 30 days. Otherwise false.</td>\n</tr>\n<tr>\n<td><strong>last_updated_utc</strong></td>\n<td>Timestamp</td>\n<td>The latest time in which data was saved in the Singular database for this data connector. <strong>Note:</strong> There may be a gap of up to several hours from the moment in which the data is pulled through the data connector to the time it is saved in the database.</td>\n</tr>\n</tbody>\n</table></figure>\n</div>\n</div></div><h1 id=\"h_9866a50e-46c9-42bc-8658-4ea9893e5070\">Get Report Status Endpoint</h1><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table><tbody><tr>\n<td><em><strong>GET</strong></em></td>\n<td><em><strong>https://api.singular.net/api/v2.0/get_report_status</strong></em></td>\n</tr></tbody></table></figure><h3 id=\"h_01HA20VSYNS700Y5RAW5XCFEJ6\">Usage</h3><p>This endpoint returns the status of a given report that was generated using the <a href=\"#h_d474bc2d-4dc1-427c-a06a-c4f436b5c060\" target=\"_self\">Create Async Report</a> endpoint. If the report has finished running, the endpoint also returns a <strong>download URL</strong>.</p><p class=\"wysiwyg-text-align-center\"><img src=\"https://support.singular.net/hc/article_attachments/360067259511\" alt=\"Screen_Shot_2020-07-01_at_0.17.35.png\" width=\"398\" height=\"99\"></p><p class=\"wysiwyg-text-align-left\">If the report has failed, the endpoint returns an <strong>error message</strong> that you can use to troubleshoot the problem (see the <a href=\"#h_5ed2185c-0a65-4090-ab12-89c87f7fc7cc\" target=\"_self\">Error Codes</a> table and the <a href=\"https://support.singular.net/hc/en-us/articles/360028754072\" target=\"_self\">API FAQ and Troubleshooting</a> guide).</p><p class=\"wysiwyg-text-align-left\">To learn more, see the <a href=\"https://support.singular.net/hc/en-us/articles/207553433#The_Querying_Process\" target=\"_self\"><strong>Querying Process</strong></a> section in the <a href=\"https://support.singular.net/hc/en-us/articles/207553433\" target=\"_self\">Guide to the Singular Reporting API</a>.</p><p><strong>Important:</strong></p><ul class=\"list-bullet\">\n<li data-list-item-id=\"e1b931a7aea6cfc4d9a2403e86e2eb131\">Reports can sometimes take up to a few minutes to complete.</li>\n<li data-list-item-id=\"e9ea466d76ea36758dda4c97efb00955c\">Do not query the report status endpoint more than once every 10 seconds per report.</li>\n<li data-list-item-id=\"e96e3e6dd58639c2b4b795b5cd5672f5e\">\n<strong>Set a timeout. </strong>In some rare cases, a report can get stuck in \"Queued\" or \"Started\" status. If the status is not \"Done\" or \"Failed\" after <strong>30 minutes</strong>, we recommend submitting the report again (which will give you a new report ID to query).</li>\n</ul><h3 id=\"h_01HA20VSYN3Z0XAW78DF98723S\">Sample Query</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">import requests\n  url = \"https://api.singular.net/api/v2.0/get_report_status\"\n  querystring = {\n    \"report_id\":\"5cfdb747dd45be9691f\",\n    \"api_key\": \"&lt;API KEY&gt;\"\n  }\n  response = requests.get(url=url, params=querystring)\n  print(response.text)</code></pre><h3 id=\"h_01HA20VSYNR58229PX414RQKRZ\">Query Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>api_key</strong></td>\n<td>String</td>\n<td>API key provided in the Singular console</td>\n</tr>\n<tr>\n<td><strong>report_id</strong></td>\n<td>String</td>\n<td>A Report ID returned by the Create Async Report endpoint.</td>\n</tr>\n</tbody>\n</table></figure><h3 id=\"h_01HA20VSYNVGW6PZE9B4J77P9Q\">Sample Output</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">{\n    \"status\": 0,\n    \"substatus\": 0,\n    \"value\": {\n        \"status\": \"DONE\",\n        \"url_expires_in\": 3600,\n        \"generated_url_time_in_utc\": \"2018-05-13T08:26:18.457690+00:00\",\n        \"url_expired_time_in_utc\": \"2018-05-13T09:26:18.457690+00:00\",\n        \"download_url\": \"https://singular-reports-results.s3.amazonaws.com/singular/xxxxxxxxx\",\n        \"report_id\": \"5cfdb747dd45be9691f\"\n    }\n  }</code></pre><h3 id=\"h_01HA20VSYNHARB8FM2SHNS4B1Q\">Output Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Output Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>status</strong></td>\n<td>String</td>\n<td>\n<p>Possible values:</p>\n<ul class=\"list-bullet\">\n<li data-list-item-id=\"e9f22baf4c51c999faa32b5f97f17cd5c\">\n<strong>\"QUEUED\": </strong>The report is still waiting in the queue.</li>\n<li data-list-item-id=\"e7b221fcb7dd3a003a1820485d35fc831\">\n<strong>\"STARTED\": </strong>The report is running.</li>\n<li data-list-item-id=\"e1db8e7e743edbcfd77daeed177b13d4d\">\n<strong>\"DONE\": </strong>The report is ready. See the <strong>download_URL</strong> parameter for the URL from which you can download the report file.</li>\n<li data-list-item-id=\"e1515b7c3b9ccda39ff6e91e0e4e94eaf\">\n<strong>\"FAILED\": </strong>The report failed to complete. Read the attached error message and check the <a href=\"#h_5ed2185c-0a65-4090-ab12-89c87f7fc7cc\" target=\"_self\">Error Codes</a> table and the <a href=\"https://support.singular.net/hc/en-us/articles/360028754072\" target=\"_self\">API FAQ and Troubleshooting</a> page for assistance.</li>\n</ul>\n</td>\n</tr>\n<tr>\n<td><strong>generated_url_time_in_utc</strong></td>\n<td>Timestamp</td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>url_expires_in</strong></td>\n<td>Integer</td>\n<td>Seconds until the download URL expires.</td>\n</tr>\n<tr>\n<td><strong>url_expired_time_in_utc</strong></td>\n<td>Timestamp</td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>download_url</strong></td>\n<td>URL</td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>report_id</strong></td>\n<td>String</td>\n<td> </td>\n</tr>\n</tbody>\n</table></figure><h1 id=\"h_7050513d-5f83-45f5-94fa-4b4a4c4314d0\">Filters Endpoint</h1><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table><tbody><tr>\n<td><em><strong>GET</strong></em></td>\n<td><em><strong>https://api.singular.net/api/v2.0/reporting/filters</strong></em></td>\n</tr></tbody></table></figure><h3 id=\"h_01HA20VSYNVKGB7618WBQX8XQ2\">Usage</h3><p>Use this helper endpoint to retrieve an up-to-date list of the dimensions you can filter your report by and the possible values for each dimension.</p><h3 id=\"h_01HA20VSYNW5FJPMDBQ0T4J78J\">Sample Query</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">import requests\n  url = \"https://api.singular.net/api/v2.0/reporting/filters\"\n  params = {'api_key': \"&lt;API KEY&gt;\"}\n  result = requests.get(url=url, params=params)\n  print result.json()</code></pre><h3 id=\"h_01HA20VSYNG000E7QN6G6CBWDE\">Query Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody><tr>\n<td><strong>api_key</strong></td>\n<td>String</td>\n<td>API key provided in the Singular console</td>\n</tr></tbody>\n</table></figure><h3 id=\"h_01HA20VSYNFK61280KRAW4M5VR\">Sample Output</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">{\n    \"status\": 0,\n    \"substatus\": 0,\n    \"value\": {\n      \"dimensions\": [\n        {\n          \"name\": \"os\",\n          \"display_name\": \"OS\",\n          \"values\": [\n              {\"name\": 4, \"display_name\": \"Android\"},\n              {\"name\": 1, \"display_name\": \"iOS\"}\n            ],\n        },\n        {\n          \"name\": \"source\",\n          \"display_name\": \"Source\",\n          \"values\": [{\"name\": \"adwords\", \"display_name\": \"AdWords\"}]\n        }\n      ]\n    }\n  }</code></pre><h1 id=\"h_120d40ba-cc7d-4afc-9d5a-bdde24a0362b\">Custom Dimensions Endpoint</h1><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table><tbody><tr>\n<td><em><strong>GET</strong></em></td>\n<td><em><strong>https://api.singular.net/api/custom_dimensions</strong></em></td>\n</tr></tbody></table></figure><h3 id=\"h_01HA20VSYNQB3S20FQH46H61H5\">Usage</h3><p>Use this endpoint to retrieve the IDs of any custom dimensions configured for your account. You can then use the custom dimension IDs when querying the <strong>Create Async Report</strong> endpoint (instead of or in addition to any of the default dimensions).</p><p>To learn about custom dimensions and how to create them, see the <a href=\"https://support.singular.net/hc/en-us/articles/208579346-Custom-Dimensions-FAQ\"><strong>Custom Dimensions FAQ</strong></a>.</p><h3 id=\"h_01HA20VSYNMTZW4Y3KXCWNC80N\">Sample Query</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">import requests\n  url = \"https://api.singular.net/api/custom_dimensions\"\n  params = {'api_key': \"&lt;API KEY&gt;\"}\n  result = requests.get(url=url, params=params)\n  print result.json()</code></pre><h3 id=\"h_01HA20VSYN62DQ614T2MP3729Q\">Query Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody><tr>\n<td><strong>api_key</strong></td>\n<td>String</td>\n<td>API key provided in the Singular console</td>\n</tr></tbody>\n</table></figure><h3 id=\"h_01HA20VSYNZZA6W35X69YRB6WC\">Sample Output</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">{\n    \"status\": 0,\n    \"substatus\": 0,\n    \"value\": {\n      \"custom_dimensions\": [\n        {\"display_name\": \"Channel Type\", \"id\": \"e471cb6b83684532e5e83cd\"},\n        {\"display_name\": \"Region\", \"id\": \"1dcfdb1ad861fba4b098e2\"}\n      ]\n    }\n  }</code></pre><h1 id=\"h_creative_ai_dimensions_endpoint\">Creative AI Dimensions Endpoint</h1><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table><tbody><tr>\n<td><em><strong>GET</strong></em></td>\n<td><em><strong>https://api.singular.net/api/creative_ai_dimensions</strong></em></td>\n</tr></tbody></table></figure><h3 id=\"h_01M75JD46S7S3GVTMS8DVW9CQ5\">Usage</h3><p>Use this endpoint to retrieve the IDs of the Creative IQ AI tags enabled for your account, such as Background Color. You can then pass these IDs in the <code>creatives_ai_dimensions</code> parameter when querying the <a href=\"#h_d474bc2d-4dc1-427c-a06a-c4f436b5c060\" target=\"_self\">Create Async Report</a> endpoint, to add AI tag values to a creative-level report.</p><p>Only AI tags that are currently enabled for your account are returned. If no AI tags are enabled, the list is empty.</p><p><strong>Note:</strong> This endpoint is only available for accounts with Creative IQ (CIQ) enabled. If CIQ is not enabled for your account, contact your Singular account manager.</p><p>To learn about AI tags and how to set them up, see the <a href=\"https://support.singular.net/hc/en-us/articles/33037500937243-Tagging-FAQ\" target=\"_self\">Tagging FAQ</a>.</p><h3 id=\"h_01M75JD46SKMFZZEKP3DAS9W6S\">Sample Query</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">import requests\n\nurl = \"https://api.singular.net/api/creative_ai_dimensions\"\nparams = {\"api_key\": \"&lt;API KEY&gt;\"}\nresult = requests.get(url=url, params=params)\nprint(result.json())</code></pre><h3 id=\"h_01M75JD46S808664HPK0Q0TAA3\">Query Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody><tr>\n<td><strong>api_key</strong></td>\n<td>String</td>\n<td>API key provided in the Singular console</td>\n</tr></tbody>\n</table></figure><h3 id=\"h_01M75JD46S12F0H9JP7JE21T3P\">Sample Output</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto json\">{\n  \"status\": 0,\n  \"substatus\": 0,\n  \"value\": {\n    \"creative_ai_dimensions\": [\n      {\"id\": \"3f6c1a2e-8b4d-4e5f-9a7b-1c2d3e4f5a6b\", \"display_name\": \"Background Color\"},\n      {\"id\": \"9b8a7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d\", \"display_name\": \"Call to Action\"}\n    ]\n  }\n}</code></pre><h3 id=\"h_01M75JD46S4G7B9TZ5F6KPKN12\">Output Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>id</strong></td>\n<td>String (UUID)</td>\n<td>The AI tag ID. Pass it in the <code>creatives_ai_dimensions</code> parameter of the Create Async Report endpoint.</td>\n</tr>\n<tr>\n<td><strong>display_name</strong></td>\n<td>String</td>\n<td>The AI tag name as shown in the Singular platform.</td>\n</tr>\n</tbody>\n</table></figure><h1 id=\"h_a89bb16a-6214-448f-b3ab-4443b20cc571\">Cohort Metrics Endpoint</h1><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table><tbody><tr>\n<td><em><strong>GET</strong></em></td>\n<td><em><strong>https://api.singular.net/api/cohort_metrics</strong></em></td>\n</tr></tbody></table></figure><h3 id=\"h_01HA20VSYNPVF1NE8DJ022KB8E\">Usage</h3><p>Use this endpoint to retrieve all the cohort metrics and cohort periods available for your account. This includes any in-app events you configured Singular to track (see the <a href=\"https://support.singular.net/hc/en-us/articles/208385833\" target=\"_self\">Events FAQ</a>). You can then specify these metrics and periods when you run a query in the Create Async Report endpoint.</p><p>Note that in the Create Async Report query you need to use the \"name\" of the metric, not the \"display name\".</p><h3 id=\"h_01HA20VSYNNYF83S543MG4NNFW\">Sample Query</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">import requests\n  url = \"https://api.singular.net/api/cohort_metrics\"\n  params = {'api_key': \"&lt;API KEY&gt;\"}\n  result = requests.get(url=url, params=params)\n  print result.json()</code></pre><h3 id=\"h_01HA20VSYNHB8K3HP54NPGGH5R\">Query Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody><tr>\n<td><strong>api_key</strong></td>\n<td>String</td>\n<td>API key provided in the Singular console</td>\n</tr></tbody>\n</table></figure><h3 id=\"h_01HA20VSYNGVN6YMX7HY0TG0CK\">Sample Output</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">{\n      \"status\": 0,\n      \"substatus\": 0,\n      \"value\": {\n          \"metrics\": [\n              {\"display_name\": \"ROI\",\"name\": \"roi\"},\n              {\"display_name\": \"Revenue\",\"name\": \"revenue\"}\n          ],\n          \"periods\": [\"1d\",\"3d\",\"5d\",\"7d\",\"14d\",\"30d\",\"actual\"]\n      }\n  }</code></pre><h3 id=\"h_01HA20VSYNDBQQ2XGMGEDEMPN9\">Output Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Output Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>display_name</strong></td>\n<td>String</td>\n<td>The name of the metric as it appears in the Singular platform.</td>\n</tr>\n<tr>\n<td><strong>name</strong></td>\n<td>String</td>\n<td>The identifier of the metric for use in API queries.</td>\n</tr>\n<tr>\n<td><strong>periods</strong></td>\n<td>Array</td>\n<td>All the cohort periods supported for your account. For more information, see <a href=\"https://support.singular.net/hc/en-us/articles/205046069-Reports-FAQ#what_are_cohort_metrics_periods\" target=\"_self\">What are cohort metrics and cohort periods?</a>\n</td>\n</tr>\n</tbody>\n</table></figure><h1 id=\"h_01K39SATRDAP0P5MNXTQR09FJC\">Conversion Metrics Endpoint</h1><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table><tbody><tr>\n<td><em><strong>GET</strong></em></td>\n<td><em><strong>https://api.singular.net/api/conversion_metrics</strong></em></td>\n</tr></tbody></table></figure><h3 id=\"h_01HA20VSYNN5436HSKZ2MKBHC6\">Usage</h3><p>Use this endpoint to retrieve all the <strong>conversion events</strong> available for your account. You can then specify these events as metrics when you run a query in the Create Async Report endpoint.</p><p>Note that in the Create Async Report query you need to use the \"name\" of the metric, not the \"display name\".</p><h3 id=\"h_01HA20VSYNN2SACXFBWXVF6915\">Sample Query</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">import requests\n  url = \"https://api.singular.net/api/conversion_metrics\"\n  params = {'api_key': \"&lt;API KEY&gt;\"}\n  result = requests.get(url=url, params=params)\n  print result.json()</code></pre><h3 id=\"h_01HA20VSYNS2JFMY92M48EBAT0\">Query Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody><tr>\n<td><strong>api_key</strong></td>\n<td>String</td>\n<td>API key provided in the Singular console</td>\n</tr></tbody>\n</table></figure><h3 id=\"h_01HA20VSYNKQNMD56SHHAP5X9N\">Sample Output</h3><pre class=\"wysiwyg-code-block\"><code class=\"language-auto python\">{\n    \"status\": 0, \n    \"substatus\": 0, \n    \"value\": {\n      \"metrics\": [\n        {\"display_name\": \"5-second video view\", \"name\": \"87dfg34453hsfg6f\"}, \n        {\"display_name\": \"5-second video view CPE\", \"name\": \"87dfg34453hsfg6fCPE\"},   \n        {\"display_name\": \"Sign up\", \"name\": \"iuq353fidr76w846fha\"}, \n        {\"display_name\": \"Sign up CPE\", \"name\": \"iuq353fidr76w846fhaCPE\"}, \n        {\"display_name\": \"Post engagement\", \"name\": \"b59cje9fcgw0th\"}, \n        {\"display_name\": \"Post engagement CPE\", \"name\": \"b59cje9fcgw0thCPE\"},\n      ]\n    }\n  }</code></pre><h3 id=\"h_01HA20VSYNNY1QMB5HJCGQT2BF\">Output Parameters</h3><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Output Parameter</strong></td>\n<td><strong>Format</strong></td>\n<td><strong>Description</strong></td>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>display_name</strong></td>\n<td>String</td>\n<td>The name of the conversion event as configured in the <a href=\"https://support.singular.net/hc/en-us/articles/208385833\" target=\"_self\">Events</a> page.</td>\n</tr>\n<tr>\n<td><strong>name</strong></td>\n<td>String</td>\n<td>The auto-generated identifier of the event - use this identifier in your report query.</td>\n</tr>\n</tbody>\n</table></figure><h1 id=\"h_5ed2185c-0a65-4090-ab12-89c87f7fc7cc\">Error Codes</h1><p>Singular uses standard HTTP response codes to indicate the success or failure of an API request. In general, 200 codes correspond to success, codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted), and 5xx codes are for other issues.</p><p>See also: <a href=\"https://support.singular.net/hc/en-us/articles/360028754072\" target=\"_self\">Reporting API FAQ and Troubleshooting</a></p><figure class=\"wysiwyg-table wysiwyg-table-align-left\"><table>\n<thead><tr>\n<td><strong>Code</strong></td>\n<td><strong>Error Text</strong></td>\n<td><strong>Additional Information</strong></td>\n</tr></thead>\n<tbody>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>An invalid timestamp was given. The timestamp must be of the format: YYYY-MM-DD hh:mm:ss.</strong></td>\n<td>Specify timestamps as in the following example: 2018-01-01 00:00:01</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>An invalid date was given. The date must be of the format: YYYY-MM-DD.</strong></td>\n<td>Specify dates as in the following example: 2018-01-20</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>An invalid date range was given. End date must be later than start date.</strong></td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>An invalid time breakdown was given.</strong></td>\n<td>The time breakdown parameter is either missing in your query or isn't one of the supported options: \"day\", \"week\", \"month\", or \"all\".</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>An invalid filter was given.</strong></td>\n<td>Use the Filters endpoint to get the list of filters you can use in your queries.</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>At least one metric must be used.</strong></td>\n<td>Include at least one metric in your query.</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>The requested data set includes publisher dimensions and extends beyond a single day. Please run single day queries with publisher dimensions.</strong></td>\n<td>Reports broken down by publisher include large volumes of data. To run these reports, limit them to one day.</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>An invalid result format was given. Please select between JSON and CSV.</strong></td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>An invalid country_code_format was given. Please use \"iso3\" or \"iso\".</strong></td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>The request contains invalid dimensions:</strong></td>\n<td>One or more dimensions you requested in the query are either deprecated or invalid. If you used custom dimensions, double-check that they are available (using the custom dimensions endpoint) and make sure you used the dimension IDs (rather than their display names).</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>The request contains duplicate fields: [list]</strong></td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>The request contains invalid metrics:</strong></td>\n<td>One or more metrics you requested in the query are either deprecated or invalid. If you used cohort metrics or conversion events, double-check that they are available (using the cohort metrics and conversion events endpoints) and make sure you used the metric names (rather than their display names).</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>The request contains invalid cohort periods:</strong></td>\n<td>Use the cohort metrics endpoints to check which cohort periods are available for your account.</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>We could not find cohort periods for the following cohort metrics: .</strong></td>\n<td>Add cohort periods for your cohort metrics.</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>The request contains dimensions from an old API version: . Please use dimensions from the v2 API endpoint only.</strong></td>\n<td>The request included dimensions from multiple API versions, which is not supported.</td>\n</tr>\n<tr>\n<td><strong>400</strong></td>\n<td><strong>The request is missing the following parameter: .</strong></td>\n<td> </td>\n</tr>\n<tr>\n<td><strong>401</strong></td>\n<td><strong>An invalid API Key was given.</strong></td>\n<td>The API key is either missing or invalid. To get your API key, log into your Singular account and go to <strong>Developer Tools &gt; API Keys</strong>.</td>\n</tr>\n<tr>\n<td><strong>401</strong></td>\n<td><strong>The provided API key has been previously deactivated. Please contact your administrator.</strong></td>\n<td>You are using an API key that belonged to a deactivated user. To get your API key, log into your Singular account and go to <strong>Developer Tools &gt; API Keys</strong>.</td>\n</tr>\n<tr>\n<td><strong>403</strong></td>\n<td>\n<strong>The provided API key does not have permissions to view the field:</strong><br> </td>\n<td>The API key provided does not have permissions to view a dimension or metric you requested. Contact your organization's administrator to make sure you have the permissions you need.</td>\n</tr>\n<tr>\n<td><strong>403</strong></td>\n<td><strong>The request is denied access. Please contact your administrator.</strong></td>\n<td>The request is denied. Contact your organization's administrator for further information.</td>\n</tr>\n<tr>\n<td><strong>404</strong></td>\n<td><strong>Report ID is not found. Please correct it or create a new report.</strong></td>\n<td>Double-check that you used the Report ID returned from the Create Async Report endpoint. If the error persists, create a new report.</td>\n</tr>\n<tr>\n<td><strong>404</strong></td>\n<td><strong>Report ID was created with a different key. Please use the same key when requesting status.</strong></td>\n<td>To query for a report status, you must use the same API key you used to generate the report.</td>\n</tr>\n<tr>\n<td><strong>405</strong></td>\n<td><strong>METHOD NOT ALLOWED</strong></td>\n<td>You are probably using GET instead of POST or vice versa in your http request.</td>\n</tr>\n<tr>\n<td><strong>429</strong></td>\n<td><strong>Query quota is exceeded: only &lt;&gt; reports are currently allowed. The following report IDs are active: .</strong></td>\n<td>You have exceeded the amount of async reports you are permitted to run at the same time. Wait for your previous requests to complete.</td>\n</tr>\n<tr>\n<td><strong>429</strong></td>\n<td><strong>Too many requests. Only &lt;&gt; requests per second is currently allowed.</strong></td>\n<td>You have exceeded the rate limit. Wait for your previous requests to complete.</td>\n</tr>\n<tr>\n<td><strong>500</strong></td>\n<td><strong>The request has failed due to an internal error.</strong></td>\n<td>Typically, this just means you should retry your API call. See <a href=\"https://support.singular.net/hc/en-us/articles/360028754072#500_error\" target=\"_self\">What should I do if I get a 500 error?</a>\n</td>\n</tr>\n</tbody>\n</table></figure>"}}