公开的个人资料或页面
源特定的公开账户表面,而不是一个验证的真实世界的人.
- Source profile ID
- Handle and public name
- Profile URL and visible metadata
公众社会记录模式
保持稳定源物体与变化的观测和衍生标签分开,以便下游团队可以解释什么是公开的,在哪里,什么时候.
源特定的公开账户表面,而不是一个验证的真实世界的人.
公共来源的帖子,有源身份,可见的文本,发布标志和URL.
附加到特定收集时间和背景的可见指标.
源暴露的父母,答案,引用或对话关系,在批准的表面支持它.
公共媒体引用,标签和来源或衍生的主题标签保持与帖子分开.
源 ID,手柄,帖子和可见的参与仍然是平台观测.私人访问,敏感特征推断和跨平台身份结论并非含义.
覆盖合同
选择 API 或定制采集前,确认所需的数据源、页面类型、市场和字段。
记录方案
每个观察都应该包含足够的来源和收集背景来解释数量,关系或可用性状态意味着什么.
{
"record_id": "social_obs_0832",
"object_type": "post_observation",
"profile": {
"source": "twitter",
"source_profile_id": "demo_204",
"handle": "example_studio"
},
"post": {
"source_post_id": "post_demo_17",
"published_at": "YYYY-MM-DDT07:55:00Z"
},
"metrics": { "likes": 148, "reposts": 21 },
"observed_at": "YYYY-MM-DDT08:32:00Z",
"collection_state": "observed",
"schema_version": "social.v1"
}Engagement metrics are observations, not audited totals. The visible count can change, be rounded, or differ by source surface.
身份和关系
个人资料,帖子,回复和媒体引用保持其源 ID 和 URL.衍生关系仍然是单独版本的,可进行审查.
表面键
内容键
关系
观察
清新性语义
出版时间,收藏时间,交货时间,以及第一次或最后一次见面,都回答不同的问题,并且应该保持分别.
暴露时,来源所指出的时间.
个人资料,帖子或指标在请求的公共文本中可见.
快照可供客户使用.
源对象或指标状态进入或离开监测历史.
质量和缺失
保存理由声明,以便下游分析不会在来源或收集没有提供任何意义的地方发明意义.
个人资料,帖子或指标快照通过了已达成的检查.
批准的公用面积没有显示要求的价值.
需要检查一个线程,源物体或解析器状态.
限制,删除,失败或排除的状态与可见的零区别.
需要的ID,URL,类型,计量名称,时间印,收集状态和方案版本.
源特定的数量类型,关系密钥,页面状态和公共表面证据.
你的团队批准允许的来源,代表记录,保留和分析门;
交付的选择
代理
适合 · 适合已有采集程序的团队。
比较代理服务应用程序
利用以下字段和示例规划分析、产品或监测工作流。
随着源头背景,追踪已批准的主题,帖子和公开对话.
Posts · threads · hashtags面上新的公众提及和参与的快照进行审查.
Queries · posts · observed_at比较公共账户和内容信号,而不是把它们视为身份证明.
Profiles · posts · public metrics随着时间的推移,观察选择的公共内容和来源显示的参与.
Posts · media · metric snapshots建立源链接的公共机构,用于批准的主题和叙事分析.
Content · topics · provenance准备由时间,来源和收藏状态附加的公共示例.
Text · relationships · schema version代表性飞行员
使用已批准的公共个人资料,帖子,线程和查询,代表普通内容,缺失的字段,页面化,不可访问状态和重复参与的快照.
公共来源,物体,场地,随机,保留和允许使用.
代表性资料,帖子,线程,媒体,以及失踪状态.
源代码,计量时间,关系,收集状态和例外.
批准方案,公共资源集,操作模型和门.
常见问题
了解 Instagram、TikTok、YouTube、Reddit、LinkedIn 和 X 的 Data API 选项。查看各数据源页面和样本,确认所需的公开对象与字段。
范围记录模型可以包括一个公共的个人资料或页面,帖子,参与观察,媒体附件引用,线程或回复关系,以及hashtag或主题文本.源标识符和URL仍然附加,因此这些对象可以被解释而不假装每个平台都暴露相同的领域.
参与指标是观测,而不是审计的总数.可见的喜欢,回复,分享,重贴或查看数量可以在收集后改变,可能会圆,并不能代表所有平台活动.每个指标应该保留源,观察时间和可用状态.
跨平台的人类匹配不被假定.源头配置文件ID,手柄,公众名称和URL仍然是源特异性的.任何实体解决方案试点都需要达成商业目的,允许的字段,可解释的线索,明确的不确定性和独立的负责任使用审查.
公共答案或线程关系可以在被选定的文档端点或符合条件的公共表面暴露时进行评估. 覆盖深度,排序,页面化,删除状态和嵌套关系因来源而异,因此代表试点定义可用对象和现场合约.
API 在调用时采集数据。数据流和 Managed Data 遵循约定计划,并在可用时分别保留来源时间与采集时间。
样本区分缺失字段、不可用页面、失败请求和待审核数值。定期交付前,商定每种状态的处理方式。
公共社交场所.私人个人资料,私人消息,仅供用户使用的内容,身份验证的邮箱和其他受限制区域不属于标准范围.公开访问性也不消除了合法目的和适当的保留和访问控制的必要性.
标准范围不承诺个人数据的丰富,敏感特征的推断,私人联系人发现或身份验证.客户仍然负责法律基础,最小化,保留,访问控制和与任何允许的公共领域相关的决定.
使用代理时,您的团队维护采集程序;使用页面访问 API 时,维护自定义解析器。我们维护 Data API 支持的数据提取,以及数据流或 Managed Data 包含的采集工作。