techstack-fingerprinter-api/openapi.json at main · topaisaas-dev/techstack-fingerprinter-api · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
{
  "openapi": "3.0.3",
  "info": {
    "title": "TechStack Fingerprinter API",
    "description": "Sub-millisecond technographic scanner and website tech stack detector for cold outreach, Clay.com, and AI sales agents.",
    "version": "1.0.0",
    "contact": {
      "name": "TopAI SaaS Studio",
      "email": "top.ai.saas@gmail.com",
      "url": "https://techstack-fingerprinter.topaisaas.workers.dev"
    }
  },
  "servers": [
    {
      "url": "https://techstack-fingerprinter.topaisaas.workers.dev",
      "description": "Cloudflare Workers Production Edge"
    }
  ],
  "paths": {
    "/v1/health": {
      "get": {
        "summary": "Healthcheck",
        "description": "Service health and uptime verification.",
        "responses": {
          "200": {
            "description": "Service is healthy and active."
          }
        }
      }
    },
    "/v1/fingerprint": {
      "post": {
        "summary": "Fingerprint Website Tech Stack",
        "description": "Scans a website or domain in milliseconds, detecting CMS, eCommerce, Frameworks, Analytics, CRM, CDN, and Payment gateways.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": { "type": "string", "example": "https://gymshark.com", "description": "Target website URL or domain" },
                  "domain": { "type": "string", "example": "gymshark.com", "description": "Alternative domain field" }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Comprehensive technographic fingerprint",
            "content": {
              "application/json": {
                "example": {
                  "success": true,
                  "result": {
                    "url": "https://gymshark.com",
                    "domain": "gymshark.com",
                    "status_code": 200,
                    "response_time_ms": 52,
                    "technologies_count": 9,
                    "categories": {
                      "ecommerce": ["Shopify"],
                      "cms": [],
                      "frameworks": ["React"],
                      "analytics_tracking": ["Google Analytics 4", "Google Tag Manager", "Meta Pixel"],
                      "marketing_crm": ["Klaviyo"],
                      "payments": ["Stripe"],
                      "hosting_cdn": ["Cloudflare"],
                      "security_compliance": ["OneTrust"]
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/detect": {
      "get": {
        "summary": "Quick Detect via Query Param",
        "description": "GET endpoint for easy integration into Google Sheets, Airtable, or simple scripts.",
        "parameters": [
          { "name": "url", "in": "query", "schema": { "type": "string", "example": "https://stripe.com" }, "description": "Target website URL" },
          { "name": "domain", "in": "query", "schema": { "type": "string", "example": "stripe.com" }, "description": "Target domain" }
        ],
        "responses": {
          "200": {
            "description": "Technographic detection result"
          }
        }
      }
    },
    "/v1/batch": {
      "post": {
        "summary": "Batch Fingerprint (Up to 5 Domains)",
        "description": "Concurrently fingerprints multiple domains in a single API call for high-speed table enrichment in Clay.com or n8n.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["domains"],
                "properties": {
                  "domains": {
                    "type": "array",
                    "items": { "type": "string" },
                    "example": ["shopify.com", "stripe.com", "webflow.com"],
                    "description": "List of domains to fingerprint (max 5)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Batch fingerprint results"
          }
        }
      }
    },
    "/v1/technologies": {
      "get": {
        "summary": "List Supported Technologies",
        "description": "Returns the complete catalog of detectable tech signatures and categories.",
        "responses": {
          "200": {
            "description": "Catalog of supported signatures"
          }
        }
      }
    }
  }
}