{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/linkedin/search-posts-native.json","title":"linkedin/search-posts-native data fields","description":"Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.","type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"url":{"type":["string","null"],"description":"Original source URL when supplied."},"platform":{"type":["string","null"],"description":"platform"},"title":{"type":["string","null"],"description":"Null for an ordinary post; not inferred from content."},"text":{"type":["string","null"],"description":"text"},"caption":{"type":["string","null"],"description":"caption"},"created_at":{"type":["string","null"],"description":"created at"},"author":{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"handle":{"type":["string","null"],"description":"handle"},"name":{"type":["string","null"],"description":"name"},"url":{"type":["string","null"],"description":"url"},"headline":{"type":["string","null"],"description":"headline"},"location":{"type":["string","null"],"description":"location"},"avatar_url":{"type":["string","null"],"description":"avatar url"},"followers":{"type":["number","null"],"description":"Public follower count."},"verified":{"type":["boolean","null"],"description":"Explicit verification flag when supplied."},"type":{"type":["string","null"],"description":"person or company when supplied."},"website":{"type":["string","null"],"description":"Original source URL when supplied."},"website_label":{"type":["string","null"],"description":"Public website label."}},"additionalProperties":true},"stats":{"type":["object","null"],"properties":{"likes":{"type":["number","null"],"description":"likes; null is unknown."},"comments":{"type":["number","null"],"description":"comments; null is unknown."},"replies":{"type":["number","null"],"description":"replies; null is unknown."},"shares":{"type":["number","null"],"description":"shares; null is unknown."},"views":{"type":["number","null"],"description":"views; null is unknown."}},"additionalProperties":true},"article":{"type":["object","null"],"properties":{"title":{"type":["string","null"],"description":"Attached article title, not the post title."},"url":{"type":["string","null"],"description":"Original source URL when supplied."},"description":{"type":["string","null"],"description":"Attached article description."}},"additionalProperties":true}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["id"],"properties":{"id":{"type":["string"],"description":"Exact source identifier; preserve it as a string.","minLength":1}}},{"required":["url"],"properties":{"url":{"type":["string"],"description":"Original source URL when supplied.","minLength":1}}},{"required":["title"],"properties":{"title":{"type":["string"],"description":"Null for an ordinary post; not inferred from content.","minLength":1}}},{"required":["text"],"properties":{"text":{"type":["string"],"description":"text","minLength":1}}},{"required":["caption"],"properties":{"caption":{"type":["string"],"description":"caption","minLength":1}}},{"required":["created_at"],"properties":{"created_at":{"type":["string"],"description":"created at","minLength":1}}},{"required":["author"],"properties":{"author":{"type":["object"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"handle":{"type":["string","null"],"description":"handle"},"name":{"type":["string","null"],"description":"name"},"url":{"type":["string","null"],"description":"url"},"headline":{"type":["string","null"],"description":"headline"},"location":{"type":["string","null"],"description":"location"},"avatar_url":{"type":["string","null"],"description":"avatar url"},"followers":{"type":["number","null"],"description":"Public follower count."},"verified":{"type":["boolean","null"],"description":"Explicit verification flag when supplied."},"type":{"type":["string","null"],"description":"person or company when supplied."},"website":{"type":["string","null"],"description":"Original source URL when supplied."},"website_label":{"type":["string","null"],"description":"Public website label."}},"additionalProperties":true}}},{"required":["stats"],"properties":{"stats":{"type":["object"],"properties":{"likes":{"type":["number","null"],"description":"likes; null is unknown."},"comments":{"type":["number","null"],"description":"comments; null is unknown."},"replies":{"type":["number","null"],"description":"replies; null is unknown."},"shares":{"type":["number","null"],"description":"shares; null is unknown."},"views":{"type":["number","null"],"description":"views; null is unknown."}},"additionalProperties":true}}},{"required":["article"],"properties":{"article":{"type":["object"],"properties":{"title":{"type":["string","null"],"description":"Attached article title, not the post title."},"url":{"type":["string","null"],"description":"Original source URL when supplied."},"description":{"type":["string","null"],"description":"Attached article description."}},"additionalProperties":true}}}]}]}},"count":{"type":["number","null"],"description":"Returned rows, not the total population."},"cursor":{"type":["string","null"],"description":"Opaque continuation; pass unchanged."},"has_more":{"type":["boolean","null"],"description":"Source continuation indicator."},"total":{"type":["number","null"],"description":"Source-reported total; null means unknown."},"source_total":{"type":["number","null"],"description":"Unverified changing source total before local filtering."},"retrieved_count":{"type":["number","null"],"description":"Rows acquired before date filtering."},"date_filter":{"type":["object","null"],"properties":{"scope":{"type":["string","null"],"description":"scope"},"date_posted":{"type":["string","null"],"description":"date posted"},"date_from":{"type":["string","null"],"description":"date from"},"date_to":{"type":["string","null"],"description":"date to"},"since":{"type":["string","null"],"description":"since"},"until":{"type":["string","null"],"description":"until"},"unknown_date_count":{"type":["number","null"],"description":"unknown date count; null is unknown."},"excluded_count":{"type":["number","null"],"description":"excluded count; null is unknown."}},"additionalProperties":true},"fetched_at":{"type":["string","null"],"description":"Source date or timestamp; absent dates remain unknown."},"completeness":{"type":["string","null"],"description":"Always unknown; no exhaustive coverage or freshness guarantee."}},"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":[{"items":[],"count":0,"retrieved_count":0,"cursor":null,"has_more":false,"total":null,"source_total":0,"completeness":"unknown"}]}