---
title: "Fetch top user agents"
method: GET
path: "/waap/v1/ip-info/top-user-agents"
tags: ["IP Spotlight"]
---

# Fetch top user agents

`GET /waap/v1/ip-info/top-user-agents`

Retrieve the top 10 user agents interacting with a specified domain, filtered by IP.

## Query parameters

- `ip` union, required — The IP address to check
  - string, ipv4
  - string, ipv6
- `domain_id` integer, required — The identifier for a domain. When specified, the response will exclusively contain data pertinent to the indicated domain, filtering out information from other domains.

## Response `200`

Successful Response

- TopUserAgent[]
  - `user_agent` string, required — The user agent that was used
  - `count` integer, required — The number of requests made with the user agent

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Unauthenticated
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)