> ## Documentation Index
> Fetch the complete documentation index at: https://developers.explorium.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Business Website Traffic
### **Description**
The **Business Website Traffic Enrichment** provides detailed insights into a company’s online presence by surfacing **monthly web traffic metrics** sourced from SEMrush’s a leading provider of digital analytics.
For each input company (`business_id`), the enrichment resolves the associated domain and returns a set of standardized signals such as **total visits, users, traffic sources (search, social, referral, direct, paid), device breakdown (desktop vs. mobile), bounce rate, time on site, and more**.
Data is available from **January 2017** through the **start of the previous month**, and is provided in raw form directly from SEMrush.
Raw traffic data powered by :
This signal is particularly useful for:
* Evaluating **digital reach** and engagement.
* Comparing **marketing effectiveness** across companies.
* Enriching **lead profiles** with behavioral indicators..
***
* **Input:** Provide a `business_id` obtained from the **Match Businesses** API and `month_period`
* **Processing:** The system resolves the company’s domain and queries SEMrush’s `traffic_summary` API for the most recent monthly traffic metrics.
* **Output:** Standardized traffic data including sessions, users, traffic source distribution, device usage, bounce rate, and engagement metrics.
```bash theme={null}
curl -X 'POST' \
'https://api.explorium.ai/v1/businesses/website_traffic/enrich' \
-H 'accept: application/json' \
-H 'api_key: your_api_key' \
-H 'Content-Type: application/json' \
-d '{
"request_context": {},
"parameters": {
"month_period": "2025-07"
},
"business_id": "45017f6511f91be700fda3d118034994"
}'
```
```json theme={null}
{
"response_context": {
"correlation_id": "0145ef917db04b2e9361d4fb487e8290",
"request_status": "success",
"time_took_in_seconds": 1.922
},
"data": {
"business_id": "45017f6511f91be700fda3d118034994",
"accuracy": 3,
"bounced_visits": null,
"bounce_rate": 0.4779,
"channel": null,
"desktop_share": 0,
"device_type": "all",
"direct": 10684587,
"display_ad": 191877,
"mail": 12529,
"mobile_bounce_rate": 0,
"mobile_hits": 42977598,
"mobile_pages_per_visit": 3,
"mobile_share": 0,
"mobile_users": 6471880,
"mobile_visits": 12273280,
"pages_per_visit": 4,
"paid": 1247067,
"referral": 587628,
"rank": 3732,
"search": 2458353,
"search_organic": 2458353,
"social_paid": 22124,
"target": "petco.com",
"time_on_site": 380,
"unknown_channel": 0,
"users": 8329432,
"visits": 15240433,
"month_period": "2025-07"
},
"entity_id": "45017f6511f91be700fda3d118034994"
}
```
* **`Always use a validbusiness_id`** from the **Match Businesses** API.
* **`Specifymonth_period`** (YYYY-MM) when you want to retrieve metrics for a specific month.
* **Check for null values** — if SEMrush has no data for a given domain, the response will contain null fields.
* **Use rank, visits, and users together** for benchmarking against competitors.
* **Combine traffic metrics with firmographics** to build a richer business profile.
| Signal | API Name | Description | Data Type |
| ------------------------- | ---------------------- | -------------------------------------------------------------------------------------- | --------- |
| accuracy | Accuracy | Data accuracy, with values of 1, 2, or 3. 3 is the most accurate. | CATEGORY |
| bounced\_visits | Bounced Visits | The number of single-page sessions. | NUMERIC |
| bounce\_rate | Bounce Rate | The percentage of single-page sessions. | NUMERIC |
| channel | Channel | The channel type, which can be direct, referral, search, social, mail, or display\_ad. | CATEGORY |
| desktop\_share | Desktop Share | The proportion of total traffic that comes from desktops. | NUMERIC |
| device\_type | Device Type | The type of device used by the user, such as desktop or mobile. | CATEGORY |
| direct | Direct | Traffic from users typing in the URL or using bookmarks. | NUMERIC |
| display\_ad | Display Ad | Traffic from banner or display advertising. | NUMERIC |
| mail | Mail | Traffic from email campaigns. | NUMERIC |
| mobile\_bounce\_rate | Mobile Bounce Rate | The bounce rate specific to users on mobile devices. | NUMERIC |
| mobile\_hits | Mobile Hits | The number of pageviews from mobile devices. | NUMERIC |
| mobile\_pages\_per\_visit | Mobile Pages Per Visit | The number of pages viewed per session from mobile devices. | NUMERIC |
| mobile\_share | Mobile Share | The proportion of total traffic that comes from mobile devices. | NUMERIC |
| mobile\_users | Mobile Users | The number of unique users on mobile devices. | NUMERIC |
| mobile\_visits | Mobile Visits | The total number of sessions from mobile devices. | NUMERIC |
| pages\_per\_visit | Pages Per Visit | The number of pages viewed per session. | NUMERIC |
| paid | Paid | Traffic from all paid sources, including ads. | NUMERIC |
| referral | Referral | Referral traffic. | NUMERIC |
| rank | Rank | The ranking of the target based on traffic volume, where 1 is the highest traffic. | NUMERIC |
| search | Search | Total search engine traffic (organic and paid). | NUMERIC |
| search\_organic | Search Organic | Traffic from unpaid search results. | NUMERIC |
| search\_paid | Search Paid | Traffic from paid search ads. | NUMERIC |
| social | Social | Traffic from all social media sources. | NUMERIC |
| social\_organic | Social Organic | Unpaid traffic from social platforms. | NUMERIC |
| social\_paid | Social Paid | Paid traffic from social media advertising. | NUMERIC |
| target | Target | The domain being analyzed, such as example.com. | URL |
| time\_on\_site | Time On Site | The average time spent on the site per session. | NUMERIC |
| unknown\_channel | Unknown Channel | Traffic for which the source could not be determined. | NUMERIC |
| users | Users | The total number of users. | NUMERIC |
| visits | Visits | The total number of sessions. | NUMERIC |
| month\_period | Month period | Reference month for cumulative data (default: previous month) | DATETIME |
📌 *For additional enrichment options, explore related API endpoints below.*
## OpenAPI
````yaml post /v1/businesses/website_traffic/enrich
openapi: 3.1.0
info:
title: Partner Service
version: 0.2.349
servers:
- url: https://api.explorium.ai
description: AgentSource Server
security: []
paths:
/v1/businesses/website_traffic/enrich:
post:
tags:
- BusinessEnrichments
summary: Website Traffic
operationId: businesses_website_traffic_enrich
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/WebsiteTrafficEnrichRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: >-
#/components/schemas/BusinessesEnrichResponse_WebsiteTrafficOutputSchema_
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- APIKeyHeader: []
components:
schemas:
WebsiteTrafficEnrichRequest:
properties:
request_context:
type: object
title: Request Context
example: null
nullable: true
parameters:
$ref: '#/components/schemas/WebsiteTrafficEnrichmentParams'
business_id:
type: string
pattern: ^[a-f0-9]{32}$
title: Business Id
additionalProperties: false
type: object
required:
- business_id
title: WebsiteTrafficEnrichRequest
BusinessesEnrichResponse_WebsiteTrafficOutputSchema_:
properties:
response_context:
$ref: '#/components/schemas/ResponseContext'
data:
anyOf:
- $ref: '#/components/schemas/WebsiteTrafficOutputSchema'
- items:
$ref: '#/components/schemas/WebsiteTrafficOutputSchema'
type: array
title: Data
entity_id:
anyOf:
- type: string
pattern: ^[a-f0-9]{32}$
- type: string
pattern: ^[a-f0-9]{40}$
title: Entity Id
type: object
required:
- response_context
title: BusinessesEnrichResponse[WebsiteTrafficOutputSchema]
description: 'This is base response model for all responses in partner service. '
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
WebsiteTrafficEnrichmentParams:
properties:
month_period:
type: string
title: Month Period
description: The month period of the website. YYYY-MM
additionalProperties: false
type: object
required:
- month_period
title: WebsiteTrafficEnrichmentParams
ResponseContext:
properties:
correlation_id:
type: string
title: Correlation Id
request_status:
$ref: '#/components/schemas/RequestStatus'
time_took_in_seconds:
type: number
title: Time Took In Seconds
type: object
required:
- correlation_id
- request_status
- time_took_in_seconds
title: ResponseContext
WebsiteTrafficOutputSchema:
properties:
business_id:
type: string
pattern: ^[a-f0-9]{32}$
title: Business Id
accuracy:
type: integer
title: Accuracy
bounced_visits:
type: integer
title: Bounced Visits
bounce_rate:
type: number
title: Bounce Rate
channel:
type: string
title: Channel
desktop_share:
type: integer
title: Desktop Share
device_type:
type: string
title: Device Type
direct:
type: integer
title: Direct
display_ad:
type: integer
title: Display Ad
mail:
type: integer
title: Mail
mobile_bounce_rate:
type: integer
title: Mobile Bounce Rate
mobile_hits:
type: integer
title: Mobile Hits
mobile_pages_per_visit:
type: integer
title: Mobile Pages Per Visit
mobile_share:
type: integer
title: Mobile Share
mobile_users:
type: integer
title: Mobile Users
mobile_visits:
type: integer
title: Mobile Visits
pages_per_visit:
type: integer
title: Pages Per Visit
paid:
type: integer
title: Paid
referral:
type: integer
title: Referral
rank:
type: integer
title: Rank
search:
type: integer
title: Search
search_organic:
type: integer
title: Search Organic
social_paid:
type: integer
title: Social Paid
target:
type: string
title: Target
time_on_site:
type: integer
title: Time On Site
unknown_channel:
type: integer
title: Unknown Channel
users:
type: integer
title: Users
visits:
type: integer
title: Visits
month_period:
type: string
title: Month Period
type: object
title: WebsiteTrafficOutputSchema
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
RequestStatus:
type: string
enum:
- success
- miss
- failure
title: RequestStatus
description: >-
The `RequestStatus` class is an enumeration that defines the possible
statuses of a request.
This enum is used to indicate whether a request was successful, missed,
or failed. It ensures
consistent handling of request statuses across the application.
Attributes:
SUCCESS: Indicates that the request was successfully processed.
MISS: Indicates that the request did not find any matching data.
FAILURE: Indicates that the request encountered an error or failure.
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: api_key
````