Tech docs
API Docs
Metadata

Metadata

#POST /metadata/(metadata-type)

Updates the metadata for a post or video (depending on the specified metadata-type) using the received metadata dictionary.

This endpoint uses a different secret value from our other endpoints for security purposes. Please reach out to your account manager for details on how to identify the write-only secret value that should be used for this endpoint.

Details on providing on-page metadata can be found here.

The Content-Type header must be set to application/json for the POST request to be properly received.

#Path Arguments

metadata-typeOne of posts OR videos.

#Query Parameters

secretThe write-only secret value. This differs from the standard secret value use for other endpoints. Please reach out to your account manager for details on how to identify the write-only secret value that should be used for this endpoint.
metadataThe JSON object of metadata you would like to be written to our systems. The requisite format of this value is detailed below.

#The Metadata Parameter

The metadata parameter should be a JSON object with the following schema:

canonical_urlCanonical url for post or page. For page groups, like galleries, it should always point to the main page.
urlsUrls that should be aliased to the canonical_url (the traffic for these urls and the canonical_url will be combined to form a single record) provided as a list. (e.g. ["https://test.com/slideshow/1", "https://test.com/slideshow/2"]) Note: A HTTP/S url schema is required for these urls.
page_typeThe type of page between: post, index, video. See "Distinguishing between posts and pages" for more information on what differentiates and post and an index page.
titlePage or video title.
image_urlUrl of the image associated with the page or video.
pub_date_tmspPublication date, formatted as an ISO 8601 UTC timezone string.
sectionSection the page is a part of. (e.g. "Politics")
authorsAuthor(s) of the page or video, provided as a list. (e.g. ["Author 1", "Author 2"])
tagsA list of tags associated with this page or video.

It may take some time for metadata changes to be reflected in the Parse.ly Dashboard or API results due to caching.

#Example

An example of a curl call you can execute in a command line is below.

curl -H "Content-Type: application/json" -X POST https://api.parsely.com/v2/metadata/posts -d '{"apikey": "test.com", "secret": "XXXXX", "metadata":{"pub_date_tmsp": "2018-11-30","title": "Fake Title","tags": ["Test"],"authors": ["API Metadata Endpoint"],"canonical_url": "https://blog.parsely.com/fake-url","page_type": "post","section": "Testing", "full_content": "Fake content for a fake article.", "language": "en"}}'

This request has the following url-encoded fields and values.

apikeytest.com
secretXXXXX
metadata{"pub_date_tmsp": "2018-11-30","title": "Fake Title","tags": ["Test"],"authors": ["API Metadata Endpoint"],"canonical_url": "https://blog.parsely.com/fake-url","page_type": "post","section": "Testing", "full_content": "Fake content for a fake article.", "language": "en"}

The metadata JSON object has the following fields and values.

pub_date_tmsp"2018-11-30"
title"Fake Title"
tags["Test"]
authors["API Metadata Endpoint"]
canonical_url"https://blog.parsely.com/fake-url"
page_type"post"
section"Testing"
full_content"Fake content for a fake article."
language"en"
rocket emoji