hunt-shadow-api

Enumerate API version history and behaviorally diff old versus current endpoints for security regressions.

4.0k|628|Updated May 5, 2026
One-click install
npx skills add https://github.com/elementalsouls/Claude-BugHunter --skill hunt-shadow-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hunt-shadow-api
Source: https://github.com/elementalsouls/Claude-BugHunter/tree/main/skills/hunt-shadow-api
Command: npx skills add https://github.com/elementalsouls/Claude-BugHunter --skill hunt-shadow-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Old API versions, deprecated routes, and undocumented endpoints often stay reachable without receiving the security fixes applied to the current version, creating shadow and zombie API attack surface that standard testing misses.

Core Features & Use Cases

  • Version Surface Enumeration: Probe path-based, header-based, and subdomain-based API versioning to find every live version of an API.
  • Spec Discovery and Diffing: Pull current and archived OpenAPI/Swagger specs (including via the Wayback Machine) and diff endpoint inventories to find zombie routes.
  • Behavioral Regression Testing: Compare auth strength, rate limiting, input validation, and field exposure between old and current versions of the same operation.
  • Use Case: A target's mobile app hardcodes calls to /api/v1/ while the web app uses /api/v2/. Use this Skill to confirm v1 is still live, then test whether it accepts expired tokens or skips rate limits that v2 enforces.

Quick Start

Enumerate all reachable API versions on the target and diff the old version's auth, rate-limit, and validation behavior against the current version.

Frequently Asked Questions about hunt-shadow-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find shadow or zombie API endpoints on a target?

Enumerate versioned paths like /api/v1/ and /api/v2/, probe header-based versioning, and pull old OpenAPI/Swagger specs including archived copies from the Wayback Machine. Diff the endpoint inventories and confirm any old-spec-only route still returns something other than 404.

How do I test old API versions for security regressions?

Send identical requests to both versions and compare security behavior, not response shape. Check whether the old version accepts expired or lower-privilege tokens, lacks rate limiting, accepts payloads the new version rejects, or leaks fields the new version redacts.

What is the difference between shadow API discovery and API misconfiguration testing?

Shadow API work owns version inventory and behavioral diffing between old and current API versions. Once a specific endpoint or spec is in hand, exploitation techniques like mass assignment, JWT attacks, and OData abuse belong to API misconfiguration testing.

When should I not use API version diffing?

Skip it when the target has a single API version with no version history, since there is nothing to diff. In that case, go directly to testing the one existing surface for misconfigurations and injection flaws.

Why is a reachable old API version not always a finding?

A version difference alone, such as cosmetic field renaming or a static deprecation notice, is informational only. The finding requires a security-relevant regression, and you must confirm the old endpoint is not just a proxy to the current implementation.