Download API

First of all, you do not need any authentication for any download process.

A single GET request to http://semantify.it/api/annotation/:uid endpoint is enough the get a single annotation.

Example:

HTTP GET https://semantify.it/api/annotation/short/r1Cpp5xNf

Response

{“@context”:”http://schema.org/”,”@type”:”Person”,”email”:”josef.margreiter@tirolwerbung.at”,”faxNumber”:”+43 512 5320 140 “,”givenName”:”Josef G. Margreiter”,”image”:”http://www.tirolwerbung.at/wp-content/uploads/2017/04/0256_600x400px.jpg”,”jobTitle”:”Geschäftsführer”,”telephone”:”+43 512 5320 142″,”worksFor”:{“@type”:”Organization”,”department”:{“@type”:”Organization”,”name”:”Geschäftsleitung”},”name”:”Tirol Werbung GmbH”,”url”:”http://www.tirolwerbung.at”}}

Alternatively, you can also use the short URL: https://smtfy.it/r1Cpp5xNf

Downloading all annotations of a website is also very easy.

HTTP GET https://semantify.it/api/annotation/list/:websiteID

Example:

HTTP GET https://semantify.it/api/annotation/list/Syi-T1jeb

Response:

{“metadata”:{“limit”:1000,”offset”:0,”total-count”:15},”data”:[{“name”:”unternehmen-organisation-geschaeftsleitung.jsonld”,”id”:”594a5e33e2f6c36acfebc667″,”UID”:”S1e3VCRDQW”,”type”:[“Organization”],”enc_url”:”http%3A%2F%2Fwww.tirolwerbung.at%2Funternehmen%2Forganisation%2Fgeschaeftsleitung%2F”},{“name”:”unternehmen-organization-markenmanagement.jsonld”,”id”:”594a5e33e2f6c36acfebc66a”,”UID”:”H1U240RwmZ”,”type”:[“Organization”],”enc_url”:”http%3A%2F%2Fwww.tirolwerbung.at%2Funternehmen%2Forganisation%2Fmarkenmanagement%2F”},{“name”:”unternehmen-organization.jsonld”,”id”:”594a5e33e2f6c36acfebc669″,”UID”:”rJV3ERRvmW”,”type”:[]},{“name”:”unternehmen-organisation-tourismusmarketing.jsonld”,”id”:”594a5e33e2f6c36acfebc668″,”UID”:”HJf2VACwQW”,”type”:[“Organization”],”enc_url”:”http%3A%2F%2Fwww.tirolwerbung.at%2Funternehmen%2Forganisation%2Ftourismusmarketing%2F”},{“name”:”newAnnotation2018-01-03T12:57:12.643Z”,”id”:”5a4cd328dfb81623216f69b7″,”UID”:”BkWE78qmM”,”type”:[“Person”]},{“name”:”newAnnotation2018-01-08T07:29:10.373Z”,”id”:”5a531dc6cc6de123b215b1ef”,”UID”:”r1Cpp5xNf”,”type”:[“Person”]},{“name”:”newAnnotation2018-01-08T07:30:51.234Z”,”id”:”5a531e2b8d359723ad8c8433″,”UID”:”HyQER9lNG”,”type”:[“Person”]},{“name”:”newAnnotation2018-01-08T07:32:02.089Z”,”id”:”5a531e726f9135231c31bf11″,”UID”:”SkqdCqxEM”,”type”:[“Person”]},{“name”:”newAnnotation2018-01-08T07:32:48.461Z”,”id”:”5a531ea08d359723ad8c845b”,”UID”:”B1dsRcgVM”,”type”:[“Person”]},{“name”:”newAnnotation2018-01-08T08:37:36.717Z”,”id”:”5a532dd08d359723ad8c88f5″,”UID”:”S1t06jgNf”,”type”:[“Person”]},{“name”:”newAnnotation2018-01-08T08:38:22.853Z”,”id”:”5a532dfedfb816232170d6aa”,”UID”:”SyvZRjg4G”,”type”:[“Person”]},{“name”:”newAnnotation2018-01-08T10:31:21.927Z”,”id”:”5a5348796f9135231c31cb03″,”UID”:”HJzYOpxEz”,”type”:[“Person”]},{“name”:”newAnnotation2018-01-08T10:32:07.470Z”,”id”:”5a5348a76f9135231c31cb10″,”UID”:”r1Jhd6eVf”,”type”:[“Person”]},{“name”:”newAnnotation2018-01-09T15:35:29.855Z”,”id”:”5a54e141cc6de123b2162246″,”UID”:”BJ9rbvfNf”,”type”:[“Person”]},{“name”:”newAnnotation2018-01-09T15:36:50.285Z”,”id”:”5a54e1928d359723ad8cf5f6″,”UID”:”HJc5WDGEG”,”type”:[“Person”]}]}

This API call returns the Name, ID, Short ID and Schema.org Type of the first 1000 annotations in a website. You can retrieve more (or less) by specifying the offset and limit parameters like this:

Example:

https://semantify.it/api/annotation/list/Syi-T1jeb?limit=3

The offset is by default 0. You can use limit and offset together retrieve a specific subset of all annotations.

Example

https://semantify.it/api/annotation/list/Syi-T1jeb?limit=3&offset=10

If you’d like to download an array of annotations whose short IDs you know, you have to wait a bit.

Additionally, you can download all annotations of one or more websites as a zip file in different formats.

Example

https://semantify.it/api/annotation/bulk/Syi-T1jeb

The example above would download all annotations for the given API Key in json-ld format as a zip file with a file for each annotation.

There are many other things you can do with the download API. Take a look at the API documentation.