Appearance Queries can further be divided into two categories:
Channel Appearances (Require lookup by )
Content Appearances (Require lookup by content ID)
Channel Appearances
Channel Appearances identify how the company and related content were accessed on a particular channel (such as Website, Print and Newsletter). Channel Appearances are queried using the and a date range using the format of { start: "YYYY-MM", end: "YYYY-MM" }. It will return the following data for each:
Website Channel Appearances
Includes content metadata and website metrics -- notably the following:
Views: The number of times the company was viewed, including the profile page and related content.
Users : The total number of users that viewed the company (and related content).
Rows: A breakout of the above data by each distinct content item.
Example query
GraphQL query
query {
websiteAppearances(input: {
companyHash: "COMPANY_HASH_GOES_HERE",
monthRange: { start: "2022-01", end: "2022-12" }
}) {
views
users
rows {
views
uniqueUsers
content {
id
name
type
published
primarySite {
id
name
title
shortName
host
}
}
}
}
}
printAppearances(input: {
companyHash: "585a7978a7bc179300e6b483a107753c",
monthRange: { start: "2022-01", end: "2022-12" }
}) {
content {
id
type
published
}
issues {
id
name
mailed
publication {
id
name
}
}
}
}
Includes content and newsletter deployment metadata.
Example query
// Some code
// Some code
Content Appearances
Content Appearances identify where the individual content item appeared in the channel. Like Channel Appearances, this query identifies where the content item appeared within a channel, and supports a date range using the same format as above.
Content Website Appearances
The contentWebsiteAppearances query returns website section metadata for each location where the content was scheduled.
Example query
GraphQL query
query {
contentWebsiteAppearances(input: {
contentId: 12345678
monthRange: { start: "2022-01", end: "2022-12" }
}) {
content {
id
type
published
}
sections {
id
name
}
}
}
The contentPrintAppearances query returns magazine issue metadata for each location where the content was scheduled.
Example query
// Some code
// Some code
Content Newsletter Appearances
The contentNewsletterAppearances query returns newsletter deployment metadata for each location where the content was scheduled.
Example query
GraphQL query
newsletterAppearances(input: {
companyHash: "585a7978a7bc179300e6b483a107753c",
monthRange: { start: "2022-01", end: "2022-12" }
}) {
content {
id
type
published
}
deployments {
id
day
newsletter {
id
name
}
}
}