Retrieve article details
Returns tweet with an article attached to it. Output contains the same properies as tweet details endpoint, article content is returned within "article" attribute of the response.
Endpoint
GET https://api.socialdata.tools/twitter/article/[article_id]Endpoint parameters
Name
Description
Example
article_id (Required)
The numerical ID of the desired article tweet.
1799137410284134858
Common Issues and Best Practices
In languages where the
article_idvalue exceeds the default Integer type limit (e.g., Node.js), storearticle_idas a string. Use theid_strproperty returned by the API for these values
Response codes
HTTP 200 OK - succeeded
HTTP 402 Payment Required - not enough credits to perform this request
HTTP 404 Not Found - requested tweet does not exist
HTTP 422 Unprocessable Content - validation failed (e.g. one of the required parameters was not provided)
HTTP 500 Internal Server Error - other error, typically means that SocialData API failed to obtain the requested information and you should try again later
Rate limits
By default each user has a limit of 120 requests per minute shared across all endpoints. Please reach out to support@socialdata.tools if you need to raise your rate limit.
Example request
curl "https://api.socialdata.tools/twitter/article/1799137410284134858"
-H 'Authorization: Bearer API_KEY'
-H 'Accept: application/json'Example response
// If succeeded:
{
"created_at": "2024-06-07T17:52:39+00:00",
"tweet_created_at": "2024-06-07T17:52:39+00:00",
"id": 1799137410284134858,
"id_str": "1799137410284134858",
"text": null,
"full_text": "https:\/\/t.co\/54xBGHRtwm",
"source": "<a href=\"https:\/\/mobile.twitter.com\" rel=\"nofollow\">Twitter Web App<\/a>",
"truncated": false,
"in_reply_to_status_id": null,
"in_reply_to_status_id_str": null,
"in_reply_to_user_id": null,
"in_reply_to_user_id_str": null,
"in_reply_to_screen_name": null,
"user": {
"id": 1034554665109676033,
"id_str": "1034554665109676033",
"name": "Upland",
"screen_name": "UplandMe",
"location": "Upland Metaverse 👉",
"url": "https:\/\/www.upland.me\/",
"description": "Make history. Digitally. Build your empire... in Upland, the ultimate property trading game. Construct your empire & Elevate your digital life. 🦙",
"protected": false,
"verified": true,
"followers_count": 117215,
"friends_count": 1071,
"listed_count": 390,
"favourites_count": 14455,
"statuses_count": 10774,
"created_at": "2018-08-28T21:33:48+00:00",
"profile_banner_url": "https:\/\/pbs.twimg.com\/profile_banners\/1034554665109676033\/1712265999",
"profile_image_url_https": "https:\/\/pbs.twimg.com\/profile_images\/1702695579157958656\/ufOqEStf_normal.jpg",
"can_dm": false
},
"user_id": 1034554665109676033,
"user_screen_name": "UplandMe",
"quoted_status_id": null,
"quoted_status_id_str": null,
"is_quote_status": false,
"quoted_status": null,
"retweeted_status": null,
"quote_count": 2,
"reply_count": 8,
"retweet_count": 25,
"favorite_count": 77,
"views_count": 2796,
"bookmark_count": 0,
"lang": "zxx",
"entities": {
"hashtags": [],
"symbols": [],
"timestamps": [],
"urls": [
{
"display_url": "x.com\/i\/article\/1799…",
"expanded_url": "http:\/\/x.com\/i\/article\/1799136519384711168",
"url": "https:\/\/t.co\/54xBGHRtwm",
"indices": [
0,
23
]
}
],
"user_mentions": []
},
"article": {
"published_at": "2024-06-07T17:52:39+00:00",
"id": 1799137410284134858,
"id_str": "1799137410284134858",
"title": "Introducing Upland Neighborhood Bundles",
"preview_text": "As Upland continues to grow and solidify its position as the premier web3 metaverse, we recognize the need to offer entire exclusive neighborhoods to our partners and large communities eager to join",
"cover_url": "https:\/\/pbs.twimg.com\/media\/GPfRKLpaIAAQzNL.jpg",
"content_state": {
"blocks": [
{
"key": "3url3",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 21,
"offset": 32,
"style": "Bold"
},
{
"length": 23,
"offset": 60,
"style": "Bold"
},
{
"length": 30,
"offset": 116,
"style": "Bold"
},
{
"length": 30,
"offset": 154,
"style": "Bold"
}
],
"text": "As Upland continues to grow and solidify its position as the premier web3 metaverse, we recognize the need to offer entire exclusive neighborhoods to our partners and large communities eager to join us.",
"type": "unstyled"
},
{
"key": "dgdrr",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 20,
"offset": 96,
"style": "Bold"
},
{
"length": 21,
"offset": 210,
"style": "Bold"
}
],
"text": "Unveiled moments ago at Genesis LIVE, we are thrilled to announce a groundbreaking new concept: Neighborhood Bundles. This innovation comes as a direct result of our successful Bermuda proof of concept and the collaborative efforts with Sandbox.",
"type": "unstyled"
},
{
"key": "4561q",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 25,
"offset": 57,
"style": "Bold"
},
{
"length": 21,
"offset": 109,
"style": "Bold"
}
],
"text": "This initiative has been crafted with an eye towards our anticipated future growth, preparing Upland for the exciting developments ahead.",
"type": "unstyled"
},
{
"key": "9b1h2",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [],
"text": "What are Neighborhood Bundles?",
"type": "header-one"
},
{
"key": "4qi2h",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 18,
"offset": 27,
"style": "Bold"
},
{
"length": 9,
"offset": 47,
"style": "Bold"
},
{
"length": 19,
"offset": 64,
"style": "Bold"
},
{
"length": 20,
"offset": 96,
"style": "Bold"
}
],
"text": "Neighborhood Bundles allow larger communities, partners and our dedicated community to purchase entire neighborhoods within Upland.",
"type": "unstyled"
},
{
"key": "e882e",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 17,
"offset": 29,
"style": "Bold"
},
{
"length": 13,
"offset": 55,
"style": "Bold"
}
],
"text": "Neighborhood bundles will be extremely limited and are priced in ETH, with unique discounts applied. The prices are coupled with USD and may fluctuate accordingly. Upon purchasing a bundle, buyers will have the option to:",
"type": "unstyled"
},
{
"key": "vbm1",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 8,
"offset": 0,
"style": "Bold"
}
],
"text": "Mint all or some of the neighborhood properties under their name.",
"type": "unordered-list-item"
},
{
"key": "4l3e5",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 8,
"offset": 0,
"style": "Bold"
}
],
"text": "Open all or some of the properties for sale, with minting proceeds sent to the buyer’s account monthly.",
"type": "unordered-list-item"
},
{
"key": "5vfe8",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 21,
"offset": 0,
"style": "Bold"
}
],
"text": "Choose a combination of both options.",
"type": "unordered-list-item"
},
{
"key": "fajgh",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [],
"text": "Available Neighborhood Bundles",
"type": "header-one"
},
{
"key": "8818q",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [],
"text": "The following bundles are currently available in the Upland Web store:",
"type": "unstyled"
},
{
"key": "68am",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [],
"text": "QUEENSRIDGE, Las Vegas",
"type": "header-one"
},
{
"key": "8l94s",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 1,
"offset": 74,
"style": "Bold"
}
],
"text": "Own the entire luxurious Queensridge neighborhood in Las Vegas, comprising 994 properties, at a 45% discount from the market price.",
"type": "unstyled"
},
{
"key": "dchfc",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 5,
"offset": 0,
"style": "Bold"
}
],
"text": "Price: 6.99 ETH",
"type": "unstyled"
},
{
"key": "1gnda",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [],
"text": "WYNWOOD INDUSTRIAL DISTRICT, Miami",
"type": "header-one"
},
{
"key": "6lad",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [],
"text": "Take ownership of the exclusive Wynwood Industrial District neighborhood in Miami, with 308 properties, at a 35% discount from the market price.",
"type": "unstyled"
},
{
"key": "cd7u",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 5,
"offset": 0,
"style": "Bold"
}
],
"text": "Price: 10.79 ETH",
"type": "unstyled"
},
{
"key": "3c6j5",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [],
"text": "TREASURE ISLAND, San Francisco",
"type": "header-one"
},
{
"key": "9cl5s",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [],
"text": "Claim the entire coveted Treasure Island in San Francisco, including 851 properties, at a 20% discount from the market price.",
"type": "unstyled"
},
{
"key": "8o5ks",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 5,
"offset": 0,
"style": "Bold"
}
],
"text": "Price: 19.56 ETH",
"type": "unstyled"
},
{
"key": "ckor1",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 61,
"offset": 0,
"style": "Bold"
},
{
"length": 61,
"offset": 0,
"style": "Italic"
}
],
"text": "Note: Prices may fluctuate based on the current price of ETH.",
"type": "unstyled"
},
{
"key": "8hi6n",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [],
"text": "A Unique Opportunity",
"type": "header-one"
},
{
"key": "7g1kq",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 25,
"offset": 64,
"style": "Bold"
},
{
"length": 28,
"offset": 115,
"style": "Bold"
}
],
"text": "Again, this initiative has been crafted with an eye towards our anticipated future growth, preparing Upland for the exciting developments ahead.",
"type": "unstyled"
},
{
"key": "92m66",
"data": [],
"entityRanges": [],
"inlineStyleRanges": [
{
"length": 21,
"offset": 26,
"style": "Bold"
},
{
"length": 20,
"offset": 106,
"style": "Bold"
},
{
"length": 26,
"offset": 133,
"style": "Bold"
},
{
"length": 17,
"offset": 164,
"style": "Bold"
},
{
"length": 8,
"offset": 183,
"style": "Bold"
},
{
"length": 15,
"offset": 205,
"style": "Bold"
}
],
"text": "Whether you’re looking to build a community hub, or simply expand your digital real estate portfolio, our Neighborhood Bundles offer unparalleled opportunities for large communities, partners and dedicated Upland players.",
"type": "unstyled"
}
],
"entityMap": []
},
"media_entities": []
}
}
// If failed:
{
"status":"error",
"message":"Tweet not found"
}Last updated
