bee-visitor-recent
> Version: 2.0.3
Overview
Use the Bee Website Builder Open API to retrieve the latest visitor data and generate a structured analysis report.
Supports paginated queries.
Input Parameters
api_key (string, Required)
API authentication key used for caller identity verification and interface access control.
- Get it from: https://open.tradew.com
- Recommended configuration: Inject it via
skills.entries.env.BEE_API_KEY to avoid passing it in plaintext on every call.
pagination (object, Required)
Pagination configuration parameters.
current_page (integer)
- Default: 1
- Minimum: 1
- Pagination rules:
- Must rely on
data.pagination.has_next_page - Use
data.pagination.next_page as the next page number - Do not infer pages based on
total_page or manual increments - Requests must stop when
has_next_page=false
page_size (integer)
- Default: 10
- Range: 10 ~ 50
Output Structure
Top-Level Fields
| Field | Type | Description |
|---|
| -------- | ---------------- | ---------------------------------------- |
| status | boolean | Request status, true for success / false for failure |
| msg | string | Response message |
| data | object \ | null | Response data, null on failure |
data.pagination
| Field | Type | Description |
|---|
| ---------------- | -------------- | ------------------------ |
| current_page | integer | Current page number |
| page_size | integer | Items per page |
| total_page | integer | Total pages |
| total_count | integer | Total records |
| has_next_page | boolean | Whether a next page exists |
| next_page | integer/null | Next page number |
data.list[] (visitor data list)
| Field | Type | Description |
|---|
| ------------------ | --------- | ------------------------------- |
| ip | string | Visitor IP (IPv4 / IPv6) |
| country_code | string | Country code (ISO 3166-1) |
| page_views | integer | Page view count |
| first_visit | object | First visit record |
| recent_visits | array | Recent visit records (up to 50) |
| first_visit_time | string | First visit time (ISO 8601) |
| last_visit_time | string | Last visit time (ISO 8601) |
first_visit Object
| Field | Type | Description |
|---|
| -------------- | -------- | -------------------------- |
| page | object | First visited page info |
| screen | object | Screen resolution |
| visit_time | string | First visit time |
| referer | string | Referrer URL |
| current_url | string | Current visit URL |
| user_agent | string | Browser User-Agent |
first_visit.page
| Field | Type | Description |
|---|
| ------- | --------- | ----------------- |
| id | integer | Page ID |
| name | string | Page name |
| code | string | Page identifier |
first_visit.screen
| Field | Type | Description |
|---|
| -------- | --------- | --------------- |
| width | integer | Screen width |
| height | integer | Screen height |
recent_visits[] Object
| Field | Type | Description |
|---|
| -------------- | -------- | --------------------- |
| page | object | Page information |
| screen | object | Screen resolution |
| visit_time | string | Visit time |
| referer | string | Referrer URL |
| current_url | string | Current URL |
| user_agent | string | Browser User-Agent |
recent_visits.page
| Field | Type | Description |
|---|
| ------- | --------- | ----------------- |
| id | integer | Page ID |
| name | string | Page name |
| code | string | Page identifier |
recent_visits.screen
| Field | Type | Description |
|---|
| -------- | --------- | ------------- |
| width | integer | Width |
| height | integer | Height |
Notes
data may be null on failurerecent_visits contains at most 50 entries- All time fields use ISO 8601
next_page is valid only when has_next_page=true- Whether to continue pagination is decided by the caller