List is a JSON Structure definition published by X (Twitter), describing 8 properties, of which 2 are required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.
{
"$schema": "https://json-structure.org/meta/core/v0/#",
"$id": "https://raw.githubusercontent.com/api-evangelist/twitter/refs/heads/main/json-structure/x-api-list-structure.json",
"name": "List",
"description": "A X List is a curated group of accounts.",
"type": "object",
"properties": {
"created_at": {
"type": "datetime"
},
"description": {
"type": "string"
},
"follower_count": {
"type": "int32"
},
"id": {
"type": "string",
"description": "The unique identifier of this List.",
"pattern": "^[0-9]{1,19}$",
"example": "1146654567674912769"
},
"member_count": {
"type": "int32"
},
"name": {
"type": "string",
"description": "The name of this List."
},
"owner_id": {
"type": "string",
"description": "Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.",
"pattern": "^[0-9]{1,19}$",
"example": "2244994945"
},
"private": {
"type": "boolean"
}
},
"required": [
"id",
"name"
]
}
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.