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 |
---|---|---|---|---|
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 |
---|---|---|
Id | int | Id of topic |
Name | string | Display name |
Description | string | Topic description |
Object Topics
Field name | Type | Description |
---|---|---|
Topics | Topic[] | List of all topics |
Request/Response
HTTP Request
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.