Using Primal’s Content Service

Getting Started

Our content.primal.com service is the simplest way to get the right content from Primal that reflects your unique perspective and interests. Just follow these simple steps to get started.

Account Setup

Log in to your Primal account, or create one if you do not already have one.

Documentation

While Primal’s content service is designed with absolute simplicity in mind, there are some powerful advanced features available to tune the experience to your individual needs.

Get an overview of your content

To get an overview of content, simply use the root-level URL, https://content.primal.com/. The default response format of this call is RSS 2.0, which can be used in any RSS reader, CMS or application that recognizes the RSS format.

GET https://content.primal.com/?{params}
Required
Name Value
Basic Auth The content service requires you to log into your Primal account.Programmatic users, use Basic Auth to authenticate.
Optional Parameters
Name Value
primal:contentCount:max Limits the total number of items returned. Must be a valid non-zero integer.
primal:contentScore:min Ensure all the results meet a minimum content score. The score is a ratio expressed between 0.0 and 1.0 (e.g. 0.6).Note: You cannot provide both a primal:contentScore:min and aprimal:contentScore:max parameter in the same request.
primal:contentScore:max Ensure all the results do not exceed a maximum content score. The score is a ratio expressed between 0.0 to 1.0 (e.g. 0.3).Note: You cannot provide both a primal:contentScore:min and aprimal:contentScore:max parameter in the same request.
dc:memberOf A filter to restrict the type of content returned based on the content source. Only content who’s dc:memberOf value exactly matches the value of this parameter will be returned (e.g. ‘primal/News’ for news, ‘user/Technology’ for a custom defined set of Technology content sources)

Adding new topics and targeting specific topics

To add a new topic of interest or to target your content to specific topics of interest, specify a topic in the URL. Primal will include this topic in your interest graph and use it to filter the content recommendations.

GET https://content.primal.com/{topics}?{params}
Required Parameters
Name Value
topics One or more topics of interest. For example:/technology/mobile
/health/crossfit;diet
/nhl/trade;draft;prospectSlashes are interpreted as AND; semi-colons are interpreted as OR.

For detailed instructions on how to specify topics of interest, seeTutorial: Building Topic URLs.

Optional Parameters
Name Value
primal:contentCount:max Limits the total number of items returned. Must be a valid non-zero integer.
primal:contentScore:min Ensure all the results meet a minimum content score. The score is a ratio expressed between 0.0 and 1.0 (e.g. 0.6).Note: You cannot provide both a primal:contentScore:min and aprimal:contentScore:max parameter in the same request.
primal:contentScore:max Ensure all the results do not exceed a maximum content score. The score is a ratio expressed between 0.0 to 1.0 (e.g. 0.3).Note: You cannot provide both a primal:contentScore:min and aprimal:contentScore:max parameter in the same request.
dc:memberOf A filter to restrict the type of content returned based on the content source. Only content who’s dc:memberOf value exactly matches the value of this parameter will be returned (e.g. ‘primal/News’ for news, ‘user/Technology’ for a custom defined set of Technology content sources)

Share access to your content

Primal uses a special URL parameter, called a LID value, to provide open access to your content. If you share a link with this LID value, anyone that uses the link can access your content.

GET https://content.primal.com/?lid={lid}
Required Parameters
Name Value
lid The lid param provides read-only access to the content feed.Your LID value can be found in the <channel><link> element within your RSS feed.

Getting your feed in different data formats

A file extension may be used to specify the data format for your feed.

GET https://content.primal.com/{file-extension}
Required Parameters
Name Value
file-extension For JSON, use “.json”For example:

https://content.primal.com/.json?lid={lid}

OR

https://content.primal.com/{topic}.json?lid={lid}

For RSS, use “.rss”

If the file extension is omitted, then RSS is used as the default data format.

Using the learning links

Primal learns your interests through special “learning links” that are embedded within each content item. If someone clicks on one of these links, the interest graph will change and become more tailored to these interests.

If using RSS, the learning links are found within the <item><link> element.

If using JSON, the learning links are found within the dc:identifier element.

Note that Primal will include the LID value to allow any individual to click through the links and be redirected to the content items.

GET https://content.primal.com/~learn …