Как стать счастливее и уверенно идти к своим целям? Все ответы — в книге «Сам себе государство. Как совершить революцию в жизни». Подпишитесь на рассылку, чтобы не пропустить предзаказ FBIQ RSS Access - Marketing API - Documentation - Facebook for Developers

FBIQ RSS Access

Overview

The Facebook IQ (FBIQ) Really Simple Syndication (RSS) is a read-only API that allows programatic access to the FBIQ toolset. Our front-end FBIQ systems offer simple searching of general market insights and trends, success stories on how our products are used, and blogs and articles highlighting various other marketing information. We opened up this repository of information that can be consumed in an XML format.

Learn more about RSS.

RSS Accessible FBIQ Endpoints

Our front end systems provide 4 types of tool-sets that offer different categories of searchable market and industry information: Success Stories, Holiday Insights, Articles/Blogs, and Insights To Go. We parallel the same functionality that the front end offers through programmatic access. The chart below demonstrates the front-end accessible info and the corresponding programmatically accessible endpoints.


Parameters

There are 3 types of requests that can be made; they are distinct from one another and only one parameter should be used at a time.

List Available Tags

FieldDescription

list_available_tags

Type: boolean

Set to true to get an XML-formatted response of all tags available, grouped by category.

Example Request: See link.

Example Response (partial): Each item returned has a description. This description is the category to which all the tags underneath it belong. The tags are encompassed by the content:encoded tag.

<rss xmlns:content="http://purl.org/rss/1.0/modules/content/" version="2.0">
<channel>
<item>
<description>Region</description>
<content:encoded>global</content:encoded>
<content:encoded>north-america</content:encoded>
<content:encoded>united-states</content:encoded>
<content:encoded>canada</content:encoded>
<content:encoded>europe-middle-east-africa</content:encoded>
<content:encoded>united-kingdom</content:encoded>
<content:encoded>france</content:encoded>
<content:encoded>germany</content:encoded>
<content:encoded>italy</content:encoded>
<content:encoded>poland</content:encoded>
<content:encoded>nigeria</content:encoded>
<content:encoded>middle-east</content:encoded>
<content:encoded>latin-america</content:encoded>
<content:encoded>argentina</content:encoded>
<content:encoded>brazil</content:encoded>
<content:encoded>mexico</content:encoded>
<content:encoded>asia-pacific</content:encoded>
<content:encoded>australia</content:encoded>
<content:encoded>hong-kong</content:encoded>
<content:encoded>india</content:encoded>
<content:encoded>indonesia</content:encoded>
<content:encoded>japan</content:encoded>
<content:encoded>malaysia</content:encoded>
<content:encoded>philippines</content:encoded>
<content:encoded>south-korea</content:encoded>
<content:encoded>thailand</content:encoded>
<content:encoded>vietnam</content:encoded>
</item>
<item>...</item>
<item>...</item>
<item>...</item>
<item>...</item>
<item>...</item>
<item>...</item>
</channel>
</rss>

Search Available Tags

FieldDescription

tags

Type: string array

Search using any combination of available tags.

Example Request: See link.

Example Response (partial): Each item is a distinct article/insight/success story with a title and link to a detailed view of that FBIQ item.

<rss xmlns:content="http://purl.org/rss/1.0/modules/content/" version="2.0">
<channel>
<item>
<title>3 Global Trends Impacting the Gaming Industry</title>
<link>
https://www.facebook.com/business/news/insights/3-global-trends-impacting-the-gaming-industry?tags%5B0%5D=audiences&tags%5B1%5D=north-america
</link>
</item>
<item>
<title>
Becoming a Mainstay in Consumers’ Streaming Portfolios
</title>
<link>
https://www.facebook.com/business/news/insights/becoming-a-mainstay-in-consumers-streaming-portfolios?tags%5B0%5D=audiences&tags%5B1%5D=north-america
</link>
</item>
<item>...</item>
<item>...</item>
<item>...</item>
<item>...</item>
<item>...</item>
<item>...</item>
<item>...</item>
<item>...</item>
<item>...</item>
<item>...</item>
</channel>
</rss>

Search Custom Query

FieldDescription

q

Type: string

Search using any custom query string.

Example Request: See link.

Example Response: Same composition as the return from the search by tag.

<rss xmlns:content="http://purl.org/rss/1.0/modules/content/" version="2.0">
<channel>
<item>
<title>
The Changing Profile of Sports Fans Around The World
</title>
<link>
https://www.facebook.com/business/news/insights/the-changing-profile-of-sports-fans-around-the-world?q=nba+basketball
</link>
</item>
<item>
<title>3 Things Marketers Need to Know About AR and VR</title>
<link>
https://www.facebook.com/business/news/insights/3-things-marketers-need-to-know-about-ar-and-vr?q=nba+basketball
</link>
</item>
<item>
<title>Why New Parents Turn to a Virtual Village</title>
<link>
https://www.facebook.com/business/news/insights/why-new-parents-turn-to-a-virtual-village?q=nba+basketball
</link>
</item>
<item>
<title>Score During the Big Tournament</title>
<link>
https://www.facebook.com/business/news/insights/score-during-the-big-tournament?q=nba+basketball
</link>
</item>
<item>
<title>Topics to Watch in the United States for May 2016</title>
<link>
https://www.facebook.com/business/news/insights/topics-to-watch-united-states-2016-05?q=nba+basketball
</link>
</item>
</channel>
</rss>