limit up to 200). Filters are combined with AND.
Access and credits
- Community keys need available credits. Each successful request deducts one credit.
- Enterprise accounts use the Global Search module:
- The module must be enabled for the account; otherwise the route returns
403“Global Search module is not enabled”. - If the account has a filter allow-list, every filter in the request must be on it (aliases such as
tagsare checked by their canonical name,tag). A filter outside the list returns403“Filter not enabled for your account: …”. An account without an allow-list may use every filter. - Each successful request deducts one credit from the account’s Global Search credit pool, not from its regular credits. An empty pool returns
403“You have no remaining Global Search credits”. - Accounts with Global Search vulnerability access also receive each host’s
vulnerabilitiesfield; other callers do not.
- The module must be enabled for the account; otherwise the route returns
Request
Filters
At least one supported search filter is required. Invalid filter combinations return
422.
Response behavior
- Page size is
limit(default 50, maximum 200); the response’spage_sizereports it. total_query_resultsis capped for display.total_pagesis derived from the displayed count.- A successful authenticated request consumes one credit (Enterprise: from the Global Search pool). The response’s
creditsfield is the remaining balance. - Results omit selected heavy internal fields.
