# StackScan API (full reference)

Generated from the live OpenAPI document at https://api.stackscan.com/docs/openapi.json
For the short version see https://api.stackscan.com/llms.txt

========================================================================
GET https://api.stackscan.com/v1/tech-lookup/credits
========================================================================

Balance and monthly allocation. Free.

Example:
  curl -H "Authorization: Bearer $TOKEN" -H "X-Tenant-Id: $TENANT" \
       "https://api.stackscan.com/v1/tech-lookup/credits"

========================================================================
GET https://api.stackscan.com/v1/tech-lookup/domains/lookup
========================================================================

Technologies on one domain, paginated (50/page, max 500).

Parameters:
  domain                 string    (required) Bare domain, no scheme or path.
  page                   integer   Page number, from 1.
  per_page               integer   Technologies per page. Default 50, max 500.
  category               boolean   Include the category field. A TOGGLE, not a filter.
  sub_category           boolean   Include the sub_category field.
  total_sites            boolean   Include global usage per technology.
  fresh                  boolean   Bypass the response cache. Still charged.

Example:
  curl -H "Authorization: Bearer $TOKEN" -H "X-Tenant-Id: $TENANT" \
       "https://api.stackscan.com/v1/tech-lookup/domains/lookup?domain=example.com"

========================================================================
GET https://api.stackscan.com/v1/tech-lookup/technologies/lookup
========================================================================

How many sites run a technology, and where.

Parameters:
  technology             string    (required) Technology name, e.g. Shopify.
  websites               boolean   Include the matching website list.

Example:
  curl -H "Authorization: Bearer $TOKEN" -H "X-Tenant-Id: $TENANT" \
       "https://api.stackscan.com/v1/tech-lookup/technologies/lookup?technology=Shopify"

========================================================================
GET https://api.stackscan.com/v1/tech-lookup/companies/lookup
========================================================================

The company behind one domain.

Parameters:
  domain                 string    (required) Bare domain, no scheme or path.

Example:
  curl -H "Authorization: Bearer $TOKEN" -H "X-Tenant-Id: $TENANT" \
       "https://api.stackscan.com/v1/tech-lookup/companies/lookup?domain=example.com"

========================================================================
POST https://api.stackscan.com/v1/tech-lookup/companies/batch
========================================================================

Companies for up to 100 domains in one request.

Parameters:
  domains                string[]  (required) JSON body. 1 to 100 domains.

Example:
  curl -H "Authorization: Bearer $TOKEN" -H "X-Tenant-Id: $TENANT" \
       -H "Content-Type: application/json" \
       -d '{"domains":["example.com","stripe.com"]}' \
       -X POST "https://api.stackscan.com/v1/tech-lookup/companies/batch"

========================================================================
POST https://api.stackscan.com/v1/tech-lookup/domains/batch
========================================================================

Technologies for up to 100 domains, with optional category filter.

Parameters:
  domains                string[]  (required) JSON body. 1 to 100 domains.
  per_domain             integer   Technologies per domain. Default 10, max 50.
  category               string    Only technologies in this category. A FILTER here, unlike on domains/lookup.

Example:
  curl -H "Authorization: Bearer $TOKEN" -H "X-Tenant-Id: $TENANT" \
       -H "Content-Type: application/json" \
       -d '{"domains":["example.com","stripe.com"]}' \
       -X POST "https://api.stackscan.com/v1/tech-lookup/domains/batch"