@Pirhoo coded a first version of the Influence Networks API. Feel free to use Influence Network’s data in any application and invent new visualizations. If you require more calls on the API, we’ll be glad to expand your quota limits.
Terms of Use
The service’s terms of use apply to usage of the API as well. Usage of the Influence Networks API may not imply that Influence Networks guarantees the reliability of the information it offers. The ‘trust level’ system must be well understood and end-users of services build upon this API may not be misled in believing that the information offered has been vetted by any media organization whatsoever.
Resource documentation
Resource |
Description |
Parameters |
GET api/entity/ |
Retrieves entities and their relations. | page (optional): Specifies the page of results to retrieve. Default value: 1 limit (optional): Specifies the number of entities to retrieve. Must be less than or equal to 15. Default value: 5 |
GET api/entity/{id}
|
Retrieves one entity and its relations. | none. |
GET api/relation/ |
Retrieves a list of the relations in the database. | page (optional): Specifies the page of results to retrieve. Default value: 1 limit (optional): Specifies the number of relations to retrieve. Must be less than or equal to 15. Default value: 5 |
GET api/relation/{id}
|
Retrieves the details of one relation. | none. |
Output
JSON
JSONP (use the “callback” parameter)
Error Codes & Responses
HTTP Status Codes
- 200: OK
- 204: Empty content
- 405: Wrong parameter(s)
- 412: Method not allowed
- 501: Method not implemented
- 600: Quota limit exceeded
Quota limits
GET : 120 query by hour
Example
In this example, we will retrieve all the relations of Julian Assange that Influence Networks’ users have input.
The identifier to use can be either Influence Network’s internal numerical key or Freebase’s string identifier. Freebase offers a very easy-to-use widget that will make the match with the right identifier as you type, which we use on Influence Networks. In Julian Assange’s case, the key to use is en/julian_assange
The URL to call is therefore:
http://influencenetworks.org/api/entity/en/julian_assange
Which outputs the following response:
{
"status": "200 OK",
"status_code": 200,
"content": {
"id": 23,
"freebase_id": "/en/julian_assange",
"label": "Julian Assange",
"type": "/people/person",
"relations": [
{
"id": 421,
"node_left": 23,
"node_right": 2220,
"creator": 383,
"type": 4,
"trust_level": 4.7,
"type_label": "Commercial relation",
"node_left_label": "Julian Assange",
"node_right_label": "Pierre Romera",
"node_left_freebase_id": "/en/julian_assange",
"node_right_freebase_id": "/m/0gkbq_v",
"node_left_type": "/people/person",
"node_right_type": "/people/person"
},
{
"id": 423,
"node_left": 23,
"node_right": 2221,
"creator": 383,
"type": 4,
"trust_level": 4.5,
"type_label": "Commercial relation",
"node_left_label": "Julian Assange",
"node_right_label": "Nicolas Kayser-Bril",
"node_left_freebase_id": "/en/julian_assange",
"node_right_freebase_id": "/m/0gkbr00",
"node_left_type": "/people/person",
"node_right_type": "/people/person"
},
{
"id": 621,
"node_left": 23,
"node_right": 27,
"creator": 277,
"type": 4,
"trust_level": 5.1,
"type_label": "Commercial relation",
"node_left_label": "Julian Assange",
"node_right_label": "Wikileaks",
"node_left_freebase_id": "/en/julian_assange",
"node_right_freebase_id": "/en/wikileaks",
"node_left_type": "/people/person",
"node_right_type": "/organization/organization"
},
{
"id": 709,
"node_left": 23,
"node_right": 497,
"creator": 960,
"type": 2,
"trust_level": 4.1,
"type_label": "Rivals",
"node_left_label": "Julian Assange",
"node_right_label": "Daniel Domscheit-Berg",
"node_left_freebase_id": "/en/julian_assange",
"node_right_freebase_id": "/m/0fqmk3b",
"node_left_type": "/people/person",
"node_right_type": "/people/person"
}
]
}
}
Always remember
