Content Feed API - Developer Tools - Shareaholic
API Designed for Ease Anchor
We have optimized for ease of implementation. All API methods are accessible via simple HTTP calls. Most implementations of this API take less than 15 minutes to setup. Simply call the provided URLs with their respective parameters, and you're done.
Getting Started: Authentication Anchor
All API endpoints require API authentication credentials to be supplied as query arguments (apikey). To get started, you'll need a free Shareaholic account and Site ID. Signup for an account and then add your site to get your Site ID. The Site ID is your API Key.
Example:
...&api_key=8943b7fd64cd8b1770ff5affa9a9437b&...
Note: the apikey used in this document is intended for use as an example only. It is subject to change.
Parameters Anchor
Endpoint:https://recs.shareaholic.com/rec/
| Parameter | Description | Required | Example |
|---|---|---|---|
api_key |
API Key | Required | apikey=8943b7fd64cd8b1770ff5affa9a9437b |
location |
URL for which to return recommended content for | Required | location=https://example.com |
internal |
Number of internal results to return in the response. The actual amount returned may be less than requested. | required | internal=3 |
sponsored |
Number of sponsored results to return in the response. The actual amount returned may be less than requested. Results may include content from other websites that are personalized to the visitor. | Optional | sponsored=0 |
canonical |
Canonical URL of the page to return recommended content for | Optional | canonical=https://example.com |
Working Example:
https://recs.shareaholic.com/rec/?location=https%3A%2F%2Fwww.shareaholic.com%2Fblog%2Fquick-qr-code-generator-start-generating-qr-codes-in-less-than-1-minute%2F&internal=1&sponsored=0&api_key=8943b7fd64cd8b1770ff5affa9a9437b
Error codes Anchor
| Code | Description |
|---|---|
| 400 | location or api_key not provided |
Content Meta Tags Anchor
Shareaholic creates a "Content Index" for all sites it is installed on. This is done by Steve, our bot that fetches and caches the HTML of each webpage our software is installed on. Our algorithms then evaluate the content of each webpage and select the most appropriate title, description, thumbnail, other meta information, including NLP (Natural Language Processing) semantic analysis of the content.