Opoint · Schema

SearchResultSchema

Top-level search result wrapper. The searchresult field contains either a successful SearchResponse or a SearchError.

CompanyNewsNews DataMedia MonitoringSearchFeedAdverse MediaComplianceFinancial ServicesContent TrackingDenmark

Properties

Name Type Description
searchresult object The search result. Contains either a successful response with documents, or an error.
View JSON Schema on GitHub

JSON Schema

opoint-search-result-schema-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/opoint/json-schema/opoint-search-result-schema-schema.json",
  "title": "SearchResultSchema",
  "description": "Top-level search result wrapper.\n\nThe searchresult field contains either a successful SearchResponse\nor a SearchError.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/opoint-search-api-openapi.yml#/components/schemas/SearchResultSchema",
  "type": "object",
  "properties": {
    "searchresult": {
      "allOf": [
        {
          "$ref": "#/$defs/SearchResponseSchema"
        }
      ],
      "description": "The search result. Contains either a successful response with documents, or an error."
    }
  },
  "required": [
    "searchresult"
  ],
  "$defs": {
    "AlmostIdenticalSchema": {
      "type": "object",
      "properties": {
        "id_site": {
          "type": "integer"
        },
        "id_article": {
          "type": "integer"
        },
        "sim": {
          "type": "integer",
          "description": "Similarity score. Higher is more similar."
        }
      },
      "required": [
        "id_article",
        "id_site",
        "sim"
      ]
    },
    "ArticleImageSchema": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string"
        },
        "caption": {
          "$ref": "#/$defs/TextFieldSchema"
        }
      }
    },
    "ArticleImagesSchema": {
      "type": "object",
      "properties": {
        "count": {
          "type": "integer"
        },
        "articleimage": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ArticleImageSchema"
          }
        }
      },
      "required": [
        "articleimage",
        "count"
      ]
    },
    "ArticleMediaSchema": {
      "type": "object",
      "properties": {
        "url": {
          "type": "string"
        },
        "localurl": {
          "type": "string"
        },
        "thumbnail": {
          "type": "string"
        },
        "text": {
          "type": "string"
        }
      }
    },
    "ArticleReadershipSchema": {
      "type": "object",
      "properties": {
        "value": {
          "type": "integer",
          "description": "Estimated number of readers of the article so far."
        },
        "DeltaPValue": {
          "type": "integer",
          "description": "Predicted additional readers in the next hour."
        },
        "ExpectedPValue": {
          "type": "integer",
          "description": "Predicted number of people that will eventually read the article."
        },
        "StdExpectedPValue": {
          "type": "integer",
          "description": "Standard deviation of ExpectedPValue."
        },
        "P": {
          "type": "number",
          "format": "double",
          "description": "Estimated fraction of the site's readers having read the article so far."
        },
        "DeltaP": {
          "type": "number",
          "format": "double"
        },
        "ExpectedP": {
          "type": "number",
          "format": "double"
        },
        "StdExpectedP": {
          "type": "number",
          "format": "double"
        }
      }
    },
    "BodySchema": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string"
        },
        "matches": {
          "type": "boolean",
          "description": "Whether search matches are highlighted in this field."
        },
        "readmore": {
          "type": "boolean"
        },
        "truncated": {
          "type": "boolean"
        }
      },
      "required": [
        "text"
      ]
    },
    "DebugLineSchema": {
      "type": "object",
      "properties": {
        "state": {
          "type": "integer",
          "description": "1 if the line had an error, 0 otherwise."
        },
        "query": {
          "type": "string",
          "description": "What the query was interpreted as, if the line had errors corrected."
        }
      },
      "required": [
        "state"
      ]
    },
    "DebugSchema": {
      "type": "object",
      "properties": {
        "count": {
          "type": "integer"
        },
        "lines": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/DebugLineSchema"
          }
        }
      }
    },
    "DocumentSchema": {
      "type": "object",
      "description": "A single article/document in the search response.",
      "properties": {
        "id_site": {
          "type": "integer",
          "description": "Id of the site the article was published on."
        },
        "id_article": {
          "type": "integer",
          "description": "Site-specific article id, unique within each site."
        },
        "position": {
          "type": "integer",
          "description": "Index of the document in the result list (one-based)."
        },
        "unix_timestamp": {
          "type": "integer",
          "description": "Unix timestamp of when the article was published."
        },
        "stimestamp": {
          "type": "integer",
          "description": "Internal timestamp."
        },
        "stimestamp_index": {
          "type": "integer",
          "description": "Internal timestamp."
        },
        "header": {
          "$ref": "#/$defs/HeaderSchema"
        },
        "summary": {
          "$ref": "#/$defs/SummarySchema"
        },
        "body": {
          "$ref": "#/$defs/BodySchema"
        },
        "author": {
          "type": "string"
        },
        "word_count": {
          "type": "integer"
        },
        "short_header": {
          "$ref": "#/$defs/ShortFieldSchema"
        },
        "short_summary": {
          "$ref": "#/$defs/ShortFieldSchema"
        },
        "short_body": {
          "$ref": "#/$defs/ShortFieldSchema"
        },
        "translated_header": {
          "$ref": "#/$defs/TranslatedHeaderSchema"
        },
        "manual_summary": {
          "$ref": "#/$defs/TranslatedHeaderSchema"
        },
        "extract": {
          "type": "boolean"
        },
        "matches": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/MatchSchema"
          }
        },
        "quotes": {
          "$ref": "#/$defs/QuotesSchema"
        },
        "first_source": {
          "$ref": "#/$defs/FirstSourceSchema"
        },
        "sources": {
          "$ref": "#/$defs/SourcesSchema"
        },
        "topics": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/TopicSchema"
          }
        },
        "topics_and_entities": {
          "$ref": "#/$defs/TopicsAndEntitiesSchema"
        },
        "language": {
          "$ref": "#/$defs/LanguageSchema"
        },
        "countryname": {
          "type": "string"
        },
        "countrycode": {
          "type": "string"
        },
        "local_time": {
          "$ref": "#/$defs/LocalTimeSchema"
        },
        "local_rcf822_time": {
          "$ref": "#/$defs/Rfc822TimeSchema"
        },
        "orig_url": {
          "type": "string",
          "description": "URL where the article was found."
        },
        "url_common": {
          "type": "string",
          "description": "Domain name of the site where the article was found."
        },
        "url": {
          "type": "string",
          "description": "Link to tool displaying the crawled article."
        },
        "articleimages": {
          "$ref": "#/$defs/ArticleImagesSchema"
        },
        "caption": {
          "$ref": "#/$defs/TextFieldSchema"
        },
        "screenshots": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ScreenshotSchema"
          }
        },
        "articlemedia": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ArticleMediaSchema"
          }
        },
        "playlength": {
          "type": "integer",
          "description": "Length of timemap, if present, in seconds."
        },
        "mediafile": {
          "type": "integer"
        },
        "pdf_file": {
          "$ref": "#/$defs/PdfFileSchema"
        },
        "mediatype": {
          "$ref": "#/$defs/MediaTypeSchema"
        },
        "similarweb": {
          "$ref": "#/$defs/SimilarwebSchema"
        },
        "site_rank": {
          "$ref": "#/$defs/SiteRankSchema"
        },
        "meta_data": {
          "type": "object",
          "additionalProperties": {},
          "description": "Various metadata about the article, like social media engagement."
        },
        "identical_documents": {
          "$ref": "#/$defs/IdenticalDocumentsSchema"
        },
        "almost_identical": {
          "$ref": "#/$defs/AlmostIdenticalSchema"
        },
        "equalgroup": {
          "type": "integer"
        },
        "sort_group_ref": {
          "type": "integer"
        },
        "list_states": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ListStateSchema"
          }
        },
        "tags": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/TagSchema"
          }
        },
        "linkobs": {
          "$ref": "#/$defs/LinkobsSchema"
        },
        "internal_search_reply": {
          "$ref": "#/$defs/InternalSearchReplySchema"
        },
        "usercomments": {
          "$ref": "#/$defs/UserCommentsSchema"
        },
        "hidden": {
          "type": "boolean"
        },
        "existinbasket": {
          "type": "string"
        },
        "compare": {
          "type": "integer"
        },
        "content_protected": {
          "type": "integer"
        },
        "distribute_conditions": {
          "type": "string"
        },
        "circulation": {
          "type": "integer"
        },
        "adprice": {
          "type": "integer"
        },
        "reach": {
          "type": "integer"
        },
        "stored_search_id": {
          "type": "integer"
        },
        "profile_id": {
          "type": "integer"
        },
        "profile_name": {
          "type": "string"
        }
      },
      "required": [
        "id_article",
        "id_site",
        "position",
        "stimestamp",
        "stimestamp_index",
        "unix_timestamp"
      ]
    },
    "EntitiesSchema": {
      "type": "object",
      "properties": {
        "location": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/EntitySchema"
          }
        },
        "organization": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/EntitySchema"
          }
        },
        "person": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/EntitySchema"
          }
        }
      }
    },
    "EntitySchema": {
      "type": "object",
      "properties": {
        "entity": {
          "type": "string"
        },
        "wikidata_id": {
          "type": "string"
        },
        "crunchbase": {
          "type": "string"
        },
        "permid": {
          "type": "string"
        },
        "lei": {
          "type": "string"
        },
        "figi": {
          "type": "string"
        },
        "sentiment": {
          "type": "string"
        }
      },
      "required": [
        "entity"
      ]
    },
    "FirstSourceSchema": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        },
        "sitename": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "siteurl": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "name",
        "sitename",
        "siteurl",
        "url"
      ]
    },
    "HeaderSchema": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string"
        },
        "matches": {
          "type": "boolean",
          "description": "Whether search matches are highlighted in this field."
        },
        "compare": {
          "type": "integer",
          "description": "Edit distance between compare_header parameter and the header text."
        }
      },
      "required": [
        "text"
      ]
    },
    "IdenticalDocumentsSchema": {
      "type": "object",
      "properties": {
        "cnt": {
          "type": "integer"
        },
        "document": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": {}
          }
        }
      },
      "required": [
        "cnt"
      ]
    },
    "InternalSearchReplySchema": {
      "type": "object",
      "properties": {
        "id_site": {
          "type": "integer"
        },
        "id_article": {
          "type": "integer"
        },
        "text": {
          "type": "string"
        }
      },
      "required": [
        "id_article",
        "id_site",
        "text"
      ]
    },
    "IptcTopicSchema": {
      "type": "object",
      "properties": {
        "label": {
          "type": "string",
          "description": "IPTC Media Topic name, hierarchically structured with > separators."
        },
        "mediatopic_id": {
          "type": "string",
          "description": "IPTC Media Code."
        },
        "score": {
          "type": "number",
          "format": "double",
          "description": "Confidence score for the topic."
        }
      },
      "required": [
        "label",
        "mediatopic_id",
        "score"
      ]
    },
    "LanguageSchema": {
      "type": "object",
      "properties": {
        "encoding": {
          "type": "string"
        },
        "text": {
          "type": "string"
        }
      },
      "required": [
        "encoding",
        "text"
      ]
    },
    "LinkobSourceSchema": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer"
        },
        "depth": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        },
        "obs": {
          "$ref": "#/$defs/ObservationSchema"
        }
      }
    },
    "LinkobsSchema": {
      "type": "object",
      "properties": {
        "cnt": {
          "type": "integer"
        },
        "source": {
          "$ref": "#/$defs/LinkobSourceSchema"
        }
      },
      "required": [
        "cnt"
      ]
    },
    "ListStateSchema": {
      "type": "object",
      "properties": {
        "id_list": {
          "type": "integer"
        },
        "state": {
          "type": "integer"
        },
        "state_name": {
          "type": "string"
        }
      },
      "required": [
        "id_list",
        "state"
      ]
    },
    "LocalTimeSchema": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "ISO 8601 formatted time."
        },
        "GMT": {
          "type": "integer"
        }
      },
      "required": [
        "GMT",
        "text"
      ]
    },
    "MatchItemSchema": {
      "type": "object",
      "properties": {
        "rowspan": {
          "type": "integer"
        },
        "colspan": {
          "type": "integer"
        },
        "type": {
          "type": "string"
        },
        "color": {
          "type": "integer"
        },
        "active": {
          "type": "boolean"
        },
        "length": {
          "type": "integer"
        },
        "removed": {
          "type": "integer"
        },
        "text": {
          "type": "string"
        }
      }
    },
    "MatchSchema": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string"
        },
        "text": {
          "type": "string",
          "description": "Text that was matched. If wildcards are used this contains the actual word or phrase matched."
        },
        "color": {
          "type": "integer"
        },
        "play_offset": {
          "type": "integer",
          "description": "Offset of match in video or radio clip, in seconds."
        }
      },
      "required": [
        "color",
        "text",
        "type"
      ]
    },
    "MatchTableRowSchema": {
      "type": "object",
      "properties": {
        "match_item": {
          "$ref": "#/$defs/MatchItemSchema"
        }
      }
    },
    "MatchTableSchema": {
      "type": "object",
      "properties": {
        "rows": {
          "type": "integer"
        },
        "cols": {
          "type": "integer"
        },
        "row": {
          "$ref": "#/$defs/MatchTableRowSchema"
        }
      }
    },
    "MediaTypeSchema": {
      "type": "object",
      "properties": {
        "timemap": {
          "type": "boolean"
        },
        "duration": {
          "type": "integer",
          "description": "Length of timemap in seconds."
        },
        "clip": {
          "type": "boolean"
        },
        "hastext": {
          "type": "boolean"
        },
        "haslogo": {
          "type": "boolean"
        },
        "paywall": {
          "type": "boolean",
          "description": "Whether article was fetched from behind a paywall."
        },
        "fulltext": {
          "type": "boolean"
        },
        "text": {
          "type": "string"
        }
      },
      "required": [
        "clip",
        "fulltext",
        "haslogo",
        "hastext",
        "paywall",
        "text",
        "timemap"
      ]
    },
    "ObservationSchema": {
      "type": "object",
      "description": "Single link observation.",
      "properties": {
        "level": {
          "type": "string"
        },
        "images": {
          "type": "object",
          "additionalProperties": {}
        }
      }
    },
    "PdfFileSchema": {
      "type": "object",
      "properties": {
        "all": {
          "type": "string"
        },
        "args": {
          "type": "string"
        },
        "pdf_parts": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/PdfPartSchema"
          }
        }
      },
      "required": [
        "all",
        "args",
        "pdf_parts"
      ]
    },
    "PdfPartSchema": {
      "type": "object",
      "properties": {
        "pages": {
          "type": "integer"
        },
        "args": {
          "type": "string"
        },
        "text": {
          "type": "string"
        }
      },
      "required": [
        "args",
        "pages",
        "text"
      ]
    },
    "QuoteSchema": {
      "type": "object",
      "properties": {
        "matches": {
          "type": "boolean"
        },
        "text": {
          "type": "string"
        }
      },
      "required": [
        "text"
      ]
    },
    "QuotesSchema": {
      "type": "object",
      "properties": {
        "quote": {
          "$ref": "#/$defs/QuoteSchema"
        }
      }
    },
    "Rfc822TimeSchema": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string",
          "description": "RFC 822 formatted time."
        }
      },
      "required": [
        "text"
      ]
    },
    "ScreenshotSchema": {
      "type": "object",
      "properties": {
        "id_type": {
          "type": "integer"
        },
        "width": {
          "type": "integer"
        },
        "height": {
          "type": "integer"
        },
        "text": {
          "type": "string",
          "description": "URL of the screenshot."
        }
      },
      "required": [
        "height",
        "id_type",
        "text",
        "width"
      ]
    },
    "SearchMatchSchema": {
      "type": "object",
      "properties": {
        "type": {
          "type": "string"
        },
        "color": {
          "type": "integer"
        },
        "text": {
          "type": "string"
        }
      }
    },
    "SearchResponseSchema": {
      "type": "object",
      "description": "Successful search response from searchd.",
      "properties": {
        "documents": {
          "type": "integer",
          "description": "Number of documents in the result."
        },
        "document": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/DocumentSchema"
          },
          "description": "Articles matching the search."
        },
        "debug": {
          "$ref": "#/$defs/DebugSchema"
        },
        "first_timestamp": {
          "type": "integer",
          "description": "Unix timestamp of the newest matching document in the response."
        },
        "last_timestamp": {
          "type": "integer",
          "description": "Unix timestamp of the oldest matching document in the response."
        },
        "context": {
          "type": "string",
          "description": "Pagination cursor. Pass to the context parameter to fetch the next page. Empty string means no more results."
        },
        "search_start": {
          "type": "integer",
          "description": "Unix timestamp a new search can start from to get newer content. Can be passed as the oldest parameter."
        },
        "range_count": {
          "type": "integer",
          "description": "Estimate of total matching documents in the range."
        },
        "range_start": {
          "type": "integer"
        },
        "range_end": {
          "type": "integer",
          "description": "0 means the end of the range is now."
        },
        "count": {
          "type": "integer"
        },
        "cacheage": {
          "type": "integer"
        },
        "cputime": {
          "type": "integer"
        },
        "host": {
          "type": "string",
          "description": "Server having processed the request."
        },
        "compiledate": {
          "type": "string"
        },
        "branch": {
          "type": "string"
        },
        "notimeout": {
          "type": "boolean"
        },
        "wikinames": {
          "type": "object",
          "additionalProperties": {},
          "description": "Mapping of entity ids to entity names."
        },
        "wikidescriptions": {
          "type": "object",
          "additionalProperties": {},
          "description": "Mapping of entity ids to entity descriptions."
        },
        "search_matches": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/SearchMatchSchema"
          }
        },
        "matches_table": {
          "$ref": "#/$defs/MatchTableSchema"
        },
        "watch_id": {
          "type": "integer",
          "description": "Id of watch process."
        },
        "sort_groups": {
          "$ref": "#/$defs/SortGroupSchema"
        },
        "covered": {
          "type": "integer"
        },
        "next_from": {
          "type": "integer"
        }
      },
      "required": [
        "document",
        "documents",
        "first_timestamp",
        "last_timestamp"
      ]
    },
    "SentimentEnum": {
      "enum": [
        "Positive",
        "Negative",
        "Neutral"
      ],
      "type": "string",
      "description": "* `Positive` - Positive\n* `Negative` - Negative\n* `Neutral` - Neutral"
    },
    "ShortFieldSchema": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string"
        },
        "matches": {
          "type": "boolean",
          "description": "Whether search matches are highlighted in this field."
        },
        "length": {
          "type": "integer"
        },
        "removed": {
          "type": "integer"
        }
      },
      "required": [
        "text"
      ]
    },
    "SimilarwebSchema": {
      "type": "object",
      "properties": {
        "domain": {
          "type": "string"
        },
        "mvisit": {
          "type": "integer",
          "description": "Monthly visits."
        },
        "unique_mobile_visits": {
          "type": "integer"
        },
        "unique_desktop_visits": {
          "type": "integer"
        },
        "page_per_visit": {
          "type": "number",
          "format": "double"
        },
        "bounce_rate": {
          "type": "number",
          "format": "double"
        },
        "time_on_site": {
          "type": "number",
          "format": "double",
          "description": "Average time on site per visit, in seconds."
        },
        "category": {
          "type": "string"
        },
        "category_rank": {
          "type": "integer"
        },
        "sanitize": {
          "type": "number",
          "format": "double"
        },
        "readership": {
          "$ref": "#/$defs/SiteReadershipSchema"
        },
        "article_readership": {
          "$ref": "#/$defs/ArticleReadershipSchema"
        }
      }
    },
    "SiteRankSchema": {
      "type": "object",
      "properties": {
        "rank_global": {
          "type": "integer"
        },
        "rank_country": {
          "type": "integer"
        }
      }
    },
    "SiteReadershipSchema": {
      "type": "object",
      "properties": {
        "P": {
          "type": "number",
          "format": "double"
        },
        "value": {
          "type": "integer"
        }
      }
    },
    "SortGroupSchema": {
      "type": "object",
      "properties": {
        "group": {
          "type": "integer",
          "description": "Group id. 0 for articles not matching any group."
        },
        "weight": {
          "type": "integer"
        },
        "count": {
          "type": "integer",
          "description": "Number of articles in group."
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "group"
      ]
    },
    "SourceSchema": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer"
        },
        "name": {
          "type": "string"
        },
        "sitename": {
          "type": "string"
        },
        "url": {
          "type": "string"
        },
        "siteurl": {
          "type": "string"
        },
        "linktype_max": {
          "type": "integer"
        },
        "linktype_now": {
          "type": "integer"
        }
      },
      "required": [
        "id",
        "name",
        "sitename",
        "siteurl",
        "url"
      ]
    },
    "SourcesSchema": {
      "type": "object",
      "properties": {
        "source": {
          "$ref": "#/$defs/SourceSchema"
        }
      }
    },
    "SummarySchema": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string"
        },
        "matches": {
          "type": "boolean",
          "description": "Whether search matches are highlighted in this field."
        },
        "compare": {
          "type": "integer",
          "description": "Edit distance between compare_text parameter and the combined summary and body text."
        },
        "truncated": {
          "type": "boolean"
        }
      },
      "required": [
        "text"
      ]
    },
    "TagSchema": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer"
        },
        "is_owner": {
          "type": "integer"
        },
        "sent": {
          "type": "integer"
        },
        "set": {
          "type": "integer"
        },
        "equal_sent": {
          "type": "integer"
        }
      },
      "required": [
        "equal_sent",
        "id",
        "is_owner",
        "sent",
        "set"
      ]
    },
    "TextFieldSchema": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string"
        },
        "matches": {
          "type": "boolean",
          "description": "Whether search matches are highlighted in this field."
        }
      },
      "required": [
        "text"
      ]
    },
    "TopicSchema": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "description": "Subject id."
        },
        "text": {
          "type": "string",
          "description": "Subject name."
        },
        "linktype_max": {
          "type": "integer"
        },
        "linktype_now": {
          "type": "integer"
        },
        "metacat": {
          "type": "integer",
          "description": "Meta category, an integer representing the type of the subject."
        },
        "metacat_level": {
          "type": "integer",
          "description": "Meta category abstraction level, ordered from 0 and up."
        }
      },
      "required": [
        "id",
        "text"
      ]
    },
    "TopicsAndEntitiesSchema": {
      "type": "object",
      "properties": {
        "topics": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/IptcTopicSchema"
          }
        },
        "entities": {
          "$ref": "#/$defs/EntitiesSchema"
        },
        "sentiment": {
          "allOf": [
            {
              "$ref": "#/$defs/SentimentEnum"
            }
          ],
          "description": "Overall sentiment of the article.\n\n* `Positive` - Positive\n* `Negative` - Negative\n* `Neutral` - Neutral"
        },
        "sentiment_score": {
          "type": "number",
          "format": "double",
          "description": "Aggregated sentiment score from -1.0 to 1.0."
        }
      }
    },
    "TranslatedHeaderSchema": {
      "type": "object",
      "properties": {
        "text": {
          "type": "string"
        },
        "matches": {
          "type": "boolean",
          "description": "Whether search matches are highlighted in this field."
        },
        "language": {
          "type": "string"
        }
      },
      "required": [
        "text"
      ]
    },
    "UserCommentSchema": {
      "type": "object",
      "properties": {
        "id_user": {
          "type": "integer"
        },
        "username": {
          "type": "string"
        },
        "first_name": {
          "type": "string"
        },
        "last_name": {
          "type": "string"
        },
        "signature": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "id_group": {
          "type": "integer",
          "description": "Comment group the comment belongs to."
        },
        "id_site": {
          "type": "integer"
        },
        "id_article": {
          "type": "integer"
        },
        "timestamp": {
          "type": "integer",
          "description": "When the comment was made."
        },
        "comment": {
          "type": "string"
        }
      },
      "required": [
        "comment",
        "email",
        "first_name",
        "id_article",
        "id_group",
        "id_site",
        "id_user",
        "last_name",
        "signature",
        "timestamp",
        "username"
      ]
    },
    "UserCommentsSchema": {
      "type": "object",
      "properties": {
        "count": {
          "type": "integer"
        },
        "usercomment": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/UserCommentSchema"
          }
        }
      },
      "required": [
        "count"
      ]
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/opoint-search-result-schema"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

A second provider on the same verified email joins the account you already have.