Skip to content

Commit 152e1cf

Browse files
committed
Describe Stack homepage observations accurately
Describe the current static homepage HTML and response-header observation without claiming bounded site coverage.
1 parent 46c6cb6 commit 152e1cf

2 files changed

Lines changed: 4 additions & 4 deletions

File tree

‎README.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -364,9 +364,9 @@ result = parse.stack("example.com")
364364
# AsyncParseAPI exposes the same calls with await.
365365
```
366366

367-
Pass a public hostname without a scheme, path, port or IP address. Stack returns the checked URL and `checked_at` time, followed by `scope`, `pages` and `partial`. `scope` is `homepage` or `site`; `pages` counts successfully checked HTML pages. `partial` is true for homepage-only or incomplete bounded site checks. False means the known in-scope candidates were completed, not that every page on a website was visited. A homepage result has `scope: "homepage"`, `pages: 1` and `partial: true`.
367+
Stack checks static homepage HTML and response headers. It returns the checked URL, original `checked_at` time and eight technology arrays.
368368

369-
`cms`, `servers`, `frameworks`, `ecommerce`, `analytics`, `chat`, `payments` and `hosting` are arrays because a site can use several technologies in each category. Each entry contains `technology`, `name` and nullable `version`. Technology codes are open strings. A successful check uses empty arrays for categories with no matches. When no HTML page could be checked, `checked_at` and all categories are null, `pages` is 0 and `partial` is null. Unknown or conflicting versions are null. Missing detections do not prove absence.
369+
`cms`, `servers`, `frameworks`, `ecommerce`, `analytics`, `chat`, `payments` and `hosting` are arrays because a site can use several technologies in each category. Each entry contains `technology`, `name` and nullable `version`. Technology codes are open strings. A successful check uses empty arrays for categories with no matches. When no HTML page could be checked, `checked_at` and all categories are null. Unknown or conflicting versions are null. Detections describe the checked homepage.
370370

371371
Successful checks may be reused for up to 24 hours. `pretty` optionally formats the wire JSON. Stack uses your plan's request allowance and API version 2.0.0 selected by this client.
372372

‎src/parseapi/_client.py‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -307,7 +307,7 @@ def hlr(self, number: str, *, country: Optional[str] = None, deep: bool = False)
307307
def stack(self, domain: str, *, deep: bool = False, pretty: bool = False) -> Json:
308308
"""Identify website technologies and versions by category.
309309
310-
All categories are lists. Scope, pages and partial describe bounded coverage.
310+
Categories are arrays or null.
311311
Lists are null when no page could be checked and empty for no matches.
312312
Pass a hostname without a URL scheme or path.
313313
"""
@@ -749,7 +749,7 @@ async def hlr(self, number: str, *, country: Optional[str] = None, deep: bool =
749749
async def stack(self, domain: str, *, deep: bool = False, pretty: bool = False) -> Json:
750750
"""Identify website technologies and versions by category.
751751
752-
All categories are lists. Scope, pages and partial describe bounded coverage.
752+
Categories are arrays or null.
753753
Lists are null when no page could be checked and empty for no matches.
754754
Pass a hostname without a URL scheme or path.
755755
"""

0 commit comments

Comments
 (0)