Engagd Profiler

The Profiler tranforms your lifestreams and click streams into APML. Learn more about the purpose of Profiler on the Engagd website.

Basics

• API access requires a developers key, available via the developers.engagd.com site.
• User accounts will be created implicitly.
• The user ids provided to the API need not be numeric or follow any special pattern - they can be anything meaningful to the calling application

REST API

The REST (Representational State Transfer) API allows manipulation of the user's profile via resources exposed through HTTP addresses.

Basics

• Resources are manipulated through the HTTP methods GET, POST, PUT and DELETE.
• Provided page and feed urls should be url-encoded.

User Profiling

Profiling a page

Profiling a page adds that page to the user's evolving Attention Profile. This might be useful when tracking a user's clickstream or path through a given website.

PUT: https://profiler.engagd.com/user/<devKey>/<userId>/pages?url=<pageUrl>

Subscribing to a Feed

Subscribing to a feed will register the given feed against the user's Attention Profile. Profiler will continue to check the feed for new items and update the user's attention profile over time. This might be useful for a feed of Attention Data from the user such as their personal bookmarks, blog posts or tweets.

PUT: https://profiler.engagd.com/user/<devKey>/<userId>/feeds?url=<feedUrl>

Unsubscribing a Feed

DELETE: https://profiler.engagd.com/user/<devKey>/<userId>/feeds?url=<feedUrl>

Unsubscribing all Feeds

DELETE: https://profiler.engagd.com/user/<devKey>/<userId>/feeds

Resource Profiling

Retrieving the APML for a Page

Generating an APML file for a single page might be useful for helping users to understand the key concepts of the given page.

GET:  https://profiler.engagd.com/user/<devKey>/apml?url=<pageUrl>

Retrieving/Uploading APML

To retreive or upload a user APML file refer to the APML API.

Service Updates

Keep track of changes to this service and the API via the Profiler API Change Log.