Social Media Search API — Twitter, Instagram, Reddit, TikTok (XPOZ)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "operationId"
  ],
  "properties": {
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "operationId": {
      "type": "string",
      "description": "The operation ID"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "phrase"
  ],
  "properties": {
    "phrase": {
      "type": "string",
      "minLength": 1,
      "description": "Count only tweets containing the phrase"
    },
    "endDate": {
      "type": "string",
      "description": "End date in YYYY-MM-DD format. Default: current date"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string",
      "description": "Start date in YYYY-MM-DD format. Default: 6 months ago"
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postId"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, parentPostId, type, parentCommentId, repliedToCommentId, childCommentCount, userId, username, fullName, createdAt, createdAtTimestamp, createdAtDate. Engagement: likeCount. Status: status, isSpam, hasTranslation. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"username\", \"createdAtDate\", \"likeCount\"] for basic analysis, or specify all fields if needed."
    },
    "postId": {
      "type": "string",
      "pattern": "^\\d+_\\d+$",
      "description": "REQUIRED FORMAT: strong_id (e.g., \"3606450040306139062_4836333238\"). This is the complete post identifier consisting of media_id + underscore + user_id. When receiving the post id from other instagram tools, use the full \"id\" valueDO NOT use only the media_id portion."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postId",
    "interactionType"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"fullName\"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: followerCount, followingCount, mediaCount. Profile: profilePicUrl, profilePicId, profileUrl, externalUrl, hasAnonymousProfilePicture. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"fullName\", \"followerCount\"] for basic info, or specify all fields if needed."
    },
    "postId": {
      "type": "string",
      "pattern": "^\\d+_\\d+$",
      "description": "REQUIRED FORMAT: strong_id (e.g., \"3606450040306139062_4836333238\"). This is the complete post identifier consisting of media_id + underscore + user_id. When receiving the post id from other instagram tools, use the full \"id\" valueDO NOT use only the media_id portion."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    },
    "interactionType": {
      "enum": [
        "commenters",
        "likers"
      ],
      "type": "string",
      "description": "Type of interaction to retrieve users for. Options: \"commenters\" (users who commented on the post), \"likers\" (users who liked the post). Each type queries different relationships in the data."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postIds"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"caption\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, userId, username, fullName, caption, createdAt, createdAtTimestamp, createdAtDate. Engagement: likeCount, commentCount, reshareCount, mediaRepostCount, saveCount, videoPlayCount. Media: mediaType, codeUrl, imageUrl, videoUrl, audioOnlyUrl, profilePicUrl, videoSubtitlesUri, subtitles, videoDuration. EXAMPLES: [\"id\", \"caption\"] for minimal, [\"id\", \"caption\", \"username\", \"createdAtDate\", \"likeCount\"] for basic analysis, or specify all fields if needed."
    },
    "postIds": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d+_\\d+$"
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Array of Instagram post IDs to fetch (1-50 IDs). Returns only found posts, omitting not-found IDs. REQUIRED FORMAT: strong_id (e.g., \"3606450040306139062_4836333238\"). This is the complete post identifier consisting of media_id + underscore + user_id. When receiving the post id from other instagram tools, use the full \"id\" value. DO NOT use only the media_id portion."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "query": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Plain text keywords or phrases to search in post captions and subtitles. Use double quotes for exact phrases. Do NOT pass URLs, post IDs, or special syntax - only search terms. Examples: \"travel photography\", food OR cooking, \"sunset beach\" AND california"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"caption\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, userId, username, fullName, caption, createdAt, createdAtTimestamp, createdAtDate. Engagement: likeCount, commentCount, reshareCount, mediaRepostCount, saveCount, videoPlayCount. Media: mediaType, codeUrl, imageUrl, videoUrl, audioOnlyUrl, profilePicUrl, videoSubtitlesUri, subtitles, videoDuration. EXAMPLES: [\"id\", \"caption\"] for minimal, [\"id\", \"caption\", \"username\", \"createdAtDate\", \"likeCount\"] for basic analysis, or specify all fields if needed."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "identifier",
    "identifierType"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"caption\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, userId, username, fullName, caption, createdAt, createdAtTimestamp, createdAtDate. Engagement: likeCount, commentCount, reshareCount, mediaRepostCount, saveCount, videoPlayCount. Media: mediaType, codeUrl, imageUrl, videoUrl, audioOnlyUrl, profilePicUrl, videoSubtitlesUri, subtitles, videoDuration. EXAMPLES: [\"id\", \"caption\"] for minimal, [\"id\", \"caption\", \"username\", \"createdAtDate\", \"likeCount\"] for basic analysis, or specify all fields if needed."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "User ID (numeric) or username depending on identifierType."
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    },
    "identifierType": {
      "enum": [
        "id",
        "username"
      ],
      "type": "string",
      "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "identifier",
    "identifierType"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"fullName\"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: followerCount, followingCount, mediaCount. Profile: profilePicUrl, profilePicId, profileUrl, externalUrl, hasAnonymousProfilePicture. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"fullName\", \"followerCount\"] for basic info, or specify all fields if needed."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "User ID (numeric) or username depending on identifierType."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "identifierType": {
      "enum": [
        "id",
        "username"
      ],
      "type": "string",
      "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "username",
    "connectionType"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"fullName\"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: followerCount, followingCount, mediaCount. Profile: profilePicUrl, profilePicId, profileUrl, externalUrl, hasAnonymousProfilePicture. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"fullName\", \"followerCount\"] for basic info, or specify all fields if needed."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "username": {
      "type": "string",
      "pattern": "^@?[a-zA-Z0-9._]{1,30}$",
      "minLength": 1,
      "description": "Instagram username (without @ symbol)"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    },
    "connectionType": {
      "enum": [
        "followers",
        "following"
      ],
      "type": "string",
      "description": "Type of connection to retrieve. Use \"followers\" for users who follow this account, \"following\" for users this account follows."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "commentId"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify comment fields you need. DEFAULT (if omitted): [\"id\", \"body\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, body, parentPostId, parentId. Author: authorId, authorUsername. Subreddit: postSubredditName, postSubredditId. Engagement: score, upvotes, downvotes, controversiality. Meta: depth, isSubmitter, stickied, collapsed, edited, distinguished. Ranking: rank (position in thread), topLevelRank (position among top-level comments). Moderation: removal (JSON removal/deletion status), collapsedReasonCode, collapsedReason. Timestamps: createdAt, createdAtTimestamp, createdAtDate."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "commentId": {
      "type": "string",
      "minLength": 1,
      "description": "Reddit comment ID to fetch (bare base36 id or t1_-prefixed, e.g. \"laz1ytq\" or \"t1_laz1ytq\"). Comment ids are returned by getRedditPostWithCommentsById and getRedditCommentsByKeywords."
    },
    "_requestId": {
      "type": "string"
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "query": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Full-text search of comment content. Searches comment body text. EXACT PHRASES: Wrap in double quotes - \"machine learning\" matches that exact phrase. KEYWORDS: Without quotes, matches comments containing any of the words - AI robotics blockchain. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"deep learning\" AND python (not \"deep learning python\"). Use tensorflow OR pytorch (not \"tensorflow pytorch\"). PARENTHESES: Group terms for precise logic - (AI OR \"artificial intelligence\") AND ethics. Query examples: \"climate change\" | AI OR blockchain | \"neural networks\" AND python | (startup OR entrepreneur)"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify comment fields you need. DEFAULT (if omitted): [\"id\", \"body\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, body, parentPostId, parentId. Author: authorId, authorUsername. Subreddit: postSubredditName, postSubredditId. Engagement: score, upvotes, downvotes, controversiality. Meta: depth, isSubmitter, stickied, collapsed, edited, distinguished. Ranking: rank (position in thread), topLevelRank (position among top-level comments). Moderation: removal (JSON removal/deletion status), collapsedReasonCode, collapsedReason. Timestamps: createdAt, createdAtTimestamp, createdAtDate."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "subreddit": {
      "type": "string",
      "description": "Filter comments by subreddit name (without r/ prefix). Use this parameter to limit search to comments from a specific subreddit. Example: subreddit=\"wallstreetbets\" finds all comments in r/wallstreetbets."
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "_trialToken": {
      "type": "string"
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postId"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "postId": {
      "type": "string",
      "minLength": 1,
      "description": "Reddit post ID to fetch. Returns the post data along with its comments."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "postFields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"title\", \"authorUsername\", \"subredditName\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, title, selftext, selftextHtml, url, permalink, postUrl, thumbnail. Author: authorId, authorUsername. Subreddit: subredditName, subredditId. Engagement: score, upvotes, downvotes, upvoteRatio, commentsCount, crosspostsCount. Flags: isSelf, isVideo, isOriginalContent, over18, spoiler, locked, stickied, archived. Meta: linkFlairText, postHint, domain, crosspostParent. Moderation: removal (JSON removal/deletion status), editedAt (ISO datetime of last edit, null if never edited). Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"title\", \"score\"] for minimal, [\"title\", \"selftext\", \"score\", \"commentsCount\"] for content analysis."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "commentFields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify comment fields you need. DEFAULT (if omitted): [\"id\", \"body\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, body, parentPostId, parentId. Author: authorId, authorUsername. Subreddit: postSubredditName, postSubredditId. Engagement: score, upvotes, downvotes, controversiality. Meta: depth, isSubmitter, stickied, collapsed, edited, distinguished. Ranking: rank (position in thread), topLevelRank (position among top-level comments). Moderation: removal (JSON removal/deletion status), collapsedReasonCode, collapsedReason. Timestamps: createdAt, createdAtTimestamp, createdAtDate."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "relevance",
        "hot",
        "top",
        "new",
        "comments"
      ],
      "type": "string",
      "description": "Sort order for results. Default: relevance."
    },
    "time": {
      "enum": [
        "hour",
        "day",
        "week",
        "month",
        "year",
        "all"
      ],
      "type": "string",
      "description": "Time filter for results. Default: all."
    },
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "query": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Full-text search of post content. Searches post titles and selftext. EXACT PHRASES: Wrap in double quotes - \"machine learning\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words - AI robotics blockchain. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"deep learning\" AND python (not \"deep learning python\"). Use tensorflow OR pytorch (not \"tensorflow pytorch\"). PARENTHESES: Group terms for precise logic - (AI OR \"artificial intelligence\") AND ethics. Query examples: \"climate change\" | AI OR blockchain | \"neural networks\" AND python | (startup OR entrepreneur)"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"title\", \"authorUsername\", \"subredditName\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, title, selftext, selftextHtml, url, permalink, postUrl, thumbnail. Author: authorId, authorUsername. Subreddit: subredditName, subredditId. Engagement: score, upvotes, downvotes, upvoteRatio, commentsCount, crosspostsCount. Flags: isSelf, isVideo, isOriginalContent, over18, spoiler, locked, stickied, archived. Meta: linkFlairText, postHint, domain, crosspostParent. Moderation: removal (JSON removal/deletion status), editedAt (ISO datetime of last edit, null if never edited). Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"title\", \"score\"] for minimal, [\"title\", \"selftext\", \"score\", \"commentsCount\"] for content analysis."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "subreddit": {
      "type": "string",
      "description": "Filter posts by subreddit name (without r/ prefix). Use this parameter to limit search to a specific subreddit. Example: subreddit=\"wallstreetbets\" finds all posts in r/wallstreetbets."
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "subredditName"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "postFields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"title\", \"authorUsername\", \"subredditName\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, title, selftext, selftextHtml, url, permalink, postUrl, thumbnail. Author: authorId, authorUsername. Subreddit: subredditName, subredditId. Engagement: score, upvotes, downvotes, upvoteRatio, commentsCount, crosspostsCount. Flags: isSelf, isVideo, isOriginalContent, over18, spoiler, locked, stickied, archived. Meta: linkFlairText, postHint, domain, crosspostParent. Moderation: removal (JSON removal/deletion status), editedAt (ISO datetime of last edit, null if never edited). Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"title\", \"score\"] for minimal, [\"title\", \"selftext\", \"score\", \"commentsCount\"] for content analysis."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    },
    "subredditName": {
      "type": "string",
      "description": "Reddit subreddit name to fetch (without r/ prefix). Example: \"wallstreetbets\", \"programming\". Returns the subreddit data along with its posts."
    },
    "subredditFields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"displayName\", \"title\", \"subscribersCount\"]. AVAILABLE FIELDS: Core: id, displayName, title, publicDescription, description. Stats: subscribersCount, activeUserCount. Meta: subredditType, submissionType, over18, lang, url, subredditUrl. Images: iconImg, bannerImg, headerImg, communityIcon. Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"displayName\", \"subscribersCount\"] for minimal, [\"displayName\", \"publicDescription\", \"subscribersCount\", \"activeUserCount\"] for discovery."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "query": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Full-text search of Reddit post titles and content to find subreddits where matching posts were made. Searches posts, returns UNIQUE subreddits (deduplicated). EXACT PHRASES: Wrap in double quotes - \"machine learning\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words - python tutorial help. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR, NOT (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"python tutorial\" AND beginner (not \"python tutorial beginner\"). Use programming OR coding (not \"programming coding\"). PARENTHESES: Group terms for precise logic - (python OR javascript) AND (\"web development\" NOT framework). FORBIDDEN: DO NOT use filter operators with colons (from:, to:, since:, until:) - use dedicated parameters instead. Query examples: \"machine learning\" | python help | \"data science\" AND visualization | (gaming OR esports) NOT \"mobile games\""
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"displayName\", \"title\", \"subscribersCount\"]. AVAILABLE FIELDS: Core: id, displayName, title, publicDescription, description. Stats: subscribersCount, activeUserCount. Meta: subredditType, submissionType, over18, lang, url, subredditUrl. Images: iconImg, bannerImg, headerImg, communityIcon. Timestamps: createdAt, createdAtTimestamp, createdAtDate. Aggregations (from matching posts): aggRelevance (relevance score), relevantPostsCount (count of matching posts), relevantPostsUpvotesSum, relevantPostsCommentsCountSum. EXAMPLES: [\"id\", \"displayName\", \"subscribersCount\"] for minimal, [\"displayName\", \"subscribersCount\", \"relevantPostsCount\", \"relevantPostsUpvotesSum\"] to include engagement aggregations."
    },
    "endDate": {
      "type": "string",
      "description": "End date filter (YYYY-MM-DD format)"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string",
      "description": "Start date filter (YYYY-MM-DD format)"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "username"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"totalKarma\"]. AVAILABLE FIELDS: Core: id, username, profileUrl, profilePicUrl, snoovatarImg. Karma: linkKarma, commentKarma, totalKarma, awardeeKarma, awarderKarma. Status: isGold, isMod, isEmployee, hasVerifiedEmail, isSuspended, verified, isBlocked, acceptFollowers, hasSubscribed, hideFromRobots, prefShowSnoovatar. Profile: profileDescription, profileBannerUrl, profileTitle. Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"totalKarma\", \"profileDescription\"] for basic info."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "username": {
      "type": "string",
      "minLength": 1,
      "description": "Reddit username (without u/ prefix)"
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "query": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Full-text search of Reddit post titles and content to find users who authored matching posts. Searches posts, returns UNIQUE user authors (deduplicated). EXACT PHRASES: Wrap in double quotes - \"machine learning\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words - python tutorial help. BOOLEAN OPERATORS: MUST explicitly use the keywords AND, OR, NOT (uppercase or lowercase). NO implicit operators - space between words means OR by default. Examples requiring explicit operators: Use \"python tutorial\" AND beginner (not \"python tutorial beginner\"). Use programming OR coding (not \"programming coding\"). PARENTHESES: Group terms for precise logic - (python OR javascript) AND (\"web development\" NOT framework). FORBIDDEN: DO NOT use filter operators with colons (from:, to:, since:, until:) - use dedicated parameters instead. Query examples: \"machine learning\" | python help | \"data science\" AND visualization | (gaming OR esports) NOT \"mobile games\""
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"totalKarma\"]. AVAILABLE FIELDS: Core: id, username, profileUrl, profilePicUrl, snoovatarImg. Karma: linkKarma, commentKarma, totalKarma, awardeeKarma, awarderKarma. Status: isGold, isMod, isEmployee, hasVerifiedEmail, isSuspended, verified, isBlocked, acceptFollowers, hasSubscribed, hideFromRobots, prefShowSnoovatar. Profile: profileDescription, profileBannerUrl, profileTitle. Timestamps: createdAt, createdAtTimestamp, createdAtDate. Aggregations (from matching posts): aggRelevance (relevance score), relevantPostsCount (count of matching posts), relevantPostsUpvotesSum, relevantPostsCommentsCountSum. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"totalKarma\", \"relevantPostsCount\", \"relevantPostsUpvotesSum\"] to include engagement aggregations."
    },
    "endDate": {
      "type": "string",
      "description": "End date filter (YYYY-MM-DD format)"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string",
      "description": "Start date filter (YYYY-MM-DD format)"
    },
    "subreddit": {
      "type": "string",
      "description": "Filter results to a specific subreddit (without r/ prefix)"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postId"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, postId, userId, username, createdAt, createdAtTimestamp, createdAtDate. Engagement: likeCount. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"username\", \"createdAtDate\", \"likeCount\"] for basic analysis."
    },
    "postId": {
      "type": "string",
      "minLength": 1,
      "description": "Tiktok post ID to fetch comments for."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once. Must be >= pageNumber. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "hashtags"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"description\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, isPrivate, userId, username, nickname, description, descriptionLanguage, createdAt, createdAtTimestamp, createdAtDate. Engagement: collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount. Media: videoThumbnail, videoUrl (array of video URLs), duration (video length in seconds). Content: hashtags (array of hashtag strings). EXAMPLES: [\"id\", \"description\"] for minimal, [\"id\", \"description\", \"username\", \"createdAtDate\", \"likeCount\", \"playCount\"] for basic analysis, [\"id\", \"description\", \"hashtags\", \"duration\", \"videoUrl\"] for video content analysis."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "hashtags": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_]{1,500}$"
      },
      "maxItems": 5,
      "minItems": 1,
      "description": "Array of hashtags to search for (1-5 per request). OR semantics: matches posts containing ANY of the listed hashtags. Bare alphanumeric/underscore only - do NOT include leading \"#\". Examples: [\"dance\", \"fyp\", \"viral\"] | [\"cooking\"] | [\"sustainable_fashion\"]."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once. Must be >= pageNumber. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postIds"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"description\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, isPrivate, userId, username, nickname, description, descriptionLanguage, createdAt, createdAtTimestamp, createdAtDate. Engagement: collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount. Media: videoThumbnail, videoUrl (array of video URLs), duration (video length in seconds). Content: hashtags (array of hashtag strings). EXAMPLES: [\"id\", \"description\"] for minimal, [\"id\", \"description\", \"username\", \"createdAtDate\", \"likeCount\", \"playCount\"] for basic analysis, [\"id\", \"description\", \"hashtags\", \"duration\", \"videoUrl\"] for video content analysis."
    },
    "postIds": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d{1,50}$"
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Array of Tiktok post IDs to fetch (1-100 IDs). Returns only found posts, omitting not-found IDs."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "query": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Plain text keywords or phrases to search in post descriptions. Use double quotes for exact phrases. Do NOT pass URLs or post IDs. Examples: \"dance challenge\", cooking OR recipe, \"sunset\" AND beach"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"description\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, isPrivate, userId, username, nickname, description, descriptionLanguage, createdAt, createdAtTimestamp, createdAtDate. Engagement: collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount. Media: videoThumbnail, videoUrl (array of video URLs), duration (video length in seconds). Content: hashtags (array of hashtag strings). EXAMPLES: [\"id\", \"description\"] for minimal, [\"id\", \"description\", \"username\", \"createdAtDate\", \"likeCount\", \"playCount\"] for basic analysis, [\"id\", \"description\", \"hashtags\", \"duration\", \"videoUrl\"] for video content analysis."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once. Must be >= pageNumber. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "soundId"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"description\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, isPrivate, userId, username, nickname, description, descriptionLanguage, createdAt, createdAtTimestamp, createdAtDate. Engagement: collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount. Media: videoThumbnail, videoUrl (array of video URLs), duration (video length in seconds). Content: hashtags (array of hashtag strings). EXAMPLES: [\"id\", \"description\"] for minimal, [\"id\", \"description\", \"username\", \"createdAtDate\", \"likeCount\", \"playCount\"] for basic analysis, [\"id\", \"description\", \"hashtags\", \"duration\", \"videoUrl\"] for video content analysis."
    },
    "endDate": {
      "type": "string"
    },
    "soundId": {
      "type": "string",
      "pattern": "^\\d{1,50}$",
      "description": "Tiktok sound/music ID (numeric string). Get IDs from searchTiktokSounds. Example: \"7016547803243907841\"."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once. Must be >= pageNumber. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "identifier",
    "identifierType"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"description\", \"username\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, postType, isPrivate, userId, username, nickname, description, descriptionLanguage, createdAt, createdAtTimestamp, createdAtDate. Engagement: collectCount, commentCount, likeCount, downloadCount, forwardCount, playCount. Media: videoThumbnail, videoUrl (array of video URLs), duration (video length in seconds). Content: hashtags (array of hashtag strings). EXAMPLES: [\"id\", \"description\"] for minimal, [\"id\", \"description\", \"username\", \"createdAtDate\", \"likeCount\", \"playCount\"] for basic analysis, [\"id\", \"description\", \"hashtags\", \"duration\", \"videoUrl\"] for video content analysis."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "User ID (numeric) or username depending on identifierType."
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once. Must be >= pageNumber. Requires tableName."
    },
    "identifierType": {
      "enum": [
        "id",
        "username"
      ],
      "type": "string",
      "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "identifier",
    "identifierType"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"nickname\"]. AVAILABLE FIELDS: Core: id, username, nickname, signature, secUid, avatar, isPrivate, isVerified. Engagement: followerCount, followingCount, likeCount, postCount. Meta: language, region, createdAt, usernameModifyTime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"nickname\", \"followerCount\"] for basic info."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "User ID (numeric) or username depending on identifierType."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "identifierType": {
      "enum": [
        "id",
        "username"
      ],
      "type": "string",
      "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "hashtags"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"nickname\"]. AVAILABLE FIELDS: Core: id, username, nickname, signature, secUid, avatar, isPrivate, isVerified. Engagement: followerCount, followingCount, likeCount, postCount. Meta: language, region, createdAt, usernameModifyTime. Aggregations (from matching posts): aggRelevance, relevantPostsCount, relevantPostsLikesSum, relevantPostsCommentsSum, relevantPostsPlaysSum, relevantPostsForwardsSum. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"nickname\", \"followerCount\", \"relevantPostsCount\"] to include engagement aggregations."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "hashtags": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[A-Za-z0-9_]{1,500}$"
      },
      "maxItems": 5,
      "minItems": 1,
      "description": "Array of hashtags to search for (1-5 per request). OR semantics: matches users who posted content containing ANY of the listed hashtags. Bare alphanumeric/underscore only - do NOT include leading \"#\". Examples: [\"dance\", \"fyp\"] | [\"cooking\"] | [\"sustainable_fashion\"]."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "query": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Full-text search of Tiktok post descriptions to find users who authored matching posts. Searches posts, returns UNIQUE user authors (deduplicated). EXACT PHRASES: Wrap in double quotes - \"sustainable fashion\" matches that exact phrase. KEYWORDS: Without quotes, matches posts containing any of the words. BOOLEAN OPERATORS: Use AND, OR, NOT explicitly. PARENTHESES: Group terms - (travel OR adventure) AND \"sustainable living\". FORBIDDEN: DO NOT use filter operators with colons. Query examples: \"climate change\" | fashion OR beauty | \"digital nomad\" AND remote"
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"nickname\"]. AVAILABLE FIELDS: Core: id, username, nickname, signature, secUid, avatar, isPrivate, isVerified. Engagement: followerCount, followingCount, likeCount, postCount. Meta: language, region, createdAt, usernameModifyTime. Aggregations (from matching posts): aggRelevance, relevantPostsCount, relevantPostsLikesSum, relevantPostsCommentsSum, relevantPostsPlaysSum, relevantPostsForwardsSum. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"nickname\", \"followerCount\", \"relevantPostsCount\"] to include engagement aggregations."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postId"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed."
    },
    "postId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric Twitter post/tweet ID. Must be a number-only string (e.g., \"1234567890\"). Do NOT pass tweet text, URLs, or usernames here."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postId",
    "interactionType"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"description, followersCount\"] for basic info, or specify all fields if needed."
    },
    "postId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric Twitter post/tweet ID. Must be a number-only string (e.g., \"1234567890\"). Do NOT pass tweet text, URLs, or usernames here."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    },
    "interactionType": {
      "enum": [
        "commenters",
        "quoters",
        "retweeters"
      ],
      "type": "string",
      "description": "Type of interaction to retrieve users for. Options: \"commenters\" (users who replied), \"quoters\" (users who quoted), \"retweeters\" (users who retweeted). Each type queries different relationships in the data."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postId"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed."
    },
    "postId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric Twitter post/tweet ID. Must be a number-only string (e.g., \"1234567890\"). Do NOT pass tweet text, URLs, or usernames here."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postId"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed."
    },
    "postId": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric Twitter post/tweet ID. Must be a number-only string (e.g., \"1234567890\"). Do NOT pass tweet text, URLs, or usernames here."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "responseType": {
      "enum": [
        "fast",
        "paging"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "username"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed."
    },
    "endDate": {
      "type": "string"
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "username": {
      "type": "string",
      "minLength": 1,
      "description": "Twitter username (handle) of the author. Example: \"elonmusk\"."
    },
    "startDate": {
      "type": "string"
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "postIds"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"text\", \"authorUsername\", \"createdAtDate\"]. AVAILABLE FIELDS: Core: id, text, authorId, authorUsername, createdAt, createdAtDate. Engagement: retweetCount, replyCount, likeCount, quoteCount, impressionCount, bookmarkCount. Metadata: lang, possiblySensitive, suspended, deleted, source, isRetweet, hasBirdwatchNotes, status. Birdwatch: birdwatchNotesId, birdwatchNotesText, birdwatchNotesUrl. Relations: conversationId, quotedTweetId, retweetedTweetId, replyToTweetId, replyToUserId, replyToUsername, originalTweetId (original tweet ID if edited, equals own ID if unedited), editedTweets (array of edited version IDs). Content: hashtags, mentions, mediaUrls, urls, grokGeneratedContent (array of Grok AI generated content grok_post_id, grok_url, media_id). Location: placeName, placeCountry, placeCountryCode, placeBoundingBoxCoordinates, placeCentroid. EXAMPLES: [\"id\", \"text\"] for minimal, [\"id\", \"text\", \"retweetCount\", \"likeCount\", \"hashtags\"] for basic analysis, or specify all fields if needed."
    },
    "postIds": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d+$"
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Array of numeric Twitter post IDs (1-100 IDs). Examples: [\"1849537602858893568\", \"1849012345678901234\"]. Returns only found tweets, omitting not-found IDs."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "identifier",
    "identifierType"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"description, followersCount\"] for basic info, or specify all fields if needed."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "identifier": {
      "type": "string",
      "minLength": 1,
      "description": "User ID (numeric) or username depending on identifierType."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "identifierType": {
      "enum": [
        "id",
        "username"
      ],
      "type": "string",
      "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "username",
    "connectionType"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 500000,
      "minimum": 1,
      "description": "Max results to return. Fast mode: capped at 300 (default: 300). Paging/CSV modes: caps total exported rows (default: all, max 500K)."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"description, followersCount\"] for basic info, or specify all fields if needed."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "username": {
      "type": "string",
      "pattern": "^@?[a-zA-Z0-9_]{1,15}$",
      "minLength": 1,
      "description": "Twitter username (without @ symbol)."
    },
    "tableName": {
      "type": "string",
      "description": "Cached table name from previous pagination request. Required when fetching pageNumber > 1. Returned in first page response."
    },
    "_requestId": {
      "type": "string"
    },
    "pageNumber": {
      "type": "number",
      "minimum": 1,
      "description": "Page number to fetch (1-indexed). Must be provided with tableName to fetch subsequent pages. Omit for first page."
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "responseType": {
      "enum": [
        "fast",
        "paging",
        "csv"
      ],
      "type": "string",
      "description": "Response mode. \"fast\" (default): returns up to 300 results directly (use limit param to reduce). \"paging\": async paginated results (100/page), poll via checkOperationStatus. \"csv\": async single CSV download, poll for S3 link."
    },
    "pageNumberEnd": {
      "type": "number",
      "minimum": 1,
      "description": "Optional ending page number for fetching multiple consecutive pages at once (e.g., pageNumber=1, pageNumberEnd=5 fetches pages 1-5). Must be >= pageNumber. Omit to fetch single page only. Requires tableName."
    },
    "connectionType": {
      "enum": [
        "followers",
        "following"
      ],
      "type": "string",
      "description": "Type of connection to retrieve. Use \"followers\" for users who follow this account, \"following\" for users this account follows."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "identifiers",
    "identifierType"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"description, followersCount\"] for basic info, or specify all fields if needed."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    },
    "forceLatest": {
      "type": "boolean",
      "description": "USE SPARINGLY: Force fetching the latest data from the API, bypassing cache checks. Only use when explicitly required (e.g., \"get the latest\", \"most recent\", \"real-time\"). WARNING: Increases latency and API costs. Default: false (uses intelligent caching)."
    },
    "identifiers": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Array of user IDs (numeric) or usernames (1-100). All must match identifierType. Examples: [\"elonmusk\", \"sama\"] for usernames, [\"44196397\", \"123456\"] for IDs. Returns only found users, omitting not-found identifiers."
    },
    "identifierType": {
      "enum": [
        "id",
        "username"
      ],
      "type": "string",
      "description": "Type of identifier provided. Use \"id\" for numeric user ID, \"username\" for username."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Search query for Instagram users. Supports partial name or username matching."
    },
    "limit": {
      "type": "number",
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum number of users to return. Default: 10, Max: 10."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"fullName\"]. AVAILABLE FIELDS: Core: id, username, fullName, biography, isPrivate, isVerified. Engagement: followerCount, followingCount, mediaCount. Profile: profilePicUrl, profilePicId, profileUrl, externalUrl, hasAnonymousProfilePicture. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"fullName\", \"followerCount\"] for basic info, or specify all fields if needed."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of subreddits to return. Default: 50, Max: 50."
    },
    "query": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Search query for Reddit subreddits. Searches subreddit names and descriptions."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"displayName\", \"title\", \"subscribersCount\"]. AVAILABLE FIELDS: Core: id, displayName, title, publicDescription, description. Stats: subscribersCount, activeUserCount. Meta: subredditType, submissionType, over18, lang, url, subredditUrl. Images: iconImg, bannerImg, headerImg, communityIcon. Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"displayName\", \"subscribersCount\"] for minimal, [\"displayName\", \"publicDescription\", \"subscribersCount\", \"activeUserCount\"] for discovery."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Search query for Reddit users. Can be username, name, or keywords from profile."
    },
    "limit": {
      "type": "integer",
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of users to return. Default: 50, Max: 50."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"totalKarma\"]. AVAILABLE FIELDS: Core: id, username, profileUrl, profilePicUrl, snoovatarImg. Karma: linkKarma, commentKarma, totalKarma, awardeeKarma, awarderKarma. Status: isGold, isMod, isEmployee, hasVerifiedEmail, isSuspended, verified, isBlocked, acceptFollowers, hasSubscribed, hideFromRobots, prefShowSnoovatar. Profile: profileDescription, profileBannerUrl, profileTitle. Timestamps: createdAt, createdAtTimestamp, createdAtDate. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"totalKarma\", \"profileDescription\"] for basic info."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "keyword"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "maximum": 300,
      "minimum": 1,
      "description": "Maximum number of sounds to return. Default: 300, Max: 300."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"title\", \"author\", \"userCount\"]. AVAILABLE FIELDS: id, title, author, album, duration (seconds), userCount (number of posts using the sound), isOriginal, isCommerceMusic, isOriginalSound."
    },
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "Search query for Tiktok sounds/music. Matches sound title, artist, or album name."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering."
    },
    "_trialToken": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Search query for Tiktok users. Supports partial name or username matching."
    },
    "limit": {
      "type": "number",
      "maximum": 10,
      "minimum": 1,
      "description": "Maximum number of users to return. Default: 10, Max: 10."
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"nickname\"]. AVAILABLE FIELDS: Core: id, username, nickname, signature, secUid, avatar, isPrivate, isVerified. Engagement: followerCount, followingCount, likeCount, postCount. Meta: language, region, createdAt, usernameModifyTime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"nickname\", \"followerCount\"] for basic info."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1
    },
    "limit": {
      "type": "number",
      "minimum": 1
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "PERFORMANCE OPTIMIZATION: Specify fields you need. DEFAULT (if omitted): [\"id\", \"username\", \"name\"]. AVAILABLE FIELDS: Core: id, username, name, description, location, verified, verifiedType, protected. Engagement: followersCount, followingCount, tweetCount, listedCount, likesCount, mediaCount. Profile: profileImageUrl, profileBannerUrl, profileInterstitialType. Metadata: source, status, pinnedTweetId, isVerified, accountBasedIn, locationAccurate, label, labelType. Advanced: nLang, nLangsFiltered. Timestamps: modifiedAt, createdAt. Account History: verifiedSinceDatetime, usernameChanges, lastUsernameChangeDatetime. EXAMPLES: [\"id\", \"username\"] for minimal, [\"username\", \"name\", \"description, followersCount\"] for basic info, or specify all fields if needed."
    },
    "_isTrial": {
      "type": "boolean"
    },
    "feedback": {
      "type": "string",
      "description": "Optional. Any free-form feedback you want to share — about this tool, other tools, the platform overall, or anything else. Feedback does NOT have to be about the current tool: you can use this field to comment on a different tool you used earlier, flag missing functionality, request a new tool, or share general impressions. Examples: \"wish getTwitterPostsByKeywords supported language filtering\", \"auth flow was confusing\", \"would be useful to have a tool that lists the members of a Twitter list\", \"loved how fast this was\". Captured for product feedback; does not affect tool behavior."
    },
    "_requestId": {
      "type": "string"
    },
    "userPrompt": {
      "type": "string",
      "description": "CRITICAL FOR ACCURACY: Include the complete user question to enable query optimization and context-aware filtering. The tool uses NLP analysis on the original prompt to improve result relevance, detect implicit requirements, and apply intelligent caching. Omitting this may result in suboptimal or incomplete results."
    },
    "_trialToken": {
      "type": "string"
    }
  },
  "additionalProperties": false
}