Desearch

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prompt'], 'properties': {'model': {'enum': ['NOVA', 'ORBIT'], 'type': 'string', 'default': 'NOVA', 'description': 'Model to use for the search: NOVA (default) or ORBIT.'}, 'tools': {'type': 'array', 'items': {'enum': ['web', 'twitter', 'arxiv', 'wikipedia', 'youtube', 'hackernews', 'reddit'], 'type': 'string'}, 'default': ['web', 'twitter'], 'description': "Source ids sent to POST /desearch/ai/search. Use short ids such as 'web' and 'twitter'. Legacy labels such as 'Web Search' are accepted and rewritten to those ids. Example: ['web', 'twitter']."}, 'prompt': {'type': 'string', 'description': "Question, example: 'What is the latest news on AI?'"}, 'end_date': {'type': 'string', 'description': 'End of the date range in UTC (YYYY-MM-DDTHH:MM:SSZ). Use with start_date.'}, 'start_date': {'type': 'string', 'description': 'Start of the date range in UTC (YYYY-MM-DDTHH:MM:SSZ). Use with end_date.'}, 'date_filter': {'enum': ['PAST_24_HOURS', 'PAST_2_DAYS', 'PAST_WEEK', 'PAST_2_WEEKS', 'PAST_MONTH', 'PAST_2_MONTHS', 'PAST_YEAR', 'PAST_2_YEARS'], 'type': 'string', 'description': "Deprecated relative window; prefer start_date/end_date. Example: 'PAST_WEEK'"}, 'result_type': {'enum': ['ONLY_LINKS', 'LINKS_WITH_FINAL_SUMMARY'], 'type': 'string', 'description': 'ONLY_LINKS returns links only; LINKS_WITH_FINAL_SUMMARY adds an AI summary. Link arrays are kept under whichever key the API uses, along with billing fields. ONLY_LINKS still depends on the API to include those links.'}, 'exclude_domains': {'type': 'array', 'items': {'type': 'string'}, 'description': "Drop Web Search results from these domains, example: ['pinterest.com']"}, 'include_domains': {'type': 'array', 'items': {'type': 'string'}, 'description': "Restrict Web Search results to these domains, example: ['bbc.com', 'reuters.com']"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'js': {'type': 'boolean', 'description': 'Render JavaScript before reading the page.'}, 'url': {'type': 'string', 'description': "Public URL to read, example: 'https://desearch.ai'"}, 'wait': {'type': 'number', 'description': 'Post-load wait in milliseconds when JavaScript rendering is enabled.'}, 'format': {'enum': ['html', 'text'], 'type': 'string', 'description': "Content format to return: 'html' or 'text'."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url'], 'properties': {'js': {'type': 'boolean', 'description': 'Render JavaScript before reading the page.'}, 'url': {'type': 'string', 'description': "Public URL to read, example: 'https://desearch.ai'"}, 'wait': {'type': 'number', 'description': 'Post-load wait in milliseconds when JavaScript rendering is enabled.'}, 'format': {'enum': ['html', 'text'], 'type': 'string', 'description': "Content format to return: 'html' or 'text'."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prompt'], 'properties': {'count': {'type': 'integer', 'maximum': 200, 'minimum': 10, 'description': 'Results to return per source. Min 10. Max 200.'}, 'tools': {'type': 'array', 'items': {'enum': ['web'], 'type': 'string'}, 'default': ['web'], 'minItems': 1, 'description': "Sources to search. Only 'web' is accepted; other ids are rejected before the API call. 'Web Search' is accepted and rewritten to 'web'. Defaults to ['web']."}, 'prompt': {'type': 'string', 'description': "Search query prompt, example: 'open source browser automation tools'"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "Search query, example: 'latest news on AI'"}, 'start': {'type': 'integer', 'minimum': 0, 'description': 'How many results to skip for pagination (0, 10, 20, ...). Omit for the first page.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prompt'], 'properties': {'count': {'type': 'integer', 'maximum': 200, 'minimum': 10, 'description': 'Results to return. Min 10. Max 200.'}, 'prompt': {'type': 'string', 'description': "Search query prompt, example: 'Bittensor subnet updates'"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': "The unique ID of the post, example: '1234567890'"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['post_id'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Number of posts to retrieve (1-100).'}, 'query': {'type': 'string', 'description': 'Advanced search query to filter replies.'}, 'post_id': {'type': 'string', 'description': 'The ID of the post to fetch replies for.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The ID of the post to get retweeters for.'}, 'cursor': {'type': 'string', 'description': 'Cursor for pagination from a previous response.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['urls'], 'properties': {'urls': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': "Post URLs to fetch, example: ['https://x.com/user/status/123']"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['user'], 'properties': {'user': {'type': 'string', 'description': "User to search for, example: 'elonmusk'"}, 'count': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Number of posts to retrieve (1-100).'}, 'query': {'type': 'string', 'description': "Advanced search query to filter this user's posts."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'lang': {'type': 'string', 'description': "Language code, example: 'en', 'es', 'fr'"}, 'user': {'type': 'string', 'description': "User to search for, example: 'elonmusk'"}, 'count': {'type': 'number', 'default': 20, 'description': 'Number of search results to return (default: 20), max is 100'}, 'query': {'type': 'string', 'description': "Twitter advanced search query, example: 'from:elonmusk since:2023-01-01 min_replies:10'"}, 'end_date': {'type': 'string', 'description': 'End date in UTC (YYYY-MM-DD). Use with start_date.'}, 'is_image': {'type': 'boolean', 'description': 'Include only posts with images.'}, 'is_quote': {'type': 'boolean', 'description': 'Include only posts that are quotes.'}, 'is_video': {'type': 'boolean', 'description': 'Include only posts with video.'}, 'verified': {'type': 'boolean', 'description': 'Filter for verified users.'}, 'min_likes': {'$ref': '#/properties/min_retweets', 'description': 'Minimum number of likes.'}, 'start_date': {'type': 'string', 'description': 'Start date in UTC (YYYY-MM-DD). Use with end_date.'}, 'min_replies': {'$ref': '#/properties/min_retweets', 'description': 'Minimum number of replies.'}, 'min_retweets': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'string'}], 'description': 'Minimum number of retweets.'}, 'blue_verified': {'type': 'boolean', 'description': 'Filter for blue-checkmark verified users.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['woeid'], 'properties': {'count': {'type': 'integer', 'maximum': 100, 'minimum': 30, 'description': 'Number of trends to return (30-100).'}, 'woeid': {'type': 'integer', 'description': 'WOEID of the location, example: 23424977 for the United States.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['username'], 'properties': {'cursor': {'type': 'string', 'description': 'Cursor for pagination from a previous response.'}, 'username': {'type': 'string', 'description': "Username to fetch posts for, example: 'elonmusk'"}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['user'], 'properties': {'user': {'type': 'string', 'description': "Username of the user to search for, example: 'elonmusk'"}, 'count': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Number of posts to retrieve (1-100).'}, 'query': {'type': 'string', 'description': "Advanced search query to filter this user's posts and replies."}}, 'additionalProperties': False}