API ReferenceX
Discover content
Search X content by keyword or hashtag.
This is content search. search is X user search; the two stay separate so each endpoint always returns one shape.
Returns the first page only; pagination isn't exposed yet.
Cost: 2 credits per successful call.
Authorization
ApiKeyAuth X-API-Key<token>
Required on every request. Keys are issued manually during early access, see Authentication.
In: header
Query Parameters
query*string
Keyword or #hashtag to search for.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/x/discover?query=cats"{ "success": true, "platform": "x", "data": [ { "id": "2102095151535702226", "text": "NET'S CATS FAMILY🖤🐱♎\nHBD na🥳🎂🎉\nWe're singing🎶\nWe're dancing🦀\nHBD to us all✌🏻😆✌🏻\n@netsiraphop \n\nNET AT MAMI SCREEN GLOW DAY\n#MamiScreenGlowDayWithNet \n#MamixNet\n#netsiraphop", "likes": 0, "comments": 0 } ], "meta": { "credits_used": 2 }}