Get Topic Suggestions

This endpoint allows a user to get a list of suggested topics based on a list of input topics. Suggested Topics are based on Bombora’s in-house topic recommendation engine. It will return up topics up to the number specified.

If an account only has access to a specific set of whitelisted topics, only these topics will be returned. Please contact an Account Manager if there are issues with returned topics.

1 Data Types
- 1.1 Request Object
- 1.2 Object Topic
- 1.3 Object Topics
2 Request/Response
- 2.1 HTTP Request
- 2.2 HTTP Request Header
- 2.3 HTTP Request Body
- 2.4 HTTP Response
3 Comments

Data Types

Request Object

Field name	Type	Description	Default	Notes

Field name	Type	Description	Default	Notes
Topics	int	Id of topic	N/A	Required
NumberOfSuggestedTopics	int	Number of suggested topics to return	25	Optional. Options: 25, 50, 75, 100, 150, 200

Object Topic

Field name	Type	Description

Field name	Type	Description
Id	int	Id of topic
Name	string	Display name
Description	string	Topic description

Object Topics

Field name	Type	Description

Field name	Type	Description
Topics	Topic[]	List of all topics

Request/Response

HTTP Request

GET https://sentry.bombora.com/v2/cmp/TopicSuggestions

HTTP Request Header

Authorization: Basic {AUTH_KEY}
Referer: bombora.com

HTTP Request Body

{
"Topics" : [12314, 45656, 1234],
"NumberOfSuggestedTopics" : 25
}

HTTP Response

If successful, the response contains an instance of Topics, which is a list of Topic.

{
  "Topics":[
    {
      "Id":1335536,
      "Name":"Infrastructure",
      "Description":"The basic physical and organizational structures and facilities needed for the operation of a society or enterprise."
    },
    {
      "Id":1333532,
      "Name":"Local Government",
      "Description":"The administration of a particular town, county, or district, with representatives elected by those who live there."
    },
    {
      "Id":1333536,
      "Name":"Legal",
      "Description":"Of, based on, or concerned with the law"
    },
    .................
  ],
  "Success":true,
  "Message":null
}

Comments

Copyright © 2014-2020 by Bombora, Inc. All rights reserved. No part of this publication may be reproduced, distributed, or transmitted in any form or by any means without the prior written permission of Bombora, Inc.