6.1 News Feed

GET /news

Query Parameters

Parameter
Type
Required
Description

category

string

No

Type: 1 (news), 2 (research), 3 (institution), 4 (insights/KOL), 7 (announcement/official), 13 (crypto stock news)

language

string

No

Response language; defaults to English

currency_id

String

No

Currency ID filter

project_id

String

No

Project ID filter

page

integer

No

Page number, default 1

page_size

integer

No

Items per page, default 20, max 100

start_time

timestamp

No

Start time (millisecond timestamp) for release_time filter. Only the most recent 7 days are supported

end_time

timestamp

No

End time (millisecond timestamp) for release_time filter. Only the most recent 7 days are supported

Response Example

{
    "page": 1,
    "page_size": 20,
    "total": 335,
    "list": [
        {
            "id": "news1",
            "source_link": "https://sosovalue.xyz/research/1762712251829850112",
            "original_link": "https://sosovalue.xyz/research/1762712251829850112",
            "release_time": 1677151845000,
            "title": "The Rise and Fall of the Roman Empire",
            "content": "<p>HTML formatted content...</p>",
            "author": "Author Name",
            "author_description": "Crypto analyst & researcher",
            "author_avatar_url": "https://...",
            "impression_count": 432,
            "like_count": 6,
            "reply_count": 0,
            "retweet_count": 3,
            "category": 1,
            "feature_image": "https://...",
            "nick_name": "Shirtum ®",
            "is_blue_verified": 1,
            "verified_type": "Business",
            "matched_currencies": [
                {
                    "id": "1673723677362319866",
                    "full_name": "BITCOIN",
                    "name": "BTC"
                }
            ],
            "tags": ["ETF", "DO KWON", "TERRAFORM LABS", "SEC"],
            "media_info": [
                {
                    "soso_url": "https://static.sosovalue.com/media/example.jpg",
                    "original_url": "",
                    "short_url": "https://t.co/example",
                    "type": "photo"
                }
            ],
            "quote_info": {
                "content": "Quoted tweet content",
                "impression_count": 903,
                "like_count": 18,
                "reply_count": 6,
                "retweet_count": 3,
                "created_at": 1724687710000,
                "media_info": [...],
                "original_url": "https://x.com/user/status/1828098871874007446",
                "author_avatar_url": "https://...",
                "author": "Shirtum",
                "nick_name": "Shirtum ®",
                "is_blue_verified": 1,
                "verified_type": "Business"
            }
        }
    ]
}

Response Fields - list item

Field
Type
Description

id

String

Unique news identifier

source_link

String

SoSoValue platform link

original_link

String

Original source URL

release_time

Long

Publish time, millisecond timestamp

author

String

Author name (Twitter @username)

author_description

String

Author bio (English)

author_avatar_url

String

Author avatar URL

impression_count

Integer

Impression count

like_count

Integer

Like count

reply_count

Integer

Reply count

retweet_count

Integer

Retweet count

category

Integer

News category; see category descriptions above

feature_image

String

Cover image URL

nick_name

String

Twitter display name

is_blue_verified

Integer

Blue verification status: 1 = verified, 0/null = not verified

verified_type

String

Verification type: "Business" = gold badge (enterprise); others = regular blue badge

title

String

News title (in requested language)

content

String

News body in HTML format (in requested language)

matched_currencies

Array[Object]

Matched currencies list; may be empty

tags

Array[String]

News tags

media_info

Array[Object]

Media attachments

quote_info

Object / null

Quoted tweet info; null for non-Twitter news

Supported HTML tags in content: div, p, span, h1-h6, li, ol, ul, figcaption, figure, font, img, picture, strong, b, a, blockquote, br

matched_currencies Fields

Field
Type
Description

id

String

Currency ID

full_name

String

Currency full name (e.g. BITCOIN)

name

String

Currency symbol (e.g. BTC)

media_info Fields

Field
Type
Description

soso_url

String

SoSoValue CDN media URL

original_url

String

Original media URL (may be empty)

short_url

String

Short URL

type

String

Media type: photo, video, gif

quote_info Fields

Field
Type
Description

content

String

Quoted content (in requested language)

impression_count

Long

Impressions of quoted tweet

like_count

Long

Likes of quoted tweet

reply_count

Long

Replies of quoted tweet

retweet_count

Long

Retweets of quoted tweet

created_at

Long

Quoted tweet publish time, millisecond timestamp

media_info

Array[Object]

Media in quoted tweet (same structure as above)

original_url

String

Original URL of quoted tweet

author_avatar_url

String

Quoted author avatar URL

author

String

Quoted author @username

nick_name

String

Quoted author display name

is_blue_verified

Integer

Quoted author blue verification status

verified_type

String

Quoted author verification type

Language Enum

Value
Language

en

English (default)

zh

Simplified Chinese

tc

Traditional Chinese

ja

Japanese

vi

Vietnamese

es

Spanish

pt

Portuguese

ru

Russian

tr

Turkish

fr

French

Notes

  • title and content are returned in the requested language. quote_info.content follows the same rule.

  • List order reflects platform display order; no client-side sorting needed.

  • matched_currencies may be an empty array.

  • Maximum 200 news items per request.

  • start_time / end_time filters by release_time.

  • start_time / end_time only support the most recent 7 days.

Last updated