Get the featured news feed

Overview

🌟 Tips:

This interface supports paginated retrieval of multilingual news feeds, filterable by category (e.g., news, research reports, price alerts) and language. Responses include news titles, authors, timestamps, related cryptocurrencies, multilingual content (HTML), cover images, multimedia resources, social media quotes, and engagement metrics (e.g., views, likes).

​Request Specification

GET /api/v1/news/featured

Request Parameters

Parameter	Type	Required	Description
pageNum	integer	Yes	Current page number
pageSize	integer	Yes	Number of news items per page (maximum: 100)
categoryList	array	No	List of category IDs. Defaults to: 1,2,3,4,5,6,7,9,10

Sample Request

GET "https://openapi.sosovalue.com/api/v1/news/featured?pageNum=1&pageSize=10&categoryList=1,2" \
  -H "x-soso-api-key: YOUR_x-soso-api-key"

Sample Response

{
    "code": 0,
    "msg": null,
    "traceId": "f3b4d6e5a7894cb3a872d0ef12345678",
    "data": {
        "pageNum": "1",
        "pageSize": "10",
        "totalPages": "34",
        "total": "335",
        "list": [
            {
                "id": "news1",
                "sourceLink": "https://sosovalue.xyz/research/1762712251829850112",
                "releaseTime": 1677151845000,
                "author": "作者1",
                "authorDescription": "blabla",
                "authorAvatarUrl": "https://...",
                "category": 1,
                "featureImage": "https://sosovalue.s3.us-west-2.amazonaws.com/sosovalue/2024/04/30/thumbnails/7909932c-e126-43ff-bec9-fea29a46bffb.png",
                "matchedCurrencies": [
                    {
                        "id": "1673723677362319866",
                        "fullName": "BITCOIN",
                        "name": "BTC"
                    }
                ],
                "tags": [
                    "ETF",
                    "DO KWON",
                    "TERRAFORM LABS",
                    "SEC"
                ],
                "multilanguageContent": [
                    {
                        "language": "en",
                        "title": "Ethereum spot ETF saw a net inflow of 78.89 million USD last week.",
                        "content": "htmlcontent"
                    },
                    {
                        "language": "zh",
                        "title": "上周，Ethereum现货ETF净流入达7889万美元。",
                        "content": "htmlcontent"
                    },
                    {
                        "language": "ja",
                        "title": "罗马帝国的兴衰",
                        "content": "htmlcontent"
                    }
                ],
                "mediaInfo": [
                    {
                        "sosoUrl": "https://static.sosovalue.com/media/GkkKXLxWEAEdHpy.jpg",
                        "originalUrl": "",
                        "shortUrl": "https://t.co/uYcKA72Ept",
                        "type": "photo"
                    },
                    {
                        "sosoUrl": "https://static.sosovalue.com/media/GkkKXLxWEAEdHpy.mp4",
                        "originalUrl": "",
                        "shortUrl": "https://t.co/FLZCHosHPs",
                        "type": "video"
                    }
                ],
                "nickName": "Shirtum ®",
                "quoteInfo": {
                    "multilanguageContent": [
                        {
                            "language": "en",
                            "content": "Wait, hold up"
                        },
                        {
                            "language": "zh",
                            "content": "Wait, hold up"
                        },
                        {
                            "language": "ja",
                            "content": "Wait, hold up"
                        }
                    ],
                    "impressionCount": 903,
                    "likeCount": 18,
                    "replyCount": 6,
                    "retweetCount": 3,
                    "twitterCreatedAt": 1724687710000,
                    "twitterMedia": [
                        {
                            "sosoUrl": "https://pbs.twimg.com/media/GkkKXLxWEAEdHpy.jpg",
                            "originalUrl": "https://t.co/uYcKA72Ept",
                            "type": "photo"
                        },
                        {
                            "sosoUrl": "",
                            "originalUrl": "https://t.co/FLZCHosHPs",
                            "type": "video"
                        },
                        {
                            "sosoUrl": "",
                            "originalUrl": "https://t.co/ndml0k7bte",
                            "type": "gif"
                        }
                    ],
                    "originalUrl": "https://x.com/Shirtum/status/1828098871874007446",
                    "authorAvatarUrl": "https://sosovalue.s3.us-west-2.amazonaws.com/sosovalue/2025/02/25/a89bbf07-1987-43d7-b47a-2c0beeca9010.jpg",
                    "author": "Shirtum",
                    "nickName": "Shirtum ®"
                }
            }
        ]
    }
}

Response Fields

Field	Type	Description
code	int	0 for success, 1 for failure
msg	string	Error message if any
traceId	string	Unique trace ID for debugging
data.pageNum	string	Current page number
data.pageSize	string	Number of items per page
data.totalPages	string	Total number of pages
data.total	string	Total number of news items
data.list	array	List of news item objects

News Item Fields (data.list)

Field	Type	Description
id	string	Unique identifier for the news item
sourceLink	string	The URL link to the source of the news
releaseTime	integer	Timestamp of the news release in milliseconds
author	string	Name of the author or source of the news
authorDescription	string	A brief description of the author (e.g., their background or expertise)
authorAvatarUrl	string	URL to the author's avatar image
category	integer	Category of the news: (1: news, 2: research, 3: institution, 4: insights, 5: macro news, 6: macro research, 7: official tweets, 9: price alert, 10: on-chain)
featureImage	string	URL to the feature image associated with the news
matchedCurrencies	array	List of currencies mentioned in the news item (e.g., BTC, ETH)
tags	array	Keywords or tags related to the news item (e.g., "ETF", "SEC")
multilanguageContent	array	An array containing the title and content in multiple languages
mediaInfo	array	List of media (photos, videos, etc.) associated with the news item
nickName	string	The nickname of the author or entity sharing the news
quoteInfo	object	Information about quotes, including impressions, likes, reposts, etc.

---

Explanation of quoteInfo Fields

Field	Type	Description
impressionCount	integer	Number of views or impressions of the quoted content
likeCount	integer	Number of likes on the quoted content
replyCount	integer	Number of replies or comments to the quoted content
retweetCount	integer	Number of retweets or shares of the quoted content
mediaInfo	array	List of media (photos, videos, etc.) associated with the quote
originalUrl	string	URL to the original quote on the platform
authorAvatarUrl	string	URL to the author's avatar image
author	string	Name of the author of the quote
nickName	string	The nickname of the person sharing the quote
isBlueVerified	integer	1 if the author is blue verified (Twitter or similar platform)
verifiedType	string	Type of verification (e.g., "Business" for a gold verification badge)

​