{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/content_analysis/indexed-search.json","title":"content_analysis/indexed-search 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":{"schema_version":{"type":["string","null"],"description":"indexed-web-v1."},"query":{"type":["string","null"],"description":"Keyword expression."},"scope":{"type":["string","null"],"description":"indexed_web_citations, separate from native social samples."},"window":{"type":"object","properties":{"date_from":{"type":["string","null"],"description":"Inclusive UTC date start or null."},"date_to":{"type":["string","null"],"description":"Inclusive UTC date end or null."},"date_basis":{"type":["string","null"],"description":"publication_date for search/summary, source_reporting_date for trends."},"timezone":{"type":["string","null"],"description":"UTC."},"end_inclusive":{"type":["boolean","null"],"description":"True."},"verified":{"type":["boolean","null"],"description":"True only when local publication filtering verified every returned record; aggregate source window enforcement is not established."}},"additionalProperties":true},"provenance":{"type":"object","properties":{"collection_method":{"type":["string","null"],"description":"indexed_web."},"observed_at":{"type":["string","null"],"description":"Request observation time."},"history_available_from":{"type":["string","null"],"description":"Earliest supported index history date; not a promise every keyword has data."},"coverage_complete":{"type":["boolean","null"],"description":"False; an index is not a census."},"coverage_identity":{"type":["string","null"],"description":"Null where no immutable index identity is supplied."},"query_fingerprint":{"type":["string","null"],"description":"Hash of query/filter measurement scope."}},"additionalProperties":true},"filters":{"type":"object","properties":{"language":{"type":["string","null"],"description":"Language filter."},"country":{"type":["string","null"],"description":"Publisher country, not audience location."},"page_types":{"type":"array","items":{"type":"string"}},"verified":{"type":["boolean","null"],"description":"Local record filter enforcement; aggregate filters are requested but not independently verified."}},"additionalProperties":true},"_warnings":{"type":"array","items":{"type":"string"}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Stable normalized citation id."},"url":{"type":["string","null"],"description":"Original URL."},"title":{"type":["string","null"],"description":"Page title."},"text":{"type":["string","null"],"description":"Source snippet."},"published_at":{"type":["string","null"],"description":"Publication date."},"observed_at":{"type":["string","null"],"description":"Source fetch date."},"sentiment":{"type":"object","properties":{"probabilities":{"type":"object","properties":{"positive":{"type":["number","null"],"description":"0–1 source probability."},"negative":{"type":["number","null"],"description":"0–1 source probability."},"neutral":{"type":["number","null"],"description":"0–1 source probability."}},"additionalProperties":true}},"additionalProperties":true},"source_group_date":{"type":["string","null"],"description":"Source grouped date; can refer to publication OR first crawler visit."},"source_group_date_basis":{"type":["string","null"],"description":"Source meaning of group date. Never assume it is first-seen time."}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["id"],"properties":{"id":{"type":["string"],"description":"Stable normalized citation id.","minLength":1}}},{"required":["url"],"properties":{"url":{"type":["string"],"description":"Original URL.","minLength":1}}},{"required":["title"],"properties":{"title":{"type":["string"],"description":"Page title.","minLength":1}}},{"required":["text"],"properties":{"text":{"type":["string"],"description":"Source snippet.","minLength":1}}},{"required":["published_at"],"properties":{"published_at":{"type":["string"],"description":"Publication date.","minLength":1}}},{"required":["observed_at"],"properties":{"observed_at":{"type":["string"],"description":"Source fetch date.","minLength":1}}},{"required":["sentiment"],"properties":{"sentiment":{"type":"object","properties":{"probabilities":{"type":"object","properties":{"positive":{"type":["number","null"],"description":"0–1 source probability."},"negative":{"type":["number","null"],"description":"0–1 source probability."},"neutral":{"type":["number","null"],"description":"0–1 source probability."}},"additionalProperties":true}},"additionalProperties":true}}},{"required":["source_group_date"],"properties":{"source_group_date":{"type":["string"],"description":"Source grouped date; can refer to publication OR first crawler visit.","minLength":1}}},{"required":["source_group_date_basis"],"properties":{"source_group_date_basis":{"type":["string"],"description":"Source meaning of group date. Never assume it is first-seen time.","minLength":1}}}]}]}},"count":{"type":["number","null"],"description":"Returned citation count."},"total_count":{"type":["number","null"],"description":"Source match count, not necessarily retrievable in full."},"cursor":{"type":["string","null"],"description":"Offset continuation; null when no next page is supplied."},"has_more":{"type":["boolean","null"],"description":"Source continuation signal."},"discarded_outside_window":{"type":["number","null"],"description":"Source results removed because dates were missing or outside the explicit publication window."},"total_count_scope":{"type":["string","null"],"description":"source_reported_before_local_filtering; not the count after local date/language/country checks."}},"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":[{"schema_version":"indexed-web-v1","query":"My Brand","scope":"indexed_web_citations","items":[],"count":0,"total_count":0,"cursor":null,"has_more":false}]}