Knowledge - Document - Get

/knowledge/document/get/{docid}?returnFullText=[true|false|1|0]&returnRawData=[true|false|1|0]
/knowledge/document/get/{sourceKey}/{url}?returnFullText=[true|false|1|0]&returnRawData=[true|false|1|0]

Returns a document matching the id (or sourceKey/URL) provided.

Authentication

Required, see Auth - Login

Arguments

docid (required - unless sourceKey/URL specified)
id of the document of which to return the metadata

sourceKey (required - unless docid specified)

URL (required - unless docid specified)

Instead of specifying the document "_id", the sourceKey together with a URL-encoded URL can be specified (the 2 uniquely define any document within the platform).

returnFullText (optional)
By default, the text of the document is not returned. Setting this parameter to "true" or "1" will return the first 50KB of the content, in the "fullText" JSON field (see below).

returnRawData (optional)
Only applies to files - if set to true (default is false) then returns the raw file directly from the fileshare. The extension of the stored filename is used to determine the reported encoding type. For non-files, this parameter is ignored.

Example

http://infinite.ikanow.com/api/knowledge/document/get/4cc0ebff97622e5914a70e83
http://infinite.ikanow.com/api/knowledge/document/get/4cc0ebff97622e5914a70e83?returnFullText=1

http://infinite.ikanow.com/api/knowledge/document/get/rss.media.com.news/http%3a%2f%2fwww.media.com%2fcontent.html

Example Response
{
    "response": {
        "action": "Doc Info",
        "success": true,
        "message": "Feed info returned successfully",
        "time": 23
    },
    "data": {
        "_id": "4e36d71880d77d6ea5b31ea5",
        "title": "vt123.kl",
        "url": "smb://modus:139/modus_input/inprocess/vt123.kl",
        "created": "Aug 1, 2011 12:40:56 PM",
        "modified": "Apr 12, 2011 3:03:33 PM",
        "publishedDate": "Sep 17, 2008 7:39:00 PM",
        "sourceKey": [
            "smb.modus.139.modus_input."
        ],
        "mediaType": [
            "Intel"
        ],
        "description": "BAGHDAD: CAR BOMBS ACROSS IRAQ, INCLUDING AT LEAST ONE NEAR THE POLISH EMBASSY IN BAGHDAD, KILLED 20 PEOPLE AND WOUNDED DOZENS ON MONDAY, POLICE SAID.  A SUICIDE TRUCK BOMBER SLAMMED INTO A POLICE STATION BUILDING IN DIJLAH, 130 KILOMETERS (80 MILES) NORTH OF BAGHDAD IN EARLY AFTERNOON, KILLING NINE PEOPLE, INCLUDING THREE POLICEMEN, AND WOUNDING 26, MOSTLY CIVILIANS.  THE EXPLOSION ALSO DESTROYED OVER 20 SHOPS IN THE AREA AND SOME 10 CARS NEARBY, DIJLAH SECURITY OFFICIAL ABDUL WAHAB AHMED SAID.  IN BAGHDAD, A 2 P.M. (11:00 GMT) BLAST NEAR THE POLISH EMBASSY IN THE DOWNTOWN SHIITE-CONTROLLED KARRADAH DISTRICT KILLED TWO PERSONS AND WOUNDED FIVE. ALL THE VICTIMS WERE IRAQIS, THE POLICE SAID.  THE POLISH CHARGE D'AFFAIRES WALDEMAR FIGAJ TOLD THE ASSOCIATED PRESS THAT THERE HAD BEEN A SERIES OF EXPLOSIONS AROUND THE EMBASSY MONDAY BUT THAT THE CLOSEST WAS ABOUT 200 METERS (219 YARDS), AND THAT THE EMBASSY HAD NO REASON TO BELIEVE IT \"WAS TARGETED IN ANY WAY.\"  POLISH AMBASSADOR GEN. EDWARD PIETRZYK, WAS WOUNDED WHEN HIS CONVOY WAS AMBUSHED WITH ROADSIDE BOMBS LAST WEEK IN KARRADAH, IN AN ATTACK THAT ALSO KILLED A POLISH SECURITY GUARD AND TWO OTHERS.  FIGAJ SAID THE AMBASSADOR WAS STILL BEING KEPT IN AN ARTIFICIAL COMA IN A HOSPITAL IN POLAND, A PROCEDURE HE SAID WAS INDUCED TO ALLEVIATE PAIN BECAUSE PIETRSYK HAD SUSTAINED BURNS OVER 20 PERCENT OF HIS BODY.  ALSO MONDAY, A CAR BOMB WENT OFF AT A SMALL POPULAR MARKET NEAR BAGHDAD UNIVERSITY'S TECHNOLOGY DEPARTMENT, KILLING FIVE CIVILIANS AND WOUNDING 15, POLICE SAID. THAT BOMB EXPLODED AT 12:30 A.M. (9:30 GMT) IN SINAA STREET, IN DOWNTOWN BAGHDAD.  THE WOUNDED INCLUDED FOUR WOMEN AND THREE CHILDREN. THE CASUALTIES WERE TAKEN TO A NEARBY HOSPITAL.POLICE ALSO SAID AT LEAST SIX OTHER CARS PARKED IN THE AREA WERE DAMAGED AS WELL BY THE BLAST.  HALF AN HOUR EARLIER, ANOTHER PARKED CAR BOMB WENT OFF NEAR A POLICE CHECKPOINT IN THE PREDOMINANTLY SHIITE NEIGHBORHOOD OF KAMALIYAH IN EASTERN BAGHDAD, WOUNDING SIX CIVILIANS AND DAMAGING AT LEAST THREE CARS, POLICE SAID.  AP TELEVISION NEWS FOOTAGE FROM THE MARKET BOMBING SHOWED THE MANGLED WRECKAGE OF THE CAR BOMB AND DAMAGED CARS SURROUNDING IT. AMERICAN SOLDIERS WERE ALSO SEEN AT THE SCENE AND U.S. HELICOPTERS FLEW OVER THE AREA.  A SUICIDE CAR BOMBER ALSO STRUCK A POLICE CHECKPOINT IN SADDAM HUSSEIN'S HOMETOWN OF TIKRIT, 130 KILOMETERS (80 MILES) NORTH OF BAGHDAD, KILLING FOUR, INCLUDING THREE POLICEMEN, AND WOUNDING 10 OTHER PEOPLE, POLICE SAID.",
        "entities": [
            {
                "disambiguated_name": "car",
                "index": "car/automobile",
                "actual_name": "CAR",
                "type": "automobile",
                "relevance": 0,
                "frequency": 8,
                "totalfrequency": 152,
                "doccount": 83,
                "dimension": "What"
            },
            {
                "disambiguated_name": "200",
                "index": "200/automobile",
                "actual_name": "200",
                "type": "automobile",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 45,
                "doccount": 37,
                "dimension": "What"
            },
            {
                "disambiguated_name": "police",
                "index": "police/organization",
                "actual_name": "POLICE",
                "type": "organization",
                "relevance": 0,
                "frequency": 8,
                "totalfrequency": 277,
                "doccount": 107,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "victim",
                "index": "victim/person",
                "actual_name": "VICTIMS",
                "type": "person",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 24,
                "doccount": 13,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "police",
                "index": "police/person",
                "actual_name": "POLICE",
                "type": "person",
                "relevance": 0,
                "frequency": 8,
                "totalfrequency": 248,
                "doccount": 107,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "m",
                "index": "m/automobile",
                "actual_name": "M",
                "type": "automobile",
                "relevance": 0,
                "frequency": 2,
                "totalfrequency": 39,
                "doccount": 31,
                "dimension": "What"
            },
            {
                "disambiguated_name": "official",
                "index": "official/person",
                "actual_name": "OFFICIAL",
                "type": "person",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 88,
                "doccount": 46,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "person",
                "index": "person/person",
                "actual_name": "PERSONS",
                "type": "person",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 7,
                "doccount": 5,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "people",
                "index": "people/person",
                "actual_name": "PEOPLE",
                "type": "person",
                "relevance": 0,
                "frequency": 3,
                "totalfrequency": 137,
                "doccount": 77,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "80",
                "index": "80/automobile",
                "actual_name": "80",
                "type": "automobile",
                "relevance": 0,
                "frequency": 2,
                "totalfrequency": 8,
                "doccount": 7,
                "dimension": "What"
            },
            {
                "disambiguated_name": "civilian",
                "index": "civilian/person",
                "actual_name": "CIVILIANS",
                "type": "person",
                "relevance": 0,
                "frequency": 3,
                "totalfrequency": 60,
                "doccount": 39,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "policemen",
                "index": "policemen/person",
                "actual_name": "POLICEMEN",
                "type": "person",
                "relevance": 0,
                "frequency": 2,
                "totalfrequency": 35,
                "doccount": 24,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "truck",
                "index": "truck/automobile",
                "actual_name": "TRUCK",
                "type": "automobile",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 45,
                "doccount": 29,
                "dimension": "What"
            },
            {
                "disambiguated_name": "suicide truck bomber",
                "index": "suicide truck bomber/person",
                "actual_name": "SUICIDE TRUCK BOMBER",
                "type": "person",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 3,
                "doccount": 3,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "bomber",
                "index": "bomber/person",
                "actual_name": "BOMBER",
                "type": "person",
                "relevance": 0,
                "frequency": 2,
                "totalfrequency": 42,
                "doccount": 30,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "went",
                "index": "went/drug",
                "actual_name": "WENT",
                "type": "drug",
                "relevance": 0,
                "frequency": 2,
                "totalfrequency": 37,
                "doccount": 31,
                "dimension": "What"
            },
            {
                "disambiguated_name": "woman",
                "index": "woman/person",
                "actual_name": "WOMEN",
                "type": "person",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 29,
                "doccount": 15,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "child",
                "index": "child/person",
                "actual_name": "CHILDREN",
                "type": "person",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 22,
                "doccount": 15,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "he",
                "index": "he/person",
                "actual_name": "HE",
                "type": "person",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 147,
                "doccount": 83,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "suicide car bomber",
                "index": "suicide car bomber/person",
                "actual_name": "SUICIDE CAR BOMBER",
                "type": "person",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 6,
                "doccount": 6,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "soldier",
                "index": "soldier/person",
                "actual_name": "SOLDIERS",
                "type": "person",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 82,
                "doccount": 44,
                "dimension": "Who"
            },
            {
                "disambiguated_name": "baghdad, iraq",
                "index": "baghdad, iraq/city",
                "actual_name": "BAGHDAD",
                "type": "city",
                "relevance": 0,
                "frequency": 8,
                "totalfrequency": 406,
                "doccount": 159,
                "geotag": {
                    "lat": 33.3386111,
                    "lon": 44.3938889
                },
                "dimension": "Where",
                "ontology_type": "city"
            },
            {
                "disambiguated_name": "38smb50",
                "index": "38smb50/geographicfeature",
                "actual_name": "38SMB5083493081",
                "type": "geographicfeature",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 8,
                "doccount": 8,
                "geotag": {
                    "lat": 33.37586144623292,
                    "lon": 44.47143713123417
                },
                "dimension": "Where",
                "ontology_type": "point"
            },
            {
                "disambiguated_name": "police station building in",
                "index": "police station building in/facility",
                "actual_name": "POLICE STATION BUILDING IN",
                "type": "facility",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 1,
                "doccount": 1,
                "dimension": "What"
            },
            {
                "disambiguated_name": "hospital in poland",
                "index": "hospital in poland/facility",
                "actual_name": "HOSPITAL IN POLAND",
                "type": "facility",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 1,
                "doccount": 1,
                "dimension": "What"
            },
            {
                "disambiguated_name": "shops in the",
                "index": "shops in the/facility",
                "actual_name": "SHOPS IN THE",
                "type": "facility",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 2,
                "doccount": 2,
                "dimension": "What"
            },
            {
                "disambiguated_name": "tikrit, iraq",
                "index": "tikrit, iraq/city",
                "actual_name": "TIKRIT",
                "type": "city",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 1,
                "doccount": 1,
                "geotag": {
                    "lat": 34.5966667,
                    "lon": 43.6769444
                },
                "dimension": "Where",
                "ontology_type": "city"
            },
            {
                "disambiguated_name": "baghdad",
                "index": "baghdad/facility",
                "actual_name": "MARKET NEAR BAGHDAD UNIVERSITY",
                "type": "facility",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 2,
                "doccount": 2,
                "dimension": "What"
            },
            {
                "disambiguated_name": "hospital",
                "index": "hospital/facility",
                "actual_name": "NEARBY HOSPITAL",
                "type": "facility",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 7,
                "doccount": 7,
                "dimension": "What"
            },
            {
                "disambiguated_name": "cars parked in the",
                "index": "cars parked in the/facility",
                "actual_name": "CARS PARKED IN THE",
                "type": "facility",
                "relevance": 0,
                "frequency": 1,
                "totalfrequency": 1,
                "doccount": 1,
                "dimension": "What"
            },
            {
                "disambiguated_name": "cars",
                "index": "cars/automobile",
                "actual_name": "CARS",
                "type": "automobile",
                "relevance": 0,
                "frequency": 2,
                "totalfrequency": 22,
                "doccount": 21,
                "dimension": "What"
            },
            {
                "disambiguated_name": "bmw",
                "index": "bmw/automobile",
                "actual_name": "M",
                "type": "automobile",
                "relevance": 0,
                "frequency": 2,
                "totalfrequency": 37,
                "doccount": 30,
                "dimension": "What"
            },
            {
                "disambiguated_name": "audi",
                "index": "audi/automobile",
                "actual_name": "200",
                "type": "automobile",
                "relevance": 0,
                "frequency": 3,
                "totalfrequency": 61,
                "doccount": 48,
                "dimension": "What"
            }
        ],
        "tags": [
            "Modus",
            "IED",
            "Intel",
            "extraction",
            "Iraq"
        ],
        "communityId": [
            "4db5c05fb246d25364aceca0"
        ],
        "associations": [],
        "docGeo": {
            "lat": 33.37586144623292,
            "lon": 44.47143713123417
        }
    }
}