Synthesio: Most-used fields#
The table below gives information about most-used fields that you can import from Synthesio. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
author_demographics_affinity_list |
author_demographics_affinity_list |
A list of interests or groups the author identifies with. |
dimension |
author_demographics_age |
author_demographics_age |
The age range of the author. |
dimension |
author_demographics_bio_tag_list |
author_demographics_bio_tag_list |
A list of tags extracted from the author’s biography, indicating their stated interests or characteristics. |
dimension |
author_demographics_family_status |
author_demographics_family_status |
The family status of the author. |
dimension |
author_demographics_gender |
author_demographics_gender |
The gender of the author. |
dimension |
author_demographics_job_list |
author_demographics_job_list |
A list of job titles or industries associated with the author. |
dimension |
author_demographics_language_list |
author_demographics_language_list |
A list of languages spoken or used by the author. |
dimension |
author_demographics_marital_status |
author_demographics_marital_status |
The marital status of the author. |
dimension |
author_extra_properties_content |
author_extra_properties_content |
Additional content-related properties or attributes pertaining to the author of a social mention or piece of content. This field is part of the extensive metadata available through the Mentions endpoint. |
dimension |
author_extra_properties_excerpt |
author_extra_properties_excerpt |
An excerpt from the author’s profile or content, found within their extra properties. |
dimension |
author_extra_properties_gnip_compliance_status |
author_extra_properties_gnip_compliance_status |
The GNIP compliance status of the author’s social media account, indicating if the account is deleted or protected. |
dimension |
author_extra_properties_restricted_usage |
author_extra_properties_restricted_usage |
Indicates if the author’s extra properties have copyright restrictions preventing their full provision by the API. |
dimension |
author_extra_properties_title |
author_extra_properties_title |
Additional title-related properties or attributes associated with the author of a social mention or piece of content. This field is part of the extensive metadata available through the Mentions endpoint. |
dimension |
author_full_name |
author_full_name |
The full name of the author. |
dimension |
author_id |
author_id |
The unique Synthesio identifier for the author. |
dimension |
author_location_city |
author_location_city |
The city associated with the author’s location. |
dimension |
author_location_country |
author_location_country |
The country associated with the author’s location. |
dimension |
author_location_county |
author_location_county |
The county of the author’s specified location. |
dimension |
author_location_latitude |
author_location_latitude |
The detected latitude coordinate of the author’s location. |
dimension |
author_location_longitude |
author_location_longitude |
The detected longitude coordinate of the author’s location. |
dimension |
author_location_state |
author_location_state |
The state or region associated with the author’s location. |
dimension |
author_metric_list |
author_metric_list |
A list of metrics associated with the author, such as follower count or engagement rates. |
metric |
author_name |
author_name |
The displayed name or username of the author. |
dimension |
author_native_id |
author_native_id |
The unique identifier for the author on the original social media platform. |
dimension |
author_picture_url |
author_picture_url |
The URL to the author’s profile picture or avatar. |
dimension |
author_site_id |
author_site_id |
A unique identifier for the site or platform where the author is active. |
dimension |
author_site_name |
author_site_name |
The name of the site or platform where the author is active. |
dimension |
author_type |
author_type |
The classification or type of the author (e.g., influencer, brand). |
dimension |
author_url |
author_url |
The URL to the author’s profile page on the platform. |
dimension |
author_username |
author_username |
The username or handle of the author on the social media platform. |
dimension |
channel |
channel |
The specific social media platform or online source where the mention or content originated (e.g., Twitter, Facebook, blogs). This is a common attribute for classifying social listening data. |
dimension |
classifier_tags |
classifier_tags |
Tags assigned by classifiers to categorize content, based on configured rules or machine learning models. |
dimension |
classifiers |
classifiers |
Categorization applied to content, often through machine learning or predefined rules. |
dimension |
collaboration_status |
collaboration_status |
The current status of collaboration activities related to a mention or report. |
dimension |
collaboration_user |
collaboration_user |
The user associated with collaboration activities for a mention or report. |
dimension |
content |
content |
The full textual content of a social media mention, article, or other collected online conversation. This is a core data point retrieved via the Mentions endpoint. |
dimension |
copyright |
copyright |
Copyright information associated with the data or content. |
dimension |
crawled_at |
crawled_at |
Timestamp indicating when the data was collected or crawled from its source. |
dimension |
dashboard_id |
dashboard_id |
The unique identifier for the Synthesio dashboard to which the report belongs. |
dimension |
dashboard_name |
dashboard_name |
The name of the dashboard. |
dimension |
date |
date |
The date and time when the social mention or content was published or collected. This field is frequently used for filtering and time-based analysis in various reports, including Mentions, Analytics, and Reach. |
dimension |
demographics_affinity_list |
demographics_affinity_list |
A list of inferred affinities or interests associated with the demographics of the author or audience. |
dimension |
demographics_age |
demographics_age |
Inferred age information related to the demographics of the author or audience. |
dimension |
demographics_bio_tag_list |
demographics_bio_tag_list |
A list of biographical tags or keywords associated with the author’s profile or demographic information. |
dimension |
demographics_family_status |
demographics_family_status |
Inferred family status information related to the demographics of the author or audience. |
dimension |
demographics_gender |
demographics_gender |
Inferred gender information related to the demographics of the author or audience. |
dimension |
demographics_job_list |
demographics_job_list |
A list of inferred job-related information for the demographics of the author or audience. |
dimension |
demographics_language_list |
demographics_language_list |
A list of estimated languages spoken or used by the author, associated with their demographics. |
dimension |
demographics_marital_status |
demographics_marital_status |
Inferred marital status information related to the demographics of the author or audience. |
dimension |
extra_properties_content |
extra_properties_content |
Additional content-related properties for the main entity, which can contain any valid JSON value including complex data structures. |
dimension |
extra_properties_excerpt |
extra_properties_excerpt |
Additional excerpt-related properties for the main entity, which can contain any valid JSON value including complex data structures. |
dimension |
extra_properties_gnip_compliance_status |
extra_properties_gnip_compliance_status |
Additional properties related to the compliance status of data obtained from specific sources, such as historical Twitter data which was often processed via Gnip. This ensures adherence to data usage agreements. |
dimension |
extra_properties_restricted_usage |
extra_properties_restricted_usage |
Additional properties indicating specific usage restrictions or licensing terms for the collected data, often related to data privacy or platform-specific agreements. |
dimension |
extra_properties_title |
extra_properties_title |
Additional title-related properties for the main entity, which can contain any valid JSON value including complex data structures. |
dimension |
human_review_status |
human_review_status |
The current status of human review for the collected data. |
dimension |
id |
id |
A unique identifier for the specific resource object. |
dimension |
influence |
influence |
A metric representing the impact or reach of a social mention or its author. This data is typically found in Mentions or Reach reports, helping to identify key voices and content amplification. |
metric |
infused_at |
infused_at |
The date and time when the data was infused or processed into the Synthesio system. |
dimension |
interactions |
interactions |
The engagement metrics associated with a social mention, such as likes, shares, comments, or retweets. This data is available through the Mentions endpoint. |
dimension |
language |
language |
The detected language of the content. |
dimension |
license |
license |
Information pertaining to the licensing agreements governing the use and distribution of the collected social data, often indicating specific rights or restrictions. |
dimension |
location_city |
location_city |
The specific city from which a social mention originated or was associated with, providing geographical context for audience insights. |
dimension |
location_country |
location_country |
The country associated with the content or its author. |
dimension |
location_county |
location_county |
The county from which a social mention originated or was associated with, offering a more granular geographical insight than city or state. |
dimension |
location_latitude |
location_latitude |
The geographical latitude coordinate associated with the origin of a social mention, allowing for precise location mapping. |
dimension |
location_longitude |
location_longitude |
The geographical longitude coordinate associated with the origin of a social mention, allowing for precise location mapping. |
dimension |
location_state |
location_state |
The state or administrative region from which a social mention originated or was associated with, providing geographical context. |
dimension |
meta_attachment_list |
meta_attachment_list |
A list of metadata about attachments (e.g., images, videos) included in a social mention or content. This is typically part of the rich media information associated with mentions. |
dimension |
meta_emoji_list |
meta_emoji_list |
A list of emojis used within the content of a social mention, providing insights into emotional sentiment and communication style. |
dimension |
meta_hashtag_list |
meta_hashtag_list |
A list of hashtags used within a social mention or content, indicating key themes, topics, and trending discussions. |
dimension |
meta_token_list |
meta_token_list |
A list of linguistic tokens (e.g., words, phrases) extracted from the content for analysis. |
dimension |
meta_url_list |
meta_url_list |
A list of URLs included in a social mention or content, indicating external links shared or referenced within the discussion. |
dimension |
metric_list |
metric_list |
A collection of quantitative measurements or key performance indicators associated with social data, such as sentiment scores, reach, or interaction counts. This is central to the Insights API and Analytics/Reach reports. |
metric |
native_id |
native_id |
The unique identifier of the user or entity on the original social network or platform (e.g., Twitter, Facebook ID). |
dimension |
parent_id |
parent_id |
The unique identifier of a parent social mention or post, indicating a hierarchical relationship (e.g., a reply to a tweet, a comment on a post). |
dimension |
report_field |
report_field |
The field used for aggregation in an Analytics report, such as sentiment or geographical location. |
dimension |
report_id |
report_id |
The unique identifier of the report that the data belongs to. |
dimension |
report_period |
report_period |
The time period (e.g., start and end dates) for which the report data was fetched. |
dimension |
review |
review |
The content of a user review or rating, often reflecting sentiment and opinion about a product, service, or brand. Synthesio analyzes consumer sentiment. |
dimension |
sentiment |
sentiment |
The detected emotional tone or sentiment (e.g., positive, negative, neutral) of the content. |
dimension |
site_communities_list_id |
site_communities_list_id |
A list of unique identifiers for communities associated with the site. |
dimension |
site_id |
site_id |
The unique identifier for the social media platform or website where a mention originated. This helps distinguish different data sources. |
dimension |
site_logo |
site_logo |
The URL or identifier for the logo of the source site. |
dimension |
site_name |
site_name |
The human-readable name of the social media platform or website where a mention originated (e.g., ‘Twitter’, ‘Facebook’, ‘Blog’). |
dimension |
site_synthesio_rank |
site_synthesio_rank |
The Synthesio ranking of the site’s influence or relevance. |
dimension |
site_type_id |
site_type_id |
The unique identifier for the category or type of the site. |
dimension |
site_type_name |
site_type_name |
The name of the category or type of the site. |
dimension |
site_url |
site_url |
The base URL of the social media platform or website where a mention originated, providing direct access to the source. |
dimension |
source_demographics_affinity_list |
source_demographics_affinity_list |
A list of affinities or interests associated with the demographics of the source (e.g., publication, news outlet). |
dimension |
source_demographics_age |
source_demographics_age |
Inferred age information related to the demographics of the content’s source or publisher. |
dimension |
source_demographics_bio_tag_list |
source_demographics_bio_tag_list |
A list of tags extracted from the source’s biography. |
dimension |
source_demographics_family_status |
source_demographics_family_status |
Inferred family status information related to the demographics of the content’s source or publisher. |
dimension |
source_demographics_gender |
source_demographics_gender |
Inferred gender information related to the demographics of the content’s source or publisher. |
dimension |
source_demographics_job_list |
source_demographics_job_list |
A list of inferred job-related information for the demographics of the content’s source or publisher. |
dimension |
source_demographics_language_list |
source_demographics_language_list |
A list of inferred languages associated with the demographics of the content’s source or publisher. |
dimension |
source_demographics_marital_status |
source_demographics_marital_status |
Inferred marital status information related to the demographics of the content’s source or publisher. |
dimension |
source_extra_properties_content |
source_extra_properties_content |
Additional content-related properties for the data source, which can contain any valid JSON value including complex data structures. |
dimension |
source_extra_properties_excerpt |
source_extra_properties_excerpt |
Additional excerpt-related properties for the data source, which can contain any valid JSON value including complex data structures. |
dimension |
source_extra_properties_gnip_compliance_status |
source_extra_properties_gnip_compliance_status |
Compliance status from GNIP for the source (author), indicating if the author’s Twitter account has been deleted or protected. |
dimension |
source_extra_properties_restricted_usage |
source_extra_properties_restricted_usage |
Indicates if the source’s extra properties have copyright restrictions preventing their full provision by the API. |
dimension |
source_extra_properties_title |
source_extra_properties_title |
Additional title-related properties for the data source, which can contain any valid JSON value including complex data structures. |
dimension |
source_full_name |
source_full_name |
The full name of the source or publisher of the content. |
dimension |
source_id |
source_id |
A unique identifier for the specific data source or publisher. |
dimension |
source_keywords |
source_keywords |
Keywords used to filter or categorize social media data within reports. |
dimension |
source_location_city |
source_location_city |
The city associated with the source’s geographical location. |
dimension |
source_location_country |
source_location_country |
The country associated with the source’s geographical location. |
dimension |
source_location_county |
source_location_county |
The county associated with the source’s geographical location. |
dimension |
source_location_latitude |
source_location_latitude |
The detected latitude coordinate of the source’s location. |
dimension |
source_location_longitude |
source_location_longitude |
The detected longitude coordinate of the source’s location. |
dimension |
source_location_state |
source_location_state |
The state or province associated with the source’s geographical location. |
dimension |
source_native_id |
source_native_id |
The unique identifier for the source on the original social media platform. |
dimension |
source_picture_url |
source_picture_url |
The URL to the source’s profile picture or logo. |
dimension |
source_site_id |
source_site_id |
The unique identifier for the site associated with the source. |
dimension |
source_site_name |
source_site_name |
The name of the site associated with the source. |
dimension |
source_type |
source_type |
The classification or type of the source (e.g., news, blog, forum). |
dimension |
source_url |
source_url |
The URL to the source’s profile or main page. |
dimension |
synthesio_rank |
synthesio_rank |
A proprietary ranking or scoring metric calculated by Synthesio, indicating importance or influence. |
dimension |
tags |
tags |
Keywords or labels applied to a social mention or content for categorization, organization, and easier retrieval of related data. |
dimension |
title |
title |
The title of an article, blog post, or other piece of content that constitutes a social mention. This is typically part of the content pulled down via the Mentions endpoint. |
dimension |
topic_name |
topic_name |
The name of a specific topic or theme associated with social mentions. This field is enriched for mentions from the /topic/v1/reports/{report_id} endpoint and is a basis for Reach reports. |
dimension |
Indicates if a social mention originated from the Twitter platform or contains Twitter-specific metadata. It can also refer to Twitter-specific engagement metrics. |
dimension |
||
type |
type |
The categorization of the content, such as ‘tweet’, ‘blog post’, ‘forum comment’, or ‘news article’. |
dimension |
url |
url |
The direct URL to the original social mention or content on its source platform, allowing users to view the original post. |
dimension |