गोपनीयता प्राथमिकताएँ

आवश्यक सुविधाएँ

सुरक्षा और साइट की बुनियादी सुविधाओं के लिए आवश्यक।

हमेशा चालू

Landing डायग्नोस्टिक्स और छिपी सामग्री वाला रीप्ले

केवल इस टैब के अनाम ID से सार्वजनिक विज़िट, बीच में छोड़ने और साइनअप लिंक के साथ इंटरैक्शन को मापता है, बिना खाते से जोड़े। सारा टेक्स्ट छिपाया जाता है और फ़ॉर्म ब्लॉक किए जाते हैं।

वैकल्पिक उपयोग एनालिटिक्स

PostHog उपयोग एनालिटिक्स की अनुमति दें? फ़ुटर में कभी भी अपना चुनाव बदलें।

इस सार्वजनिक वेबसाइट पर सत्र रीप्ले की भी अनुमति दें

वैकल्पिक क्रॉस-साइट मोड के रीप्ले में इनपुट और निजी कंटेंट छिपाकर सार्वजनिक पेज और इंटरैक्शन दिखाए जाते हैं। App रीप्ले एक अलग चुनाव है।

वैकल्पिक एनालिटिक्स आवश्यक है; इस क्रॉस-साइट मोड में रीप्ले डिफ़ॉल्ट रूप से बंद रहता है। ऊपर दिया गया Landing मोड अलग से चलता है।

ब्राउज़र विश्लेषण से खाते का विश्लेषण चालू नहीं होता।

खोज केवल इस्तेमाल करने पर लोड होती है। नीचे सभी श्रेणियाँ देखें।

MCP टूल

सार्वजनिक सोशल स्रोत प्राप्ति की स्थिति पढ़ें

sosoapi_research_evidence_social-status

mutation_id से उसी सोशल स्रोत प्राप्ति को पढ़ें; अविश्वसनीय स्रोत पाठ की अवधि समाप्त हो सकती है या वह अनुपलब्ध हो सकता है। agent:research आवश्यक है।

Markdown में पढ़ें

प्रोफ़ाइल और ट्रांसपोर्ट

प्रोफ़ाइल: full · ट्रांसपोर्ट: stdio, http

# This operation requires a CLI build containing the updated Research contract.
# Use HTTP or hosted MCP if your CLI build does not include it.
# 此操作需要包含更新版 Research contract 的 CLI build。
# 如 CLI build 未包含此 contract,請使用 HTTP 或 hosted MCP。

क्लाइंट में दिखने वाले टूल के लिए core या full चुनें; इससे अनुमतियाँ नहीं बदलतीं। लोकल फ़ाइल अपलोड के लिए stdio चाहिए और HTTP पर उपलब्ध नहीं। खोज में आउटपुट स्कीमा के लिए SOSOAPI_OUTPUT_SCHEMAS=1 सेट करें। इस सेटिंग के साथ या बिना टूल संरचित परिणाम लौटाते हैं।

अनुमतियाँ और अन्य प्रभाव

एनोटेशन क्लाइंट को टूल का वर्णन करने में मदद करते हैं। हर कॉल फिर भी यूज़र का प्रमाणीकरण, भूमिका, संसाधन एक्सेस और क्षमता अधिकार जाँचती है।

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}
  • /research-api/evidence/social-status: agent:research · वर्तमान में अधिकृत सोशल प्राप्ति रसीद और साक्ष्य; हटाई गई या अवधि समाप्त स्रोत सामग्री छिपाई जाती है

इनपुट फ़ील्ड

Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।

इनपुट फ़ील्ड
फ़ील्ड / शाखाप्रकार / अनिवार्यशर्तें
$objectपैरेंट में अनिवार्य
  • additionalProperties: false
workspace_idstringपैरेंट में अनिवार्य
  • format: "uuid"
mutation_idstringपैरेंट में अनिवार्य
  • format: "uuid"
संपूर्ण JSON Schema
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "mutation_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "workspace_id",
    "mutation_id"
  ],
  "additionalProperties": false
}

संरचित आउटपुट

यह स्कीमा सफल टूल परिणाम के structuredContent का वर्णन करता है। MCP रिस्पॉन्स में content भी होता है और कॉल विफल होने पर isError सेट हो सकता है। प्रकाशन के लिए स्वीकृत अनुरोध या टेक्स्ट रिस्पॉन्स को पुष्टि मानने के बजाय पोस्ट का अंतिम परिणाम पढ़ें। लिंक किया गया API ऑपरेशन अनुमतियाँ और पुनः प्रयास के नियम समझाता है।

Required का अर्थ पैरेंट ऑब्जेक्ट और चुनी शाखा के भीतर अनिवार्य है। अनिवार्य चाइल्ड से वैकल्पिक पैरेंट अनिवार्य नहीं होता। नीचे के नियम और फ़ील्ड नाम कॉन्ट्रैक्ट से लिए गए हैं।

संरचित आउटपुट
फ़ील्ड / शाखाप्रकार / अनिवार्यशर्तें
$objectपैरेंट में अनिवार्य
  • additionalProperties: false
retrievalobject | nullपैरेंट में अनिवार्य—
retrievalanyOf 1objectपैरेंट में अनिवार्य
  • additionalProperties: false
retrieval.idanyOf 1stringपैरेंट में अनिवार्य
  • format: "uuid"
retrieval.workspace_idanyOf 1stringपैरेंट में अनिवार्य
  • format: "uuid"
retrieval.mutation_idanyOf 1stringपैरेंट में अनिवार्य
  • format: "uuid"
retrieval.kindanyOf 1stringपैरेंट में अनिवार्य
  • const: "public_social"
retrieval.stateanyOf 1stringपैरेंट में अनिवार्य
  • enum: ["pending","running","completed","cancelled","unconfirmed","expired"]
retrieval.created_atanyOf 1stringपैरेंट में अनिवार्य
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
retrieval.settled_atanyOf 1string | nullपैरेंट में अनिवार्य—
retrieval.settled_atanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
retrieval.settled_atanyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.valid_untilanyOf 1stringपैरेंट में अनिवार्य
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
retrieval.resultanyOf 1object | nullपैरेंट में अनिवार्य—
retrieval.resultanyOf 1 / anyOf 1objectपैरेंट में अनिवार्य
  • additionalProperties: false
retrieval.result.sourceanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • enum: ["facebook_public_web","instagram_public_web","threads_public_web"]
retrieval.result.platformanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • enum: ["facebook","instagram","threads"]
retrieval.result.canonical_urlanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • format: "uri"
  • maxLength: 2048
retrieval.result.fetched_atanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
retrieval.result.expires_atanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
retrieval.result.upstream_updated_atanyOf 1 / anyOf 1nullपैरेंट में अनिवार्य—
retrieval.result.statusanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • enum: ["available","partial","unavailable"]
retrieval.result.profileanyOf 1 / anyOf 1object | nullपैरेंट में अनिवार्य—
retrieval.result.profileanyOf 1 / anyOf 1 / anyOf 1objectपैरेंट में अनिवार्य
  • additionalProperties: false
retrieval.result.profile.source_account_idanyOf 1 / anyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • pattern: "^[0-9]{1,30}$"
retrieval.result.profile.id_namespaceanyOf 1 / anyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • const: "public_web"
retrieval.result.profile.usernameanyOf 1 / anyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • minLength: 1
  • maxLength: 50
retrieval.result.profile.nameanyOf 1 / anyOf 1 / anyOf 1string | nullपैरेंट में अनिवार्य—
retrieval.result.profile.nameanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • minLength: 1
  • maxLength: 200
retrieval.result.profile.nameanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.result.profile.followersanyOf 1 / anyOf 1 / anyOf 1integer | nullपैरेंट में अनिवार्य—
retrieval.result.profile.followersanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1integerपैरेंट में अनिवार्य
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.profile.followersanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.result.profileanyOf 1 / anyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.result.postsanyOf 1 / anyOf 1arrayपैरेंट में अनिवार्य
  • maxItems: 20
retrieval.result.posts[]anyOf 1 / anyOf 1objectवैकल्पिक / आइटम
  • additionalProperties: false
retrieval.result.posts[].source_post_idanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • pattern: "^[0-9]{1,30}$"
retrieval.result.posts[].id_namespaceanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • const: "public_web"
retrieval.result.posts[].shortcodeanyOf 1 / anyOf 1string | nullपैरेंट में अनिवार्य—
retrieval.result.posts[].shortcodeanyOf 1 / anyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • minLength: 1
  • maxLength: 64
retrieval.result.posts[].shortcodeanyOf 1 / anyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.result.posts[].source_account_idanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • pattern: "^[0-9]{1,30}$"
retrieval.result.posts[].authoranyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • minLength: 1
  • maxLength: 50
retrieval.result.posts[].canonical_urlanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • format: "uri"
  • maxLength: 2048
retrieval.result.posts[].textanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • maxLength: 30000
retrieval.result.posts[].published_atanyOf 1 / anyOf 1string | nullपैरेंट में अनिवार्य—
retrieval.result.posts[].published_atanyOf 1 / anyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
retrieval.result.posts[].published_atanyOf 1 / anyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.result.posts[].media_kindanyOf 1 / anyOf 1stringपैरेंट में अनिवार्य
  • enum: ["text","image","video","carousel","unknown"]
retrieval.result.posts[].metricsanyOf 1 / anyOf 1objectपैरेंट में अनिवार्य
  • additionalProperties: false
retrieval.result.posts[].metrics.likesanyOf 1 / anyOf 1integer | nullपैरेंट में अनिवार्य—
retrieval.result.posts[].metrics.likesanyOf 1 / anyOf 1 / anyOf 1integerपैरेंट में अनिवार्य
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.posts[].metrics.likesanyOf 1 / anyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.result.posts[].metrics.commentsanyOf 1 / anyOf 1integer | nullपैरेंट में अनिवार्य—
retrieval.result.posts[].metrics.commentsanyOf 1 / anyOf 1 / anyOf 1integerपैरेंट में अनिवार्य
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.posts[].metrics.commentsanyOf 1 / anyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.result.posts[].metrics.reactionsanyOf 1 / anyOf 1integer | nullपैरेंट में अनिवार्य—
retrieval.result.posts[].metrics.reactionsanyOf 1 / anyOf 1 / anyOf 1integerपैरेंट में अनिवार्य
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.posts[].metrics.reactionsanyOf 1 / anyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.result.posts[].metrics.sharesanyOf 1 / anyOf 1integer | nullपैरेंट में अनिवार्य—
retrieval.result.posts[].metrics.sharesanyOf 1 / anyOf 1 / anyOf 1integerपैरेंट में अनिवार्य
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.posts[].metrics.sharesanyOf 1 / anyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.result.posts[].metrics.viewsanyOf 1 / anyOf 1integer | nullपैरेंट में अनिवार्य—
retrieval.result.posts[].metrics.viewsanyOf 1 / anyOf 1 / anyOf 1integerपैरेंट में अनिवार्य
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.posts[].metrics.viewsanyOf 1 / anyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.result.coverageanyOf 1 / anyOf 1objectपैरेंट में अनिवार्य
  • additionalProperties: false
retrieval.result.coverage.completeanyOf 1 / anyOf 1booleanपैरेंट में अनिवार्य
  • const: false
retrieval.result.coverage.reasonsanyOf 1 / anyOf 1arrayपैरेंट में अनिवार्य
  • maxItems: 20
retrieval.result.coverage.reasons[]anyOf 1 / anyOf 1stringवैकल्पिक / आइटम
  • enum: ["initial_page_only","public_web_ids","metrics_unavailable","profile_only","no_attributable_posts","foreign_or_malformed_rows","parser_limit","unsupported_payload","blocked","rate_limited","upstream_http_error","redirect_rejected","unsupported_content_type","response_too_large","timeout","aborted","network_error","inconsistent_identity","research_limit","source_removed"]
retrieval.result.coverage.omitted_rowsanyOf 1 / anyOf 1integerपैरेंट में अनिवार्य
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.coverage.next_cursoranyOf 1 / anyOf 1nullपैरेंट में अनिवार्य—
retrieval.resultanyOf 1 / anyOf 2nullपैरेंट में अनिवार्य—
retrieval.evidenceanyOf 1arrayपैरेंट में अनिवार्य
  • maxItems: 20
retrieval.evidence[]anyOf 1objectवैकल्पिक / आइटम
  • additionalProperties: false
retrieval.evidence[].evidence_idanyOf 1stringपैरेंट में अनिवार्य
  • format: "uuid"
retrieval.evidence[].revisionanyOf 1integerपैरेंट में अनिवार्य
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
retrievalanyOf 2nullपैरेंट में अनिवार्य—
संपूर्ण JSON Schema
{
  "type": "object",
  "properties": {
    "retrieval": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid"
            },
            "workspace_id": {
              "type": "string",
              "format": "uuid"
            },
            "mutation_id": {
              "type": "string",
              "format": "uuid"
            },
            "kind": {
              "type": "string",
              "const": "public_social"
            },
            "state": {
              "type": "string",
              "enum": [
                "pending",
                "running",
                "completed",
                "cancelled",
                "unconfirmed",
                "expired"
              ]
            },
            "created_at": {
              "type": "string",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "format": "date-time"
            },
            "settled_at": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                  "format": "date-time"
                },
                {
                  "type": "null"
                }
              ]
            },
            "valid_until": {
              "type": "string",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
              "format": "date-time"
            },
            "result": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "source": {
                      "type": "string",
                      "enum": [
                        "facebook_public_web",
                        "instagram_public_web",
                        "threads_public_web"
                      ]
                    },
                    "platform": {
                      "type": "string",
                      "enum": [
                        "facebook",
                        "instagram",
                        "threads"
                      ]
                    },
                    "canonical_url": {
                      "type": "string",
                      "maxLength": 2048,
                      "format": "uri"
                    },
                    "fetched_at": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    },
                    "expires_at": {
                      "type": "string",
                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                      "format": "date-time"
                    },
                    "upstream_updated_at": {
                      "type": "null"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "unavailable"
                      ]
                    },
                    "profile": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "source_account_id": {
                              "type": "string",
                              "pattern": "^[0-9]{1,30}$"
                            },
                            "id_namespace": {
                              "type": "string",
                              "const": "public_web"
                            },
                            "username": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 50
                            },
                            "name": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "followers": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "source_account_id",
                            "id_namespace",
                            "username",
                            "name",
                            "followers"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "posts": {
                      "maxItems": 20,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "source_post_id": {
                            "type": "string",
                            "pattern": "^[0-9]{1,30}$"
                          },
                          "id_namespace": {
                            "type": "string",
                            "const": "public_web"
                          },
                          "shortcode": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "source_account_id": {
                            "type": "string",
                            "pattern": "^[0-9]{1,30}$"
                          },
                          "author": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 50
                          },
                          "canonical_url": {
                            "type": "string",
                            "maxLength": 2048,
                            "format": "uri"
                          },
                          "text": {
                            "type": "string",
                            "maxLength": 30000
                          },
                          "published_at": {
                            "anyOf": [
                              {
                                "type": "string",
                                "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
                                "format": "date-time"
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "media_kind": {
                            "type": "string",
                            "enum": [
                              "text",
                              "image",
                              "video",
                              "carousel",
                              "unknown"
                            ]
                          },
                          "metrics": {
                            "type": "object",
                            "properties": {
                              "likes": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "comments": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "reactions": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "shares": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "views": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "likes",
                              "comments",
                              "reactions",
                              "shares",
                              "views"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "source_post_id",
                          "id_namespace",
                          "shortcode",
                          "source_account_id",
                          "author",
                          "canonical_url",
                          "text",
                          "published_at",
                          "media_kind",
                          "metrics"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "coverage": {
                      "type": "object",
                      "properties": {
                        "complete": {
                          "type": "boolean",
                          "const": false
                        },
                        "reasons": {
                          "maxItems": 20,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "initial_page_only",
                              "public_web_ids",
                              "metrics_unavailable",
                              "profile_only",
                              "no_attributable_posts",
                              "foreign_or_malformed_rows",
                              "parser_limit",
                              "unsupported_payload",
                              "blocked",
                              "rate_limited",
                              "upstream_http_error",
                              "redirect_rejected",
                              "unsupported_content_type",
                              "response_too_large",
                              "timeout",
                              "aborted",
                              "network_error",
                              "inconsistent_identity",
                              "research_limit",
                              "source_removed"
                            ]
                          }
                        },
                        "omitted_rows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "next_cursor": {
                          "type": "null"
                        }
                      },
                      "required": [
                        "complete",
                        "reasons",
                        "omitted_rows",
                        "next_cursor"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "source",
                    "platform",
                    "canonical_url",
                    "fetched_at",
                    "expires_at",
                    "upstream_updated_at",
                    "status",
                    "profile",
                    "posts",
                    "coverage"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "evidence": {
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "evidence_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "revision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "evidence_id",
                  "revision"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "id",
            "workspace_id",
            "mutation_id",
            "kind",
            "state",
            "created_at",
            "settled_at",
            "valid_until",
            "result",
            "evidence"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "retrieval"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

टूल कॉल का उदाहरण

उदाहरणों में स्कीमा से जाँचे काल्पनिक मान हैं। IDs को अधिकृत IDs, मीडिया को तैयार एसेट और तारीखों को पुष्ट प्रकाशन समय से बदलें। राइट सबमिट करने से पहले खाते की पात्रता जाँचें। यह पेज API अनुरोध नहीं भेजता।

{
  "name": "sosoapi_research_evidence_social-status",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "40000000-0000-4000-8000-000000000005"
  }
}

structuredContent

{
  "retrieval": {
    "id": "30000000-0000-4000-8000-000000000007",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "40000000-0000-4000-8000-000000000005",
    "kind": "public_social",
    "state": "completed",
    "created_at": "2099-01-15T09:00:00Z",
    "settled_at": "2099-01-15T09:00:01Z",
    "valid_until": "2099-01-16T09:00:00Z",
    "evidence": [],
    "result": {
      "source": "instagram_public_web",
      "platform": "instagram",
      "canonical_url": "https://www.instagram.com/fictional_example/",
      "fetched_at": "2099-01-15T09:00:00Z",
      "expires_at": "2099-01-16T09:00:00Z",
      "upstream_updated_at": null,
      "status": "unavailable",
      "profile": null,
      "posts": [],
      "coverage": {
        "complete": false,
        "reasons": [
          "blocked"
        ],
        "omitted_rows": 0,
        "next_cursor": null
      }
    }
  }
}
MCP इंस्टॉल या कनेक्ट करें