Verbetes

Verbetes

Verbetes is a service that answers to requests of type "WhoIs" for public personalities.

Free subscription

Technical Overview

Verbetes Service

Verbetes is a service that answers to requests of type "WhoIs" for public personalities. All the information from Verbetes is collected automatically from news sources, and its information is updated on a hour basis, as new news are collected. Verbetes also answers to requests of type "WhoIs" for jobs of public personalities mentioned on news.

API Reference

Service Operation Description
Verbetes GetCoOccurrences This method returns a JSON structure with the network of people with whom a given personality co-occur for a specific time interval. In this example we want to know with whom Vítor Pereira co-occur on news articles during September.
GetCoOccurrencesTrends This method returns a JSON structure with the number of times two persons co-occur in the same news articles for a give time interval. In this example, we want to know the number of times Alberto João Jardim and Pedro Passos Coelho co-occur on the same news articles during September.
GetEgoNet This method returns a JSON structure with the egocentric network of Pedro Passos Coelho between 11/April and 20/April, with depth 1.5 and minimum frequency of edges of 5. This network is created based on the mentions of this person on portuguese online news articles.
GetErgos Returns a list (in JSON format) with all the jobs with at with at least 5 occurrences.
GetGlobalNet This method returns a JSON structure with the global network of people mentioned on news between 28/Oct and 03/Nov, with 5 edges. This network is created based on the mentions of this person on portuguese online news articles.
GetOccurrencesTrends This method returns a JSON structure with the trends of the number of occurrences of a given name in a given time interval, with granularity of 1 day
GetPersonalities Returns a list (in JSON format) with all the people that has verbetes with at least 2 occurrences.
WhoIs returns a JSON structure with all the available verbetes for the person "sócrates"
WhoIsLight This is a light version of WhoIs service. this method returns the most frequent job descriptor of a given input name (complete name), and assumes a default margin of 120 days and a default minimum frequency of the ergo of 2

Verbetes Service

Operations

GetCoOccurrences

This method returns a JSON structure with the network of people with whom a given personality co-occur for a specific time interval. In this example we want to know with whom Vítor Pereira co-occur on news articles during September.
Examples
Go to top

GetCoOccurrencesTrends

This method returns a JSON structure with the number of times two persons co-occur in the same news articles for a give time interval. In this example, we want to know the number of times Alberto João Jardim and Pedro Passos Coelho co-occur on the same news articles during September.
Examples
Go to top

GetEgoNet

This method returns a JSON structure with the egocentric network of Pedro Passos Coelho between 11/April and 20/April, with depth 1.5 and minimum frequency of edges of 5. This network is created based on the mentions of this person on portuguese online news articles.
Examples
Go to top

GetErgos

Returns a list (in JSON format) with all the jobs with at with at least 5 occurrences.
Examples
Go to top

GetGlobalNet

This method returns a JSON structure with the global network of people mentioned on news between 28/Oct and 03/Nov, with 5 edges. This network is created based on the mentions of this person on portuguese online news articles.
Examples
Go to top

GetOccurrencesTrends

This method returns a JSON structure with the trends of the number of occurrences of a given name in a given time interval, with granularity of 1 day
Examples
Go to top

GetPersonalities

Returns a list (in JSON format) with all the people that has verbetes with at least 2 occurrences.
Examples
Go to top

WhoIs

returns a JSON structure with all the available verbetes for the person "sócrates"
Examples
Go to top

WhoIsLight

This is a light version of WhoIs service. this method returns the most frequent job descriptor of a given input name (complete name), and assumes a default margin of 120 days and a default minimum frequency of the ergo of 2
Examples
Go to top

REST API Authentication

Authenticating REST Request

Every request must contain authentication information to establish the identity of whom making the request and a autorization token denominated ESBAccessKey.

ESB Access Key

The ESB Access Key is what will authorize the usage of the API and is available when the buying process ends. In the costumer area you can find the product details where you can generate an ESB Access Key for you usage, another user registered on SAPO Services or even for everyone.

The element ESBAccessKey must appear on the URL as a query-string

HTTP GET example using username and password:

HTTP POST username and password:

Request with ESBToken

Using a token instead of your username and password can be useful if you don't want to give your credentials to whom is using the API.

In order to generate a ESB Token you must use SAPO Security Token Service. The ESBToken is valid for 12 hours.

HTTP GET example using ESB Token:

HTTP POST ESB Token:

Parameters description

ESBCredentials are parameters used to authenticate and authorize a REST request

Elements Description
ESBUsername The e-mail of the account that is used to access the API.
ESBPassword The password that in combination with the ESBUsername is used to access the corresponding account.
ESBToken An authentication token generated by using an user name (ESBUsername) and password (ESBPassword). It should be used a ESBToken or the combination of ESBUsername and ESBPassword.
ESBAccessKey The authorization key used to authorize the request against your purchase. The account being used to access the service must be associated to this key.
Go to top