CensysGPT
https://gpt.censys.io/.well-known/ai-plugin.json
{
"schema_version": "v1",
"name_for_human": "CensysGPT",
"name_for_model": "CensysGPT",
"description_for_human": "Plugin for writing Censys Search queries.",
"description_for_model": "Assists in writing Censys Search queries. Censys Queries should always be displayed in a markdown code block. Any modified Censys Query should be validated. If you are having trouble finding a field, try using the Field Recommender.",
"auth": {
"type": "none"
},
"api": {
"type": "openapi",
"url": "https://gpt.censys.io/openapi.json",
"is_user_authenticated": false
},
"logo_url": "https://gpt.censys.io/static/maskable-icon-512x512.png",
"contact_email": "gpt@censys.io",
"legal_info_url": "https://censys.io/terms-of-service/"
}https://gpt.censys.io/openapi.json
{
"openapi": "3.0.2",
"info": {
"title": "CensysGPT Beta",
"description": "CensysGPT is a natural language interface to Censys. It uses the OpenAI API to generate Censys search queries from natural language prompts. Try it out at <https://gpt.censys.io>!",
"termsOfService": "https://censys.io/terms-of-service/",
"contact": {
"name": "CensysGPT Support",
"email": "gpt@censys.io"
},
"version": "0.2.0"
},
"paths": {
"/api/generate_query": {
"post": {
"tags": [
"Generate Query"
],
"summary": "Generate Query",
"description": "Generate a Censys search query",
"operationId": "generate_query_api_generate_query_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"description": {
"type": "string",
"example": "Find all Russian FTP servers"
},
"creative": {
"type": "boolean",
"example": false
}
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "The generated Censys search query",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"censys_query": {
"type": "string",
"example": "location.country: Russia and services.service_name: FTP"
},
"censys_search_url": {
"type": "string",
"example": "https://search.censys.io/search?resource=hosts&sort=RELEVANCE&per_page=25&virtual_hosts=EXCLUDE&q=location.country%3A+Russia+and+services.service_name%3A+FTP&ref=censysgpt"
}
}
}
}
}
},
"400": {
"description": "The request body was invalid",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string",
"example": "Invalid Censys Search query, please try adjusting your description"
},
"censys_query": {
"type": "string",
"example": "location.country: Russia and services.service_name: FTP"
},
"censys_search_url": {
"type": "string",
"example": "https://search.censys.io/search?resource=hosts&sort=RELEVANCE&per_page=25&virtual_hosts=EXCLUDE&q=location.country%3A+Russia+and+services.service_name%3A+FTP&ref=censysgpt"
}
}
}
}
}
},
"429": {
"description": "Too many requests",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string",
"example": "Rate limit exceeded: [limit] per 1 minute"
}
}
}
}
}
}
},
"x-codeSamples": [
{
"lang": "Python",
"source": "import requests\n\nresponse = requests.post(\n \"https://gpt.censys.io/api/generate_query\",\n json={\"description\": \"Find all Russian FTP servers\"},\n)\nprint(response.json())"
},
{
"lang": "Bash",
"source": "curl -X POST \\\n https://gpt.censys.io/api/generate_query \\\n -H 'Content-Type: application/json' \\\n -d '{\"description\": \"Find all Russian FTP servers\"}'"
}
]
}
},
"/api/validate_query": {
"post": {
"tags": [
"Validate Query"
],
"summary": "Validate Query",
"description": "Validate a Censys search query",
"operationId": "validate_query_api_validate_query_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"search_query": {
"type": "string"
}
}
},
"examples": {
"Valid Example": {
"value": {
"search_query": "location.country: Russia and services.service_name: FTP"
}
},
"Invalid Example": {
"value": {
"search_query": "location.country: Russia and services.service_name: FTP and"
}
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "The query was successfully validated",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"valid": {
"type": "boolean"
}
}
}
}
}
},
"400": {
"description": "The request body was invalid",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string"
},
"valid": {
"type": "boolean"
}
}
},
"examples": {
"Invalid Search": {
"value": {
"error": "422 (Unprocessable Entity): Invalid search. Your query could not be parsed",
"valid": false
}
},
"Invalid Field": {
"value": {
"error": "422 (Unprocessable Entity): Invalid field: 'services.server'.",
"valid": false
}
}
}
}
}
}
}
}
},
"/api/recommend_fields": {
"post": {
"tags": [
"Recommend Fields"
],
"summary": "Recommend Fields",
"description": "Recommend Censys fields for a search query",
"operationId": "recommend_fields_api_recommend_fields_post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"description": {
"type": "string"
}
}
},
"examples": {
"Valid Example": {
"value": {
"description": "HTTP server header"
}
}
}
}
},
"required": true
},
"responses": {
"200": {
"description": "The recommended fields were successfully generated",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"fields": {
"type": "array",
"items": {
"type": "string"
},
"example": [
"services.http.response.headers.server",
"services.http.response.headers.connection",
"services.http.response.headers.x_real_ip"
]
}
}
}
}
}
},
"400": {
"description": "The request body was invalid",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
}Discover other plugins from the search category
Plugsugar
Enable ChatGPT to search the web and answer relevant questions.
0 Comments
4 Votesgetit.ai plugin search
Search for new plugins and capabilities to use
0 Comments
0 VotesOpenIndex.ai
Search through documents and websites indexed on OpenIndex.ai
0 Comments
0 VotesOneLook Thesaurus
Plugin for searching for words by describing their meaning, sound, or spelling.
0 Comments
10 VotesKeyMate.AI Search
Search the web by using a Custom Search Engine with KeyMate.AI Search, your AI-powered web search engine.
1 Comments
1 VotesVoxScript
Enables searching of YouTube transcripts, financial data sources Google Search results, and more!
0 Comments
0 VotesYelp Business Search
Discover great local businesses around you.
0 Comments
0 VotesAi Tool Hunt
Explore the ideal AI solutions for all use cases, drawn from the most comprehensive global database of AI tools.
0 Comments
0 VotesTagvenue
Search for event venues and spaces in Australia, Canada, Ireland, Singapore, the UK, and the USA.
0 Comments
0 VotesMetaphor
Access the internet's highest quality content. Recommended by people, powered by neural search.
0 Comments
0 VotesSubstack IQ
Explore Substack! Provide a link, chat with articles, find new authors, search all of Substack, & more.
0 Comments
0 VotesMantium
Fetches user-created applications from Mantium and retrieves relevant info based on user queries.
0 Comments
0 VotesJini
Get factual, knowledge-base and real-time information. Search news, images, videos, music, apps, pages and facts.
0 Comments
0 VotesPlugFinder
PlugFinder is your personal assistant for discovering AI tools.
0 Comments
0 VotesTotalQuery Search
Go beyond google search: harness the combined power of 70+ search engines for ultimate web discovery.
0 Comments
UK Politics
Search through UK political documents such as speeches, press releases, voting records, and candidates' profiles.
0 Comments
0 VotesMixerBox WebSearchG
Search and summarize the web with our customized search engine powered by Google Search API!
0 Comments
0 VotesWeb Requests
Goodbye Knowledge Cutoff, Hello World! This is your AI assistant's web browser. Just enter a URL. Google, Wiki, GitHub.
0 Comments
0 VotesPlugin.so
Companies are exposing their APIs to be consumed by AI applications such as ChatGPT and libraries Langchain. Plugin.so is scanning the top 1M+ domains and allows you to track any company launching a plugin. Get launch updates via Email or Twitter.
0 Comments
0 VotesPluginpedia
Recommend plugins in the store based on your question, and introduce their usage.
0 Comments
0 VotesScholarly
Scholarly is an AI-powered search engine for exploring scientific literature.
0 Comments
0 VotesSocial Search
The Social Search provides access to tweets, users, followers, images, media and more.
0 Comments
PuginAI
Recommend extensions based on prompt from user.
0 Comments
0 VotesOpenTools AI
Find the right AI tools for your needs from the largest collection on the web.
0 Comments
0 VotesWhat's trending?
Explore trending searches, keywords, & hashtags by topic across YouTube, Instagram, Amazon, and Google.
0 Comments
0 VotesChat Tool Finder
Find the tool in here that can help you. Search by name, category or description.
0 Comments
0 VotesClay
Ask questions and search across your network and contacts — Linkedin, Facebook, email, and iMessage.
0 Comments
0 VotesPeople Search
Search Clay's public people graph by keyword & industry. Build lists & recruit faster than Linkedin.
0 Comments
1 VotesOhMyPlug
Search and discover extensions with OhMyPlug! It guides you through the best addons in the store and explains them ðð§©ð¡.
0 Comments
0 VotesBrowserPilot
Analyse and understand web pages and search for more results.
0 Comments
0 VotesGoogle Trends Plugin
Fetch search interest data for keywords, locations, and timeframes. Get realtime search trends, and top charts.
0 Comments