List top Discover pages

The pages of your property with the most Discover clicks.

GET https://cotlet.dev/api/v1/google-discover/top-discover-pages

read

Returns pages ordered by clicks, highest first, with clicks, impressions and CTR, from the same Discover report. It reads your own property only; Google does not support byProperty aggregation for Discover.

Parameters

Parameters: list_top_discover_pages
NameTypeDescription
property string required string Search Console property: sc-domain:example.com for a Domain property, https://example.com/ for a URL-prefix property.
start_date string required string First day, YYYY-MM-DD.
end_date string required string Last day, YYYY-MM-DD.
limit integer integer How many pages to return.

Request

cURL
curl "https://cotlet.dev/api/v1/google-discover/top-discover-pages?property=property&start_date=start+date&end_date=end+date" \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("google-discover", "list_top_discover_pages", {"property":"property","start_date":"start date","end_date":"end date"})
Node.js
const result = await cotlet.call('google-discover', 'list_top_discover_pages', {"property":"property","start_date":"start date","end_date":"end date"});
CLI
cotlet call google-discover list_top_discover_pages --data '{"property":"property","start_date":"start date","end_date":"end date"}'

Example response

JSON

{
  "property": "sc-domain:example-news.com",
  "rows": [
    {
      "page": "https://example-news.com/guides/windowsill-herbs",
      "clicks": 3920,
      "impressions": 118000,
      "ctr": 0.0332
    },
    {
      "page": "https://example-news.com/guides/sourdough-starter",
      "clicks": 2610,
      "impressions": 91500,
      "ctr": 0.0285
    },
    {
      "page": "https://example-news.com/guides/composting-basics",
      "clicks": 1890,
      "impressions": 64200,
      "ctr": 0.0294
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.