.svg)
agentInteractionStatistic
agentInteractionStatistic · Optional
Appears in
What is it?
agentInteractionStatistic records the number of times an organization or person has acted as the agent in a completed interaction on a specific platform. It uses an InteractionCounter object and specifically tracks when the organization itself initiated or performed an action, not when others acted on it. This distinguishes it from interactionStatistic, which tracks interactions performed by others toward the organization.
Why this matters for AEO
As AI systems become participants in structured data ecosystems, the ability to distinguish between interactions performed by humans and interactions performed by AI agents gains significance. agentInteractionStatistic was added to schema.org to support this distinction. For organizations publishing content at scale (news outlets, content platforms, API providers), this field can signal the volume and scope of machine-initiated activity. AI answer engines that process entity graphs benefit from knowing whether an organization's interaction volume comes from human users, automated agents, or a mix of both, since this affects how they interpret authority and reach signals.
What the specs say
Schema.org:agentInteractionStatistic expects an InteractionCounter object. The number of completed interactions for this entity, in a particular role (the agent), in a particular action (indicated in the statistic), and in a particular context (i.e. interactionService). The range includes Organization and Person. [Source: https://schema.org/agentInteractionStatistic]
Google: Not mentioned in Google's structured data documentation for Organization. [Source: https://developers.google.com/search/docs/appearance/structured-data/organization]
How to find your value
This field applies to organizations that perform tracked, countable actions on platforms, where the organization is the initiating party. Examples:
- A news organization that has published a tracked number of articles to a distribution platform
- A software company that has submitted a certain number of API calls to a partner service
- A content creator organization that has uploaded a tracked number of videos as agent
The count comes from platform analytics, API dashboards, or content management systems that record outbound activity volume.
Format and code
The structure mirrors interactionStatistic but shifts the perspective: the organization is the actor, not the recipient.
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Reuters",
"url": "https://reuters.com",
"agentInteractionStatistic": {
"@type": "InteractionCounter",
"interactionType": "https://schema.org/WriteAction",
"interactionService": {
"@type": "WebSite",
"name": "Reuters.com",
"url": "https://reuters.com"
},
"userInteractionCount": 2400000
}
}
For a software organization tracking API interactions as agent:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Twilio",
"url": "https://twilio.com",
"agentInteractionStatistic": {
"@type": "InteractionCounter",
"interactionType": "https://schema.org/SendAction",
"interactionService": {
"@type": "SoftwareApplication",
"name": "Twilio Messaging API",
"url": "https://twilio.com/messaging"
},
"userInteractionCount": 5000000000
}
}
Multiple action types as an array:
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "Associated Press",
"url": "https://apnews.com",
"agentInteractionStatistic": [
{
"@type": "InteractionCounter",
"interactionType": "https://schema.org/WriteAction",
"interactionService": {
"@type": "WebSite",
"name": "AP News",
"url": "https://apnews.com"
},
"userInteractionCount": 1800000
},
{
"@type": "InteractionCounter",
"interactionType": "https://schema.org/ShareAction",
"interactionService": {
"@type": "WebSite",
"name": "Twitter",
"url": "https://twitter.com"
},
"userInteractionCount": 950000
}
]
}
Webflow implementation
Static pages
Add the JSON-LD in Page Settings > Custom Code on your about or organization page. Update counts periodically, especially for organizations where output volume is a credibility signal.
CMS template pages
Organizations managing multiple entity pages can store agent interaction counts as CMS number fields and output them through JSON-LD embeds, with platform name and interaction type as text fields.
In Schema HQ
agentInteractionStatistic supports as a nested InteractionCounter object within the Organization schema editor. Specify the interaction type URL, service name, and count.
Real examples
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "BBC News",
"url": "https://bbc.com/news",
"agentInteractionStatistic": {
"@type": "InteractionCounter",
"interactionType": "https://schema.org/WriteAction",
"interactionService": {
"@type": "WebSite",
"name": "BBC News",
"url": "https://bbc.com/news"
},
"userInteractionCount": 3600000
}
}
Related fields
FAQ
What is the difference between agentInteractionStatistic and interactionStatistic?
agentInteractionStatistic records actions the organization performed (the organization is the agent). interactionStatistic records actions others performed toward the organization (the organization is the target). A company publishing 500,000 articles uses agentInteractionStatistic; a company with 500,000 followers uses interactionStatistic.
Does userInteractionCount apply to both human and AI-initiated actions?
Despite the property name userInteractionCount, it is the standard count field on InteractionCounter. The distinction between human and AI-initiated actions is made by choosing between interactionStatistic (human) and agentInteractionStatistic (agent role). Both use the same userInteractionCount field for the numeric value.
Which organizations benefit most from this field?
News publishers, content platforms, API providers, and any organization where outbound action volume is a meaningful credibility or scale signal. For organizations without trackable agent-role actions, this field can be omitted.
