Synthesio: Most-used fields

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

twitter

twitter

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