This API returns top domains for a specified topic with details for each domain that include description, image link, up to top 10 associated topics and up to top 10 associated Right Relevance influencers. The call is paginated with maximum 50 results.
Resource URL
GET https://api.rightrelevance.com/v2/domains/search?topic=<topic>
Parameters
| topic=<topic>
(required)
|
query topic for searching top domains
Example Values: data science, e-learning |
| start=X
(optional)
|
Returns domains starting from index ‘X’. Default: 0
Example Values: 0 |
| rows=Y
(optional)
|
Number of domains ‘Y’ to return. Default: 10
Example Values: 9 |
Example Request
GET https://api.rightrelevance.com/v2/domains/search?topic=e-learning&access_token=PLACE_ACCESS_TOKEN
Example Response
{
topic: "e-learning",
domains: [
{
domain: "elearninglearning.com",
topics: [
{
topic: "e-learning",
topic_type: "single_topic",
count: 207
},
... (8 more max)
{
topic: "commlab",
topic_type: "single_topic",
count: 3
}
],
influencers: [
{
expert_id: "http://twitter.com/tekieboard",
sfc: 329,
count: 11
},
... (8 more max)
{
expert_id: "http://twitter.com/atdlearntech",
sfc: 552,
count: 2
}
],
count: 207,
description: "eLearning Learning, insights your peers are reading. We bring together the best content on eLearning from the widest variety of industry thought leaders.",
profile_image_url: "http://pbs.twimg.com/profile_images/880822372755939328/hXaObSiV_normal.jpg",
twitter_screen_name: "elearningposts"
}
},
... (other top domains) ...
]
}
Response Fields
Returns top domains for topic ‘e-learning’ including top associated topics, top associated influencers who post on that domain, description and image link. Most fields are self-explanatory.
| domains | List of top domains associated with the query topic in relevance sorted order |
| domains.topics | List of top topics associated with the domain over last 30 days |
| domains.influencers | List of influencers posting on the domain sorted on no. of posts over last 30 days |