How is Bibblio’s service packaged?

Bibblio is available as a Self-serve or Enterprise package.

Under Self-serve, you can choose a monthly subscription plan that's sized to suit your catalog and usage needs, starting at $19 per month. You can be up and running in minutes. You can also try Bibblio for free on a starter plan, which will allow you up to 25,000 recommendation calls per month.

The Enterprise package is for those who want to maximize Bibblio's potential by having us work with you in areas such as trial setup, implementation guidance, commercial advice, and UX best practice. In-person support channels and a service-level agreement guarantees a lasting relationship that will pay dividends. It's the whole toolbox with a team behind you!

What are 'content items'?

A content item is any article or page within your catalog that you want to provide recommendations to and from. Sets of metadata are collected for each content item, which is then stored in our Smart Graph.

What are 'recommendation calls'?

A recommendation call happens when a set of recommendations is served to your web page. This is achieved via a request to the discovery endpoint of the Bibblio API.

For Self-serve plans, is there a sign-up cost on top of my monthly fee?

No, there are no hidden costs to sign up.

Which payment methods does Bibblio support?

We accept all major debit and credit cards.


I’ve forgotten my password. How do I retrieve it?

If you have forgotten your password you will need to reset it. You can do so here.

Can I change the email address associated with my account?

Yes, you can. If you’re logged into Bibblio, just select Account and then Edit Personal Details. Your email and other details can be updated there.

There are several people in my organisation who need to use Bibblio. Can we have multiple users on one account?

Not currently, but watch this space.


Which languages does Bibblio support?

We can produce recommendations for all languages using the Latin alphabet, and we can generate in-depth semantic analysis for Dutch, English, French, German, Italian, Mandarin, Polish, Portuguese, Russian, Spanish and Swedish.

Which content formats can Bibblio enrich with metadata?

Currently Bibblio can only enrich text, but we’re working on accommodating speech and video in the near future. Get in touch if you would like to be involved in a preliminary speech or video project with us.

How do I need to format content for Bibblio’s API?

At the moment, content needs to be formatted in valid JSON to be pushed to our API, but we’re currently working on tools to help with URL scraping and pulling directly from RSS feeds.

Is there a maximum file size for content?

The maximum size for an individual item of content is currently 200 KB.

Are there any wrappers or plugins for Bibblio?

Our documentation generates basic scaffold code for each endpoint in a wide variety of languages. You can find it by switching to the console mode on an endpoint, calling the resource, clicking Code Example, then selecting your language.

If you’re on WordPress, you can get up and running immediately using our Wordpress plugin.

I'm getting a 422 error response when I try to ingest. What's going on?

A 422 is often because the payload is invalid. For example, required fields could be omitted or dates might be incorrectly formatted.

If that doesn’t seem to be the case, please get in touch.

Enrichment metadata

What is metadata?

Metadata is data about data. Bibblio’s metadata is split into structural metadata about the data container (the file), and descriptive metadata about the content itself, such as the relevant keywords in an article. Descriptive metadata is what Bibblio creates, and it serves as a factor in our recommendations.

If you want to dig a little deeper, check out the Wikipedia entry on metadata.

Are tags automatically added to my content?

Metadata is automatically added to the content items, but it won’t appear as tags on your web page or platform unless you engineer that.

Will you match the tags you produce to a taxonomy that I’ve created for my content?

In order to make the tags generally applicable, we don’t match tags to individual client taxonomies. Any filtering of Bibblio’s tags based on a pre-existing taxonomy would have to be accomplished through logic on your side.

When I call for the enrichment results from your enrichment endpoint, I get empty arrays for metadata in the response. How can I solve this?

You may not have supplied enough text to derive concepts, keywords, entities and alignments. (Generally, a few lines of text should be sufficient.) Alternatively, the text might be in a language that our enrichment endpoint does not currently support.

When I call for enrichment results, I get an "Unauthorised" response. How can I solve this?

Your access token is probably not valid anymore. We mitigate the risk of exposing user credentials by using a temporary token according to the OAuth2 Bearer Token authentication mechanism. You'll notice an expires_in field in the token response. Clients generally create an authorization wrapper that renews the access token according to the expires_in value provided by the token endpoint. Learn how to get a new token.

If you’re experiencing this problem while using a valid access token, please get in touch.

Content recommendations

What is discovery?

When we speak about discovery, we mean the process through which a user finds and interacts with content, whether that’s by traditional search, on-platform content recommendations, or in the form of a personalized newsletter.

Does Bibblio drop any third-party tracking cookies on my page?

Bibblio does not drop any cookies on the page. All user tracking is carried out from within the related content module itself, or is sent to us directly by our partners.

Do Bibblio recommendations ever include paid-for third-party content?

Bibblio’s technology can be used to recommend sponsored content, but it will only recommend content that is relevant to the article the user is currently reading.

Are Bibblio’s recommendations personalized?

Yes, our recommendations are tailored to the user they’re presented to. We integrate user session data with our in-depth content analysis approach to create a more personalized recommendation experience.

How can I add Bibblio’s pre-built recommendation modules to my content pages?

The JavaScript and CSS can be installed with Bower by running:

bower install bibblio-related-content-module

Here are further details on how to get started.

Do your modules work on mobile?

They do! Our modules are fully responsive, collapsing gracefully for display on the smallest devices.

Do I have to use your modules?

You can use the recommendations however you like, but our elegantly designed modules are ready to go and fully customisable. For most clients they make getting recommendations a lot more convenient. In addition, we also track user behaviour directly through our module.

Do you offer cross-browser support for your module integration?

We offer support across all major browsers (Chrome, Firefox, Safari etc.).

Is the module asynchronous, or does it block rendering?

The module does not block rendering. The module populates an HTML element of your choice with content. An empty <div> (or any tag) can be rendered quickly, and the module can be initiated to fill it with content at any point during page load, such as page ready. Any delay in loading the module content will not affect the rest of the page in any way.

Does Bibblio use a content delivery network for serving the assets, or would Bibblio be serving them from my server?

We store the source URL and module image URL when you add the content, so we can easily populate the module and don’t double up on server storage. When the user clicks, we simply send the user to the original content URL.

Can I organise and group my content items for discovery?

Content items can be grouped into what we call ‘catalogues,’ which means you can organise your content to ensure that certain topics and genres are only recommended on certain parts of your platform.

How do I manage different sections of my catalogue and exclude content from a particular catalogue from recommendations?

You can learn more about catalogue management here.

Can you recommend content from outside my platform?

We are in the process of enabling 'open catalogues' which means that anyone using Bibblio’s service will be able to access content from our curated open catalogues or from other Bibblio clients who open their catalogues. As a client, you will also be able to distribute your content to other users.

What sort of reporting and tracking of enrichment and recommendation does Bibblio support?

Our dashboard allows you to see how many enriched content items you have stored in Bibblio’s Smart Graph and how many recommendations have been served, both monthly and in total.


Will querying Bibblio’s service affect the latency of my platform?

The latency of recommendation delivery via our modules is below 400 milliseconds, which is often quicker than the other page elements on our clients’ platforms.

How performant is the API, both for initial data import and recommendations?

On average, you can expect recommendations to take between 150ms and 1000ms, and the response times for content item ingestions are roughly the same (from the UK).

Still haven't found what you’re looking for?

Please get in touch. We’ll get back to you as soon as we can.