About Algorithmia Recommends

Algorithmia Recommends generates related content recommendations to delight your audience, and increase your pageviews by highlighting relevant content from your site to your readers.

Fast, secure, and optimized for all devices. The design is 100% customizable. And, best of all, there are no ads, and no third-party content. Ever.

How To Get Started

HTML Installation:

  1. Copy the three-line JavaScript snippet below
  2. Paste the code snippet into your blog’s template where you want the recommendations to appear
<div class="algorithmia-recommends"></div>
<link rel="stylesheet" href="//algorithmia.com/assets/stylesheets/recommends.css">
<script src="//algorithmia.com/assets/javascripts/algorithmia-recommends.js" data-apikey="simQPQE2X9F8ELPdSqzwA0Iva/F1" data-include-if="2f7f621a-503d-4333-e7fd-ef32b34ea152" data-timelimit-months=24></script>
  1. Paste the code snippet into your blog’s post template on pages you want to be included in recommendations
<div data-include="2f7f621a-503d-4333-e7fd-ef32b34ea152"></div>

That's it. You're good to go.

Every time somebody visits your site, Algorithmia Recommends will find compelling, related content from your blog to recommend to your visitors.

WordPress Installation:

  1. Visit the Algorithmia WordPress Plugin and download the plugin.
  2. Unzip and upload the folder to your /wp-content/plugins/ directory. There should now be a /wp-content/plugins/algorithmia folder with the algorithmia.php file inside.
  3. Activate the plugin through the 'Plugins' menu in WordPress.
  4. Visit the Widgets page and place the Content Recommendation widget wherever you like (i.e. below the post). You can also give the widget a title so it says "Related Articles" or "Related Recipes" above the links.
  5. Finally, configure the widget to use the Algorithmia API key simQPQE2X9F8ELPdSqzwA0Iva/F1.

Drupal Installation:

  1. Go to admin/modules/install
  2. Use URL of current release of the Algorithmia Drupal Module (example http://ftp.drupal.org/files/projects/algorithmia-7.x-1.0.tar.gz )
  3. Enable Algorithmia module at admin/modules
  4. Go to admin/config/system/algorithmia and insert the Algorithmia API key simQPQE2X9F8ELPdSqzwA0Iva/F1.
  5. Configure the Drupal block to determine where recommendations will be displayed.
  6. Go to admin/structure/block/manage/algorithmia/algorithmia_recommender/configure
  7. Select the active theme and configure the standard Drupal block settings. The configuration below enables the block on certain content types, but you can use any of the Drupal block settings to define include/exclude of particular pages, visibility by role, and so on. You may also configure a block title (default value is "Recommended Content").
  8. Go to admin/structure/block if you would like to select the region where the block will display in your theme.
  9. Verify block display by visiting a page which has the block enabled.

Interactive Demo

This is an example of Algorithmia Recommends. Starting from a given page, we list recommendations for the selected url. Clicking on any of the recommendations will select a new url, and recalculate recommendations for the selected link.

Example Article
Article Recommendations

Customize How Algorithmia Recommends Looks

Recommendations are added to your webpage using standard HTML markup that can be styled using CSS to match your site. Algorithmia Recommends comes with some default styles in recommends.css to get you started. Every recommendation contains the URL, title, and summary by default. Images are included if they’re included in your site's metadata.

<div class="algorithmia-recommends">
    <li class="algorithmia-recommends-link">
      <a href="http://example.com/foo">
        <img class="algorithmia-recommends-thumbnail" src="http://example.com/foo.jpg">

      <div class="algorithmia-recommends-text">
        <a href="http://example.com/foo">
          Foo - Example.com
        <div class="algorithmia-recommends-summary">
          This is a summary of the page foo on domain example.com
    <li class="algorithmia-recommends-link">
      <a href="http://example.com/bar">
        <img class="algorithmia-recommends-thumbnail" src="http://example.com/bar.jpg">
      <div class="algorithmia-recommends-text">
        <a href="http://example.com/bar">
          /bar - Example.com
        <div class="algorithmia-recommends-summary">
          This is a summary of another page bar on domain example.com

  <div class="algorithmia-recommends-error">
    Error getting recommendations...

How does it work?

The first time the JavaScript snippet is triggered, a request to the Algorithmia API is made, asking for links to all the blog posts on your domain that contain this snippet. We generate recommendations using a web crawler that generates a sitemap, and creates a list of relevant keywords for each post. This one-time process can take 1-2 minutes to complete. After that, recommendations will be lightning fast.

Only pages with this code snippet will be included in the recommendations, making it easy to exclude landing pages, like your homepage, about page, and terms of service pages. Specifically, recommended pages are filtered to only include pages containing the data-uuid attribute. This attribute can be any unique string such as data-uuid="731509d0bcfa45c6b5927145s341e".

You may also impose a freshness constraint on recommendations, by changing the data-timelimit-months attribute in the code snippet. This an optional integer value that dictates the number of months in the past that will be considered for a given page - i.e. if the value is 24 then all pages older than 24-months will be excluded from the pool of possible recommendations. Set the attribute to -1 (or remove it) to allow all pages from any time to be considered for recommendation.