{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/x/user-media.json","title":"x/user-media data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]},"cursor":{"description":"Opaque next-page token; pass it back unchanged. Null does not prove complete history.","type":["string","null"]},"dropped":{"description":"Optional dropped supplied by this operation. Null means unknown.","type":["number","null"]},"has_more":{"description":"Source continuation indicator; null means unknown.","type":["boolean","null"]},"items":{"description":"Returned records. Source coverage and completeness vary.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":"object","properties":{"author":{"description":"Public author information supplied with this record.","type":["object","null"],"properties":{"avatar_url":{"description":"Optional avatar url supplied by this operation. Null means unknown.","type":["string","null"]},"bio":{"description":"Optional bio supplied by this operation. Null means unknown.","type":["string","null"]},"bio_link":{"description":"Optional bio link supplied by this operation. Null means unknown.","type":["string","null"]},"cover_url":{"description":"Optional cover url supplied by this operation. Null means unknown.","type":["string","null"]},"created_at":{"description":"Source creation time, not the API retrieval time.","type":["string","null"]},"followers":{"description":"Optional followers supplied by this operation. Null means unknown.","type":["number","null"]},"following":{"description":"Optional following supplied by this operation. Null means unknown.","type":["number","null"]},"handle":{"description":"Optional handle supplied by this operation. Null means unknown.","type":["string","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"location":{"description":"Optional location supplied by this operation. Null means unknown.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"platform":{"description":"Optional platform supplied by this operation. Null means unknown.","type":["string","null"]},"tweets_count":{"description":"Optional tweets count supplied by this operation. Null means unknown.","type":["number","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"verified_blue":{"description":"Optional verified blue supplied by this operation. Null means unknown.","type":["boolean","null"]}},"additionalProperties":true},"created_at":{"description":"Source creation time, not the API retrieval time.","type":["string","null"]},"duration_s":{"description":"Optional duration s supplied by this operation. Null means unknown.","type":["number","null"]},"engagement":{"description":"Optional engagement supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"likes":{"description":"Optional likes supplied by this operation. Null means unknown.","type":["number","null"]},"replies":{"description":"Optional replies supplied by this operation. Null means unknown.","type":["number","null"]},"reposts":{"description":"Optional reposts supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"hashtags":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"images":{"description":"Optional images supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"lang":{"description":"Optional lang supplied by this operation. Null means unknown.","type":["string","null"]},"links":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"media":{"description":"Optional media supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true}},"media_urls":{"description":"Optional media urls supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"mentions":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"platform":{"description":"Optional platform supplied by this operation. Null means unknown.","type":["string","null"]},"reply":{"description":"Optional reply supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"conversation_id":{"description":"Optional conversation id supplied by this operation. Null means unknown.","type":["string","null"]},"is_reply":{"description":"Optional is reply supplied by this operation. Null means unknown.","type":["boolean","null"]}},"additionalProperties":true},"source":{"description":"Optional source supplied by this operation. Null means unknown.","type":["string","null"]},"stats":{"description":"Optional stats supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"bookmarks":{"description":"Optional bookmarks supplied by this operation. Null means unknown.","type":["number","null"]},"likes":{"description":"Optional likes supplied by this operation. Null means unknown.","type":["number","null"]},"quotes":{"description":"Optional quotes supplied by this operation. Null means unknown.","type":["number","null"]},"replies":{"description":"Optional replies supplied by this operation. Null means unknown.","type":["number","null"]},"retweets":{"description":"Optional retweets supplied by this operation. Null means unknown.","type":["number","null"]},"views":{"description":"Optional views supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"text":{"description":"Source text when supplied.","type":["string","null"]},"thumbnail_url":{"description":"Optional thumbnail url supplied by this operation. Null means unknown.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"video_url":{"description":"Optional video url supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["author"],"properties":{"author":{"description":"Public author information supplied with this record.","type":["object"],"properties":{"avatar_url":{"description":"Optional avatar url supplied by this operation. Null means unknown.","type":["string","null"]},"bio":{"description":"Optional bio supplied by this operation. Null means unknown.","type":["string","null"]},"bio_link":{"description":"Optional bio link supplied by this operation. Null means unknown.","type":["string","null"]},"cover_url":{"description":"Optional cover url supplied by this operation. Null means unknown.","type":["string","null"]},"created_at":{"description":"Source creation time, not the API retrieval time.","type":["string","null"]},"followers":{"description":"Optional followers supplied by this operation. Null means unknown.","type":["number","null"]},"following":{"description":"Optional following supplied by this operation. Null means unknown.","type":["number","null"]},"handle":{"description":"Optional handle supplied by this operation. Null means unknown.","type":["string","null"]},"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string","null"]},"location":{"description":"Optional location supplied by this operation. Null means unknown.","type":["string","null"]},"name":{"description":"Optional name supplied by this operation. Null means unknown.","type":["string","null"]},"platform":{"description":"Optional platform supplied by this operation. Null means unknown.","type":["string","null"]},"tweets_count":{"description":"Optional tweets count supplied by this operation. Null means unknown.","type":["number","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]},"verified_blue":{"description":"Optional verified blue supplied by this operation. Null means unknown.","type":["boolean","null"]}},"additionalProperties":true}}},{"required":["created_at"],"properties":{"created_at":{"description":"Source creation time, not the API retrieval time.","type":["string"],"minLength":1}}},{"required":["duration_s"],"properties":{"duration_s":{"description":"Optional duration s supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["engagement"],"properties":{"engagement":{"description":"Optional engagement supplied by this operation. Null means unknown.","type":["object"],"properties":{"likes":{"description":"Optional likes supplied by this operation. Null means unknown.","type":["number","null"]},"replies":{"description":"Optional replies supplied by this operation. Null means unknown.","type":["number","null"]},"reposts":{"description":"Optional reposts supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["hashtags"],"properties":{"hashtags":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array"],"items":{}}}},{"required":["id"],"properties":{"id":{"description":"Source identifier. Preserve the supplied type and exact value.","type":["string"],"minLength":1}}},{"required":["images"],"properties":{"images":{"description":"Optional images supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}}}},{"required":["lang"],"properties":{"lang":{"description":"Optional lang supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["links"],"properties":{"links":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array"],"items":{}}}},{"required":["media"],"properties":{"media":{"description":"Optional media supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true}}}},{"required":["media_urls"],"properties":{"media_urls":{"description":"Optional media urls supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}}}},{"required":["mentions"],"properties":{"mentions":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array"],"items":{}}}},{"required":["reply"],"properties":{"reply":{"description":"Optional reply supplied by this operation. Null means unknown.","type":["object"],"properties":{"conversation_id":{"description":"Optional conversation id supplied by this operation. Null means unknown.","type":["string","null"]},"is_reply":{"description":"Optional is reply supplied by this operation. Null means unknown.","type":["boolean","null"]}},"additionalProperties":true}}},{"required":["source"],"properties":{"source":{"description":"Optional source supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["stats"],"properties":{"stats":{"description":"Optional stats supplied by this operation. Null means unknown.","type":["object"],"properties":{"bookmarks":{"description":"Optional bookmarks supplied by this operation. Null means unknown.","type":["number","null"]},"likes":{"description":"Optional likes supplied by this operation. Null means unknown.","type":["number","null"]},"quotes":{"description":"Optional quotes supplied by this operation. Null means unknown.","type":["number","null"]},"replies":{"description":"Optional replies supplied by this operation. Null means unknown.","type":["number","null"]},"retweets":{"description":"Optional retweets supplied by this operation. Null means unknown.","type":["number","null"]},"views":{"description":"Optional views supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["text"],"properties":{"text":{"description":"Source text when supplied.","type":["string"],"minLength":1}}},{"required":["thumbnail_url"],"properties":{"thumbnail_url":{"description":"Optional thumbnail url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["url"],"properties":{"url":{"description":"Original source URL when supplied.","type":["string"],"minLength":1}}},{"required":["video_url"],"properties":{"video_url":{"description":"Optional video url supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}}]}]}}},"additionalProperties":true,"required":["items"],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"count":0,"cursor":null,"dropped":0,"has_more":false,"items":[{"author":{"avatar_url":"https://example.com/example","bio":"example","bio_link":"https://example.com/example","cover_url":"https://example.com/example","created_at":"2026-09-01T12:00:00Z","followers":0,"following":0,"handle":"example","id":"example","location":"example","name":"example","platform":"example","tweets_count":0,"url":"https://example.com/example","verified_blue":false},"created_at":"2026-09-01T12:00:00Z","duration_s":0,"engagement":{"likes":0,"replies":0,"reposts":0},"hashtags":[],"id":"example","images":["example"],"lang":"example","links":[],"media":[{}],"media_urls":["example"],"mentions":[],"platform":"example","reply":{"conversation_id":"example","is_reply":false},"source":"example","stats":{"bookmarks":0,"likes":0,"quotes":0,"replies":0,"retweets":0,"views":0},"text":"example","thumbnail_url":"https://example.com/example","url":"https://example.com/example","video_url":"https://example.com/example"}]}]}