Resumo
A API CisionOne permite conectar seus dados de Monitorização com outros conjuntos de dados internos.
A API funciona a partir de Mention Streams que já foram criadas numa conta. Todos os pedidos da API CisionOne são feitos sob https://api.cision.one e todas as respostas são obtidas nos formatos JSON e CSV.
O cliente terá a opção de obter os seguintes dados:
1. Uma lista de menções para uma Mention Stream
2. Um resumo de estatísticas e métricas para uma Mention Stream
3. Uma lista das Mention Stream do cliente
Como funciona a API da Cision?
Cumprimos a nossa parceria e não fornecemos dados de leitura via API.
Para suportar a mais ampla gama de ferramentas de inteligência de negócios (BI), desenvolvemos a nossa API para que possa extrair dados da Cision para as suas aplicações. No entanto, não temos ligações diretas para outras ferramentas com a nossa API Cision, pelo que o esforço de desenvolvimento para extrair da API Cision e a importação dos dados para o teu sistema será da responsabilidade da sua equipa de desenvolvimento.
Que dados são fornecidos na API?
Para uma menção (Obtém uma lista de menções para um fluxo):
1. Tipo
2. CriadoEm
3. PublicadoEm
4. Meio
5. Título
6. Autor
7. Removido?
8. URL
9. Link Interno da Cision
10. Fonte
11. Fuso Horário da Fonte
12. Localização
13. Código de Linguagem
14. Sentimento
15. Palavras-chave
16. Contagem de Palavras
17. Audiência*
18. AVE
19. ImpactScore
*Devido à nossa relação com a SimilarWeb, não conseguimos fornecer dados de audiência individual para conteúdo Online na API.
Exemplo de Resposta:1 [
2 {
3 "id": 0,
4 "timestamp": 0,
5 "createdAt": "2019-08-24T14:15:22Z",
6 "publishedAt": "2019-08-24T14:15:22Z",
7 "medium": "string",
8 "title_summary": "string",
9 "author": "string",
10 "removed": true,
11 "url": "string",
12 "internalLink": "string",
13 "source": "string",
14 "timeZone": "string",
15 "locationCountry": "string",
16 "locationState": "string",
17 "locationCity": "string",
18 "languageCode": "string",
19 "wordCount": 0,
20 "sentiment": 0,
21 "keywordCounts": [],
22 "audience": 0,
23 "advertisingValue": 0,
24 "impactScore": 0
25 }
26 ]
27
Para uma Mention Stream (Um resumo estatístico para um fluxo):
1. IntervaloDeData
2. RótuloDoFluxo
3. TipoDeMedia
4. AVE
5. AudiênciasPorTipo
6. AgregaçãoDeSentimento
Exemplo de Resposta:
1 {
2"streamId": 3349,
3 "streamLabel": "The Daily Show",
4 "before": "2023-06-14T02:34:56.000Z",
5 "after": "2023-06-14T02:34:56.000Z",
6 "media": [
7 "Online",
8 "Print",
9 "TV",
10 "Radio"
11 ],
12 "advertisingValues": [
13 {
14 "label": "TV",
15 "values": {
16 "count": 100,
17 "total": 100
18 }
19 },
20 {
21 "label": "Radio",
22 "values": {
23 "count": 100,
24 "total": 100
25 }
26 }
27 ],
28 "audiencesByType": [
29 {
30 "label": "TV",
31 "value": 100
32 },
33 {
34 "label": "Radio",
35 "value": 100
36 }
37 ],
38 "sentimentAggregation": [
39 {
40 "label": "Negative",
41 "values": {
42 "from": 0,
43 "to": 10,
44 "doc_count": 100
45 }
46 },
47 {
48 "label": "Trending Negative",
49 "values": {
50 "from": 0,
51 "to": 10,
52 "doc_count": 100
53 }
54 },
55 {
56 "label": "Balanced",
57 "values": {
58 "from": 0,
59 "to": 20,
60 "doc_count": 100
61 }
62 },
63 {
64 "label": "Trending Positive",
65 "values": {
66"from": 30,
67 "to": 40,
68 "doc_count": 100
69 }
70 },
71 {
72 "label": "Positive",
73 "values": {
74 "from": 40,
75 "to": 50,
76 "doc_count": 100
77 }
78 }
79 ]
80 }
81
Para todas as Mention Streams na sua conta:
Também pode optar por obter um resumo de todas as Mention Streams na sua conta. Se for essa a sua escolha, receberá as seguintes estatísticas e métricas relacionadas com as suas Mention Streams.
· Id
· Rótulo
· CriadoEm
· AtualizadoEm
· EstiloDeConsulta
· Palavras-chave
· Palavras-chave Excluídas
· Classificação Padrão de Sentimento
· Arquivado
· Conteúdo de Revista
· Conteúdo Online
· Conteúdo de Podcast
· Conteúdo de Rádio
· Conteúdo de Impressão
· Conteúdo Social
· Conteúdo de TV
Exemplo de Resposta:
GET /streams
1 [
2 {
3 "id": 3349,
4 "label": "The Daily Show",
5 "createdAt": "2023-06-14T02:34:56.000Z",
6 "updatedAt": "2023-06-14T02:34:56.000Z",
7 "queryStyle": "boolean",
8 "keywords": "foo",
9 "excludedKeywords": "bar",
10 "defaultSentimentRating": 0,
11 "archived": false,
12 "magazineContent": true,
13 "onlineContent": true,
14 "podcastContent": true,
15 "printContent": true,
16 "radioContent": true,
17 "socialContent": true,
18 "tvContent": true
19 }
20 ]
21
Limite de Taxa
As solicitações para a API podem ser limitadas a 10 solicitações por minuto. Isso é limitado tanto pelo seu endereço IP como pela chave da API que está a usar. Solicitações que excederem esse limite podem receber o código de resposta HTTP padrão 429 (Muitas Solicitações).