API Description > Maintaining Your Catalog
Sections:
In order for us to be able to generate toplists and other summaries we need to map your releases against ours.
This is done to ensure that only content that's actually available in your service are featured in the data returned by the Popyoular API.
To add a mapping:
curl -x PUT 'http://apiv2.popyoular.se/music/artists/patrick-wolf/the-bachelor/ids/[partner]/123'
The album or movie can be specified using any of the four methods described in the Release Lookup section of this documentation. For example, the following is equivalent to the call above:
curl -x PUT 'http://apiv2.popyoular.se/music/match/Patrick%20wolf/The%20Bachelor/ids/[partner]/123'
To remove a mapping:
curl -x DELETE 'http://apiv2.popyoular.se/music/artists/patrick-wolf/the-bachelor/ids/[partner]/123'
Due to our normalization, one release URI maps to one (zero) or more of your release ids
All mapped releases will the include mapping element:
You can check stored ID's for a specific release:
http://apiv2.popyoular.se/music/artists/patrick-wolf/the-bachelor/ids/[partner]
Time limited mappings
Does your service feature content that's only available within certain timeframes? By using the parameters 'start' and 'end' it is possible to create a mapping that is only valid for a limited period of time. By only specifying the 'start'-parameter you create a mapping that will take effect some time in the future.
HTTP PUT 'http://apiv2.popyoular.se/music/artists/patrick-wolf/the-bachelor/ids/[partner]/123?start=2010-12-24&end=2010-12-31
Tags
Whenever you map an album or movie to your internal ID, you can tag that ID with additional information that's relevant to your application. One obvious example is to add your internal genre mapping. This makes it possible to create Popyoular-based toplists and event lists that are specific to your own genre definitions. Any number of other scenarios are possible. You can even add multiple tags per ID. In order to map multiple tags you need to map the same ID again for each tag you want to add.
HTTP PUT 'http://apiv2.popyoular.se/music/artists/kanye-west/albums/my-beautiful-dark-twisted-fantasy/ids/[partner]/123?tag=hiphop
Once a mapping has been made you may use the API with your mapped id's rather than the Popyoular identifier
Reviews and aggregated reviews are also reached in this way:
Again, these requests are obviously available to authenticated users associated with the partner specific data.
