Hash API

API de Analytics e metrics para Twitter, Facebook e Instagram.

A Fazer

• Implementar Test de API com Dreed
• Implementar CI com Travis
• Integrar com autenciação do [Hydra] https://github.com/ory/hydra
• Integrar com Kong

Analytics - Facebook

Perfis Mais Ativos

angular
  .module('app', ['hash.api'])
  .controller('MyCtrl', function ($scope, AnalyticsFacebook) {
    AnalyticsFacebook.mostActiveProfiles({
        profile_type: 'page', // Requiried
        period: '1d',
        'filter[with_tags]': ['tag-1', 'tag-2'],
        'filter[contain_tags]': ['tag-1', 'tag-2'],
        'filter[hashtags]': ['hashtag1'],
        'filter[profiles]': [123129313013, 123129313013, 123129313013, 123129313013],
        'filter[mentions]': ['user1', 'user2'],
        'filter[type]': ['link', 'video', 'photo']
      }, 
      function success(res) {
        console.info(res);
      },
      function error(err) {
        console.error(err);
      });
  });

O código acima retornara uma estrutura em JSON parecida com essa:

[
]

Esse endpoint retorna todos os posts de Facecook com opção de selecionar um período e filtros.

HTTP Request

GET https://hash-api.herokuapp.com/v1/analytics/facebook/most_active_profiles

Paramentros da Query

Parameter	Default	Description
profile_type		Obrigatório. Tipo de perfil a ser analisado, páginas page ou usuários user.
period	1d	Opcional. Período que vai ser consultado a parti do inicio da requisição, as opções são: 15m : 15 minutos 30m : 30 minutos 1h : 1 hora 6h : 6 horas 12h : 12 horas 1d : 1 dia 7d : 7 dias 15d - 15 dias
filter[with_tags]		Opcional. Uma array de strings que filtra os posts que possuem todas as tags informadas.
filter[contain_tags]		Opcional. Uma array de strings que filtra os posts que possuem qualquer uma das tags informadas.
filter[hashtags]		Opcional. Uma array de strings que filtra os posts que possuem qualquer uma das hashtags informadas.
filter[profiles]		Opcional. Uma array de inteiros int32 dos ids dos perfis que filtra os posts que possuem qualquer um dos perfis informados.
filter[mentions]		Opcional. Uma array que filtra os posts que possuem qualquer um dos usuários informados e que foram mencionados.
filter[type]		Opcional. Uma array que filtra os tweets que possuem todas as condições informadas. As condições são: link : URL/Link photo : Fotos ou Imagens video : Vídeos event : Eventos status : Status music : Música

Posts Mais Comentados

angular
  .module('app', ['hash.api'])
  .controller('MyCtrl', function ($scope, AnalyticsFacebook) {
    AnalyticsFacebook.mostCommentedPosts({
        profile_type: 'page', // Requiried
        period: '1d',
        'filter[with_tags]': ['tag-1', 'tag-2'],
        'filter[contain_tags]': ['tag-1', 'tag-2'],
        'filter[hashtags]': ['hashtag1'],
        'filter[profiles]': [123129313013, 123129313013, 123129313013, 123129313013],
        'filter[mentions]': ['user1', 'user2'],
        'filter[type]': ['link', 'video', 'photo']
      }, 
      function success(res) {
        console.info(res);
      },
      function error(err) {
        console.error(err);
      });
  });

O código acima retornara uma estrutura em JSON parecida com essa:

[
]

Esse endpoint retorna todos os posts de Facecook com opção de selecionar um período e filtros.

HTTP Request

GET https://hash-api.herokuapp.com/v1/analytics/facebook/most_commented_posts

Paramentros da Query

Parameter	Default	Description
profile_type		Obrigatório. Tipo de perfil a ser analisado, páginas page ou usuários user.
period	1d	Opcional. Período que vai ser consultado a parti do inicio da requisição, as opções são: 15m : 15 minutos 30m : 30 minutos 1h : 1 hora 6h : 6 horas 12h : 12 horas 1d : 1 dia 7d : 7 dias 15d - 15 dias
filter[with_tags]		Opcional. Uma array de strings que filtra os posts que possuem todas as tags informadas.
filter[contain_tags]		Opcional. Uma array de strings que filtra os posts que possuem qualquer uma das tags informadas.
filter[hashtags]		Opcional. Uma array de strings que filtra os posts que possuem qualquer uma das hashtags informadas.
filter[profiles]		Opcional. Uma array de inteiros int32 dos ids dos perfis que filtra os posts que possuem qualquer um dos perfis informados.
filter[mentions]		Opcional. Uma array que filtra os posts que possuem qualquer um dos usuários informados e que foram mencionados.
filter[type]		Opcional. Uma array que filtra os tweets que possuem todas as condições informadas. As condições são: link : URL/Link photo : Fotos ou Imagens video : Vídeos event : Eventos status : Status music : Música

Posts Mais Curtidos

angular
  .module('app', ['hash.api'])
  .controller('MyCtrl', function ($scope, AnalyticsFacebook) {
    AnalyticsFacebook.mostLikedPosts({
        profile_type: 'page', // Requiried
        period: '1d',
        'filter[with_tags]': ['tag-1', 'tag-2'],
        'filter[contain_tags]': ['tag-1', 'tag-2'],
        'filter[hashtags]': ['hashtag1'],
        'filter[profiles]': [123129313013, 123129313013, 123129313013, 123129313013],
        'filter[mentions]': ['user1', 'user2'],
        'filter[type]': ['link', 'video', 'photo']
      }, 
      function success(res) {
        console.info(res);
      },
      function error(err) {
        console.error(err);
      });
  });

O código acima retornara uma estrutura em JSON parecida com essa:

[
]

Esse endpoint retorna todos os posts de Facecook com opção de selecionar um período e filtros.

HTTP Request

GET https://hash-api.herokuapp.com/v1/analytics/facebook/most_liked_posts

Paramentros da Query

Parameter	Default	Description
profile_type		Obrigatório. Tipo de perfil a ser analisado, páginas page ou usuários user.
period	1d	Opcional. Período que vai ser consultado a parti do inicio da requisição, as opções são: 15m : 15 minutos 30m : 30 minutos 1h : 1 hora 6h : 6 horas 12h : 12 horas 1d : 1 dia 7d : 7 dias 15d - 15 dias
filter[with_tags]		Opcional. Uma array de strings que filtra os posts que possuem todas as tags informadas.
filter[contain_tags]		Opcional. Uma array de strings que filtra os posts que possuem qualquer uma das tags informadas.
filter[hashtags]		Opcional. Uma array de strings que filtra os posts que possuem qualquer uma das hashtags informadas.
filter[profiles]		Opcional. Uma array de inteiros int32 dos ids dos perfis que filtra os posts que possuem qualquer um dos perfis informados.
filter[mentions]		Opcional. Uma array que filtra os posts que possuem qualquer um dos usuários informados e que foram mencionados.
filter[type]		Opcional. Uma array que filtra os tweets que possuem todas as condições informadas. As condições são: link : URL/Link photo : Fotos ou Imagens video : Vídeos event : Eventos status : Status music : Música

Imagens Mais Recorrentes

angular
  .module('app', ['hash.api'])
  .controller('MyCtrl', function ($scope, AnalyticsFacebook) {
    AnalyticsFacebook.mostRecurringIimages({
        profile_type: 'page', // Requiried
        period: '1d',
        'filter[with_tags]': ['tag-1', 'tag-2'],
        'filter[contain_tags]': ['tag-1', 'tag-2'],
        'filter[hashtags]': ['hashtag1'],
        'filter[profiles]': [123129313013, 123129313013, 123129313013, 123129313013],
        'filter[mentions]': ['user1', 'user2'],
        'filter[type]': ['link', 'video', 'photo']
      }, 
      function success(res) {
        console.info(res);
      },
      function error(err) {
        console.error(err);
      });
  });

O código acima retornara uma estrutura em JSON parecida com essa:

[
]

Esse endpoint retorna todos os posts de Facecook com opção de selecionar um período e filtros.

HTTP Request

GET https://hash-api.herokuapp.com/v1/analytics/facebook/most_recurring_images

Paramentros da Query

Parameter	Default	Description
profile_type		Obrigatório. Tipo de perfil a ser analisado, páginas page ou usuários user.
period	1d	Opcional. Período que vai ser consultado a parti do inicio da requisição, as opções são: 15m : 15 minutos 30m : 30 minutos 1h : 1 hora 6h : 6 horas 12h : 12 horas 1d : 1 dia 7d : 7 dias 15d - 15 dias
filter[with_tags]		Opcional. Uma array de strings que filtra os posts que possuem todas as tags informadas.
filter[contain_tags]		Opcional. Uma array de strings que filtra os posts que possuem qualquer uma das tags informadas.
filter[hashtags]		Opcional. Uma array de strings que filtra os posts que possuem qualquer uma das hashtags informadas.
filter[profiles]		Opcional. Uma array de inteiros int32 dos ids dos perfis que filtra os posts que possuem qualquer um dos perfis informados.
filter[mentions]		Opcional. Uma array que filtra os posts que possuem qualquer um dos usuários informados e que foram mencionados.
filter[type]		Opcional. Uma array que filtra os tweets que possuem todas as condições informadas. As condições são: link : URL/Link photo : Fotos ou Imagens video : Vídeos event : Eventos status : Status music : Música

Posts Mais Compartilhados

angular
  .module('app', ['hash.api'])
  .controller('MyCtrl', function ($scope, AnalyticsFacebook) {
    AnalyticsFacebook.mostSharedPosts({
        profile_type: 'page', // Requiried
        period: '1d',
        'filter[with_tags]': ['tag-1', 'tag-2'],
        'filter[contain_tags]': ['tag-1', 'tag-2'],
        'filter[hashtags]': ['hashtag1'],
        'filter[profiles]': [123129313013, 123129313013, 123129313013, 123129313013],
        'filter[mentions]': ['user1', 'user2'],
        'filter[type]': ['link', 'video', 'photo']
      }, 
      function success(res) {
        console.info(res);
      },
      function error(err) {
        console.error(err);
      });
  });

O código acima retornara uma estrutura em JSON parecida com essa:

[
]

Esse endpoint retorna todos os posts de Facecook com opção de selecionar um período e filtros.

HTTP Request

GET https://hash-api.herokuapp.com/v1/analytics/facebook/most_shared_posts

Paramentros da Query

Parameter	Default	Description
profile_type		Obrigatório. Tipo de perfil a ser analisado, páginas page ou usuários user.
period	1d	Opcional. Período que vai ser consultado a parti do inicio da requisição, as opções são: 15m : 15 minutos 30m : 30 minutos 1h : 1 hora 6h : 6 horas 12h : 12 horas 1d : 1 dia 7d : 7 dias 15d - 15 dias
filter[with_tags]		Opcional. Uma array de strings que filtra os posts que possuem todas as tags informadas.
filter[contain_tags]		Opcional. Uma array de strings que filtra os posts que possuem qualquer uma das tags informadas.
filter[hashtags]		Opcional. Uma array de strings que filtra os posts que possuem qualquer uma das hashtags informadas.
filter[profiles]		Opcional. Uma array de inteiros int32 dos ids dos perfis que filtra os posts que possuem qualquer um dos perfis informados.
filter[mentions]		Opcional. Uma array que filtra os posts que possuem qualquer um dos usuários informados e que foram mencionados.
filter[type]		Opcional. Uma array que filtra os tweets que possuem todas as condições informadas. As condições são: link : URL/Link photo : Fotos ou Imagens video : Vídeos event : Eventos status : Status music : Música