Get Dashboard Stats

Retrieve comprehensive dashboard statistics including total reports, status breakdowns, top categories, monthly trends, top users, recent alerts, and popular reports

GET /dashboard

cURL

curl --request GET \
  --url https://api.falconalert.com/dashboard

Response

{
  "stats": {
    "total_reports": 30,
    "pending_reports": 18,
    "approved_reports": 8,
    "rejected_reports": 4,
    "protected_people": 11,
    "total_users": 12
  },
  "topCategoriesReports": [
    {
      "name": "Muebles",
      "total_reportes": 8
    },
    {
      "name": "Ropa",
      "total_reportes": 4
    },
    {
      "name": "Electrónica",
      "total_reportes": 10
    },
    {
      "name": "Libros",
      "total_reportes": 5
    },
    {
      "name": "Juguetes",
      "total_reportes": 4
    },
    {
      "name": "Deportes",
      "total_reportes": 4
    }
  ],
  "reportsPerMonth": [
    {
      "month": "2025-09",
      "total_reports": 5
    },
    {
      "month": "2025-10",
      "total_reports": 25
    }
  ],
  "topUsers": [
    {
      "name": "Arturo Utrillaa",
      "total_reports": 3
    },
    {
      "name": "Ana Keila Martínez Moreno",
      "total_reports": 3
    },
    {
      "name": "Dr. Sahur",
      "total_reports": 1
    }
  ],
  "recentAlerts": [
    {
      "id": 45,
      "title": "televisor Smart a precio muy bajo"
    },
    {
      "id": 44,
      "title": "ropa de marca original a súper descuento"
    },
    {
      "id": 43,
      "title": "Prueba"
    },
    {
      "id": 9,
      "title": "Portal falso de soporte técnico"
    },
    {
      "id": 8,
      "title": "Portal falso de soporte técnico"
    }
  ],
  "topReportsMonth": [
    {
      "id": 2,
      "title": "Página de phishing detectada",
      "upvotes": 2
    },
    {
      "id": 7,
      "title": "Portal falso de soporte técnico",
      "upvotes": 2
    },
    {
      "id": 1,
      "title": "Tienda de componentes de computadoras DDCompus",
      "upvotes": 1
    },
    {
      "id": 3,
      "title": "Sitio de ventas falsas",
      "upvotes": 1
    },
    {
      "id": 8,
      "title": "Portal falso de soporte técnico",
      "upvotes": 1
    },
    {
      "id": 9,
      "title": "Portal falso de soporte técnico",
      "upvotes": 1
    },
    {
      "id": 26,
      "title": "Viaje a la luna",
      "upvotes": 1
    },
    {
      "id": 34,
      "title": "ventas de sillas: Silla de oficina que teletransporta a la playa por $300",
      "upvotes": 1
    },
    {
      "id": 44,
      "title": "ropa de marca original a súper descuento",
      "upvotes": 1
    }
  ]
}

Response

stats · object

Overall statistics summary

Show stats properties

total_reports · number

Total number of reports in the system

pending_reports · number

Number of reports with pending status

approved_reports · number

Number of reports that have been approved

rejected_reports · number

Number of reports that have been rejected

protected_people · number

Number of people protected by approved reports

total_users · number

Total number of users in the system

topCategoriesReports · array

List of top categories by report count

Show topCategoriesReports item

name · string

Category name

total_reportes · number

Total number of reports in this category

reportsPerMonth · array

Monthly report statistics

Show reportsPerMonth item

month · string

Month in YYYY-MM format

total_reports · number

Total number of reports created in this month

topUsers · array

Top users by report creation count

Show topUsers item

name · string

User’s name

total_reports · number

Total number of reports created by this user

recentAlerts · array

Most recently created alerts

Show recentAlerts item

id · number

Alert ID

title · string

Alert title

topReportsMonth · array

Top reports for the current month ranked by upvotes

Show topReportsMonth item

id · number

Report ID

title · string

Report title

upvotes · number

Number of upvotes received

cURL

curl --request GET \
  --url https://api.falconalert.com/dashboard

Response

{
  "stats": {
    "total_reports": 30,
    "pending_reports": 18,
    "approved_reports": 8,
    "rejected_reports": 4,
    "protected_people": 11,
    "total_users": 12
  },
  "topCategoriesReports": [
    {
      "name": "Muebles",
      "total_reportes": 8
    },
    {
      "name": "Ropa",
      "total_reportes": 4
    },
    {
      "name": "Electrónica",
      "total_reportes": 10
    },
    {
      "name": "Libros",
      "total_reportes": 5
    },
    {
      "name": "Juguetes",
      "total_reportes": 4
    },
    {
      "name": "Deportes",
      "total_reportes": 4
    }
  ],
  "reportsPerMonth": [
    {
      "month": "2025-09",
      "total_reports": 5
    },
    {
      "month": "2025-10",
      "total_reports": 25
    }
  ],
  "topUsers": [
    {
      "name": "Arturo Utrillaa",
      "total_reports": 3
    },
    {
      "name": "Ana Keila Martínez Moreno",
      "total_reports": 3
    },
    {
      "name": "Dr. Sahur",
      "total_reports": 1
    }
  ],
  "recentAlerts": [
    {
      "id": 45,
      "title": "televisor Smart a precio muy bajo"
    },
    {
      "id": 44,
      "title": "ropa de marca original a súper descuento"
    },
    {
      "id": 43,
      "title": "Prueba"
    },
    {
      "id": 9,
      "title": "Portal falso de soporte técnico"
    },
    {
      "id": 8,
      "title": "Portal falso de soporte técnico"
    }
  ],
  "topReportsMonth": [
    {
      "id": 2,
      "title": "Página de phishing detectada",
      "upvotes": 2
    },
    {
      "id": 7,
      "title": "Portal falso de soporte técnico",
      "upvotes": 2
    },
    {
      "id": 1,
      "title": "Tienda de componentes de computadoras DDCompus",
      "upvotes": 1
    },
    {
      "id": 3,
      "title": "Sitio de ventas falsas",
      "upvotes": 1
    },
    {
      "id": 8,
      "title": "Portal falso de soporte técnico",
      "upvotes": 1
    },
    {
      "id": 9,
      "title": "Portal falso de soporte técnico",
      "upvotes": 1
    },
    {
      "id": 26,
      "title": "Viaje a la luna",
      "upvotes": 1
    },
    {
      "id": 34,
      "title": "ventas de sillas: Silla de oficina que teletransporta a la playa por $300",
      "upvotes": 1
    },
    {
      "id": 44,
      "title": "ropa de marca original a súper descuento",
      "upvotes": 1
    }
  ]
}