Facebook Topic Data - Target Cheat Sheet

tip icon

This cheat sheet summarizes common scenarios for using targets in interaction filters and analysis queries. For use in nested queries please see the Analysis Using Nested Queries guide. The tables below do not contain full CSDL for each scenario, instead illustrative targets and pseudo code. See the examples area for full example CSDL code. You may also find the target summary page helpful. It provides a different view of the targets available.

Target usage for interaction filters

This table summarizes the appropriate targets to use in your interaction filters when filtering for stories and/or engagements.

Record stories only Record engagements only Record both
Story content fb.content fb.parent.content fb.all.content
Story media type fb.media_type fb.parent.media_type fb.media_type OR fb.parent.media_type
Author demographics fb.author.* AND fb.type == "story" fb.author.* AND fb.type != "story" fb.author.*
e.g. author country fb.author.country == "United States" AND fb.type == "story" fb.author.country == "United States" AND fb.type != "story" fb.author.country == "United States"
Topics fb.topics.* fb.parent.topics.* fb.topics.* OR fb.parent.topics.*
e.g. topic name fb.topics.category == "Automotive" fb.parent.topics.category == "Automotive" fb.topics.category == "Automotive" OR fb.parent.topics.category == "Automotive"
Link URLs links.url AND fb.type == "story" links.url AND fb.type != "story" links.url
Link titles links.title AND fb.type == "story" links.title AND fb.type != "story" links.title
Sentiment fb.sentiment fb.parent.sentiment fb.sentiment OR fb.parent.sentiment
Hashtags fb.hashtags fb.parent.hashtags fb.hashtags OR fb.parent.hashtags
Language fb.language fb.parent.language fb.language OR fb.parent.language

Target usage for analysis queries

This table summarizes the appropriate targets to use when submitting frequency distribution analysis queries.

The target stated should be used as the analysis target for your query. Some queries require query filters to be applied to make the results valid - these are stated in the table.

Analyze stories only Analyze engagements only Analyze all
Story content -- not permitted -- -- not permitted -- -- not permitted --
Story media type fb.media_type fb.parent.media_type -- not possible --
Author demographics

fb.author.*

With query filter:

fb.type == "story"

fb.author.*

With query filter:

fb.type != "story"

fb.author.*
e.g. author country

fb.author.country

With query filter:

fb.type == "story"

fb.author.country

With query filter:

fb.type != "story"

fb.author.country
Topics fb.topics.* fb.parent.topics.* -- not possible --
e.g. topic category fb.topics.category fb.parent.topics.category -- not possible --
Link URLs

links.url

With query filter:

fb.type == "story"

links.url

With query filter:

fb.type != "story"

links.url
Link titles

links.title

With query filter:

fb.type == "story"

links.title

With query filter:

fb.type != "story"

links.title
Sentiment fb.sentiment fb.parent.sentiment -- not possible --
Hashtags fb.hashtags fb.parent.hashtags -- not possible --
Language fb.language fb.parent.language -- not possible --