Url Analysis

Chart

Endpoint

GET https://art.ayima.com/api/reports/{reportId}/distribution/chart

parameters

name	type	description	required
from	Date	The start date range for result data	✅
to	String	The end date range for result data	✅
format	String	The format to return the data in. Options are: 'json' (default),'csv','xlsx','xls','html','tsv','ods'	✅
plot_by	String	How to group the data. Options are: 'daily','weekly','quarterly','monthly','yearly'	✅
group_by	String	If the data should be grouped using domains or hostname. Options are: 'hostname', 'domain'	✅
store	String	String value indicating the last viewed record is updated. Value can be 'true' or 'false' NOT Boolen	🚫
domain	String	Competitor domain to pull results for	🚫
hostname	String	Competitor hostname to pull results for	🚫
keywords	Array	A array list of keywords to filter the returned results	✅

Response

{
  "series": [
    {
      "url": "...",
      "color": "...",
      "rankings": []
    },
    {
      "url": "...",
      "color": "...",
      "rankings": []
    }
  ],
  "categories": [],
  "categories_formatted": [],
  "annotations": [],
  "date_range_string": "...",
  "range": {
    "max": "...",
    "min": "..."
  }
}

Table

Endpoint

GET https://art.ayima.com/api/reports/{reportId}/distribution/table

parameters

name	type	description	required
from	Date	The start date range for result data	✅
to	Date	The end date range for result data	✅
page_number	int	The current page of the paginated data.	✅
page_size	int	The number of items to return on each page.	✅
group_by	String	If the data should be grouped using domains or hostname. Options are: 'hostname', 'domain'	✅
col_order	Boolean	Sorting order, options are: 'url', 'avg_position', 'best_position', 'deviation', 'intermittency', 'median_position'	✅
col_order_dir	String	The direction of ordering, either 'asc' or 'desc'	✅
keyword	String	The keyword used to filter data for.	✅
domains	Array	An array of domains used to filter data for.	✅
format	String	The format to return the data in. Options are: 'json' (default),'csv','xlsx','xls','html','tsv','ods'	✅

Response

{
  "current_page": "...",
  "data": [
    {
      "label": "...",
      "timestamp": "...",
      "total": "...",
      "01-05": "...",
      "06-10": "...",
      "11-20": "...",
      "21-50": "...",
      "50+": "...",
      "01-05 %": "...",
      "06-10 %":"...",
      "11-20 %": "...",
      "21-50 %": "...",
      "50+ %": "..."
    }
  ],
  "first_page_url": "...",
  "from": "...",
  "last_page": "...",
  "last_page_url": "...",
  "next_page_url": "...",
  "path": "...",
  "per_page": "...",
  "prev_page_url": "...",
  "to": "...",
  "total": "..."
}