API Endpoints

The Parse.ly API features several endpoints you can call to retrieve data from the system.

Analytics
GET /analytics/(type) Returns a list of posts, authors, sections, tags, or channels.

Conversions
Provides detailed URL-level conversion metrics and returns a list of top-converting content.

Exclude
Manage a list of URLs that we exclude from the results of all other API endpoints.

Metadata
POST /metadata/(metadata-type) Updates the metadata for a post or video.

Partners
Enables partners to create Site IDs on behalf of their customers.

Recommendations
Serves related and personalized content in-browser via JavaScript.

Referrers
GET /referrers/(referrer_type) Return a list of the top referrers for a referrer type.

Search
Search for posts by keyword or query. These can match against full content.

Shares
GET /shares/posts Retrieve a listing of top posts by social shares across top social networks.

Top 10 or Top 25
Returns today’s Top 10 posts or videos. This endpoint was designed to be lightweight and fast, allowing you to access top content lists without exposing your API secret or actual metric values.