{
  "openapi": "3.1.0",
  "info": {
    "title": "NOSIBLE V2.1",
    "description": "## Worldwide Web Surveillance\n**What is NOSIBLE?**\n\nNOSIBLE is a web-scale search engine. We have crawled, indexed, and cross-referenced billions of high-quality webpages, including major and local news outlets, press releases, corporate and personal blogs, academic journals, government sites, and more. Every day, we crawl and index another 15 to 25 million webpages, of which at least one million are fresh. While NOSIBLE shares similarities with search engines like Google, Bing, Brave, Perplexity, Exa, Tavily, and LinkUp, we are fundamentally different. Our unique selling proposition is our focus on surveilling the broader web to extract predictive signals for financial institutions, advertisers, and corporations. The engineering team at NOSIBLE is inspired by projects like [GDELT](https://www.gdeltproject.org/) and Wikipedia. _We are not the best search engine for finding new shoes. We are the best search engine for serious people building serious things._\n\n**How do I get started?**\n* **[Nosible Cloud](https://app.nosible.com/)** - Create and manage API keys and subscriptions.\n* **[Python Package](https://github.com/NosibleAI/nosible-py)** - Connect to this API directly from Python.\n* **[JavaScript Package](https://github.com/NosibleAI/nosible-js)** - Connect to this API directly from JS.\n* **[MCP Server](https://github.com/NosibleAI/nosible-mcp)** - Connect your AI agent directly to this API.\n\n**How do I learn more?**\n\nDrop us a mail [stuart@nosible.com](mailto:stuart@nosible.com), [matthew@nosible.com](mailto:matthew@nosible.com), or [gareth@nosible.com](mailto:gareth@nosible.com) ✌🏻",
    "version": "2.1.0"
  },
  "paths": {
    "/search/v2/limits": {
      "get": {
        "tags": ["RATE LIMITS"],
        "summary": "Retrieve Account Rate Limits",
        "description": "### **Limits:** Retrieve Your Rate Limits",
        "operationId": "limits_search_v2_limits_get",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Api-Key"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/LimitsResponse" }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/search/v2/search": {
      "post": {
        "tags": ["WEB AGENTS"],
        "summary": "LLM-Guided Monte Carlo Tree Search Search",
        "description": "### **AI Search:** Let an AI Agent Take The Wheel\n\nInstead of constructing your own search queries, expansions, and SQL filters, simply tell our AI agent what you\nare looking for. The agent will read your prompt, generate a multi-angle search strategy, launch parallel\nfan-out probes, analyze the initial text, generate high-context expansions, and perform a deep dive to return\nthe best results.\n\n---\n\n### Python Example\n\n```python\nimport requests\nimport json\n\nresponse = requests.post(\n    url=\"https://nosible.world/api/search/v2/search\",\n    json={\n        \"prompt\": (\n            \"I need to know everything about the history of the Marauder's Map being confiscated by \"\n            \"Argus Filch. How did he get it, and how did the original creators lose it?\"\n        ),\n        \"agent\": \"cybernaut-1\"\n    },\n    headers={\n        \"Accept-Encoding\": \"gzip\",\n        \"Content-Type\": \"application/json\",\n        \"api-key\": \"NOSIBLE_API_KEY\"\n    }\n)\n\nprint(json.dumps(response.json(), indent=4))\n```",
        "operationId": "search_search_v2_search_post",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SearchSchema"
              },
              "example": {
                "prompt": "I need to know everything about the history of the Marauder's Map being confiscated by Argus Filch. How did he get it, and how did the original creators lose it?"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SearchResponseEnvelope" }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/search/v2/fast-search": {
      "post": {
        "tags": ["WEB SEARCH"],
        "summary": "Just Another SERP API ... But Cheaper",
        "description": "### **Fast Search:** Just Another SERP API ... But Cheaper.\n\nAccess NOSIBLE using your API key. To get an API key please visit [app.nosible.com](https://app.nosible.com).\nThat's where you can manage organizations, users, subscriptions, and your API keys.\n\n---\n\n### SQL Filter Columns\n\n- **netloc:** include or exclude specific websites from your search results.\n- **published:** a YYYY-MM-DD string for filtering on publish dates.\n- **modified** a YYYY-MM-DD string for filtering on modified dates.\n- **visited:** a YYYY-MM-DD string for filtering on visited/crawled dates.\n- **language:** e.g. en-en (english document, english snippet).\n- **stot:** include or exclude documents based on total number of snippets.\n- **snum:** include or exclude snippets based on their index on the page.\n- **words:** include or exclude snippets based on their word count.\n- **chars:** include or exclude snippets based on their character count.\n\n---\n\n### Python Example\n\n```python\nimport requests\nimport json\n\nresponse = requests.post(\n    url=\"https://nosible.world/api/search/v2/fast-search\",\n    json={\n        \"question\": \"Why did Argus Filch confiscate the Marauder's Map?\",\n\n        \"algorithm\": \"hybrid-3\",    # Hybrid-3 is the best choice.\n        \"n_results\": 100,           # You can query up to 100 results.\n        \"n_probes\": 30,             # From 3x as many collections.\n        \"n_contextify\": 256,        # Contextify controls snippet lengths.\n        \"must_include\": [],         # Be careful when using this!\n        \"must_exclude\": [],         # Be careful when using this!\n\n        \"expansions\": [\n            # Optional & Recommended: include 10 lexically diverse but semantically equivalent expansions.\n            \"What caused Filch to originally seize the Marauder's Map from students?\",\n            \"Why did Filch find it necessary to confiscate the Marauder's Map?\",\n            \"For what specific reason did Filch take the Marauder's Map away?\",\n            \"What led Filch to grab the Marauder's Map during that era?\",\n            \"Why was the Marauder's Map ultimately placed in the office of Filch?\",\n            \"Why did Filch decide to impound the Marauder's Map so long ago?\",\n            \"What rationale did Filch use for confiscating the elusive Marauder's Map?\",\n            \"Why did the caretaker Filch keep the Marauder's Map in his drawer?\",\n            \"Which events caused Filch to strip the Marauder's Map from others?\",\n            \"Why did Filch feel compelled to intercept the famous Marauder's Map?\"\n        ],\n\n        \"sql_filter\": \"SELECT loc FROM engine WHERE words\u003E=30\"\n    },\n    headers={\n        \"Accept-Encoding\": \"gzip\",\n        \"Content-Type\": \"application/json\",\n        \"api-key\": \"NOSIBLE_API_KEY\"\n    }\n)\n\nprint(json.dumps(response.json(), indent=4))\n```",
        "operationId": "fast_search_search_v2_fast_search_post",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FastSearchSchema"
              },
              "example": {
                "question": "Why did Argus Filch confiscate the Marauder's Map?",
                "n_results": 100
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SearchResponseEnvelope" }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/search/v2/time-search": {
      "post": {
        "tags": ["WEB SEARCH"],
        "summary": "Search a Topic Through Time",
        "description": "Run the same relevance search independently for every interval in a requested publication-time range. Time Search is asynchronous and returns an encrypted, Zstandard-compressed download. Frequency accepts a positive integer followed by h, d, w, or mo. Requests are limited to 500 buckets and 50,000 total requested results.",
        "operationId": "time_search_search_v2_time_search_post",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": { "type": "string", "title": "Api-Key" }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": { "$ref": "#/components/schemas/TimeSearchSchema" },
              "example": {
                "question": "How is AI infrastructure investment changing?",
                "start": "2026-04-08T00:00:00Z",
                "end": "2026-04-11T00:00:00Z",
                "frequency": "1d",
                "sort": "ascending",
                "require_timezone": false,
                "n_results": 25
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Time search task accepted",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkSearchResponse" } } }
          },
          "422": {
            "description": "Validation Error",
            "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }
          }
        }
      }
    },
    "/search/v2/rich-search": {
      "post": {
        "tags": ["WEB SEARCH"],
        "summary": "For Serious People Building Serious Things",
        "description": "### **Rich Search:** For Serious People Building Serious Things.\n\nAccess maximally-enriched search results that come with full embeddings, quant signals, content classifications,\nwebsite insights, domain authority scores, AI-generated answers, and more.\n\n---\n\n**Available Enrichments**\n\n- **enrich_profile:** Enrich search results with the profile of the website/netloc.\n- **enrich_targeting:** Enrich search results with ad targeting information.\n- **enrich_history:** Enrich search results with the publish history of the website/netloc.\n- **enrich_signals:** Enrich search results with extra quantitative signals.\n- **enrich_vectors:** Enrich search results with 1-bit quantized, base64 encoded vectors.\n\n---\n\n### SQL Filter Columns\n\n- **netloc:** include or exclude specific websites from your search results.\n- **published:** a YYYY-MM-DD string for filtering on publish dates.\n- **modified** a YYYY-MM-DD string for filtering on modified dates.\n- **visited:** a YYYY-MM-DD string for filtering on visited/crawled dates.\n- **language:** e.g. en-en (english document, english snippet).\n- **stot:** include or exclude documents based on total number of snippets.\n- **snum:** include or exclude snippets based on their index on the page.\n- **words:** include or exclude snippets based on their word count.\n- **chars:** include or exclude snippets based on their character count.\n\n---\n\n### Python Example\n\n```python\nimport requests\nimport json\n\nresponse = requests.post(\n    url=\"https://nosible.world/api/search/v2/rich-search\",\n    json={\n        \"question\": \"Why did Argus Filch confiscate the Marauder's Map?\",\n\n        \"enrich_profile\": True,         # Adds \"profile\" to search results.\n        \"enrich_targeting\": True,       # Adds \"targeting\" to search results.\n        \"enrich_history\": True,         # Adds \"history\" to search results.\n        \"enrich_signals\": True,         # Adds \"signals\" to search results.\n        \"enrich_vectors\": True,         # Adds \"vectors\" to search results.\n\n        \"algorithm\": \"hybrid-3\",        # Hybrid-3 is the best choice.\n        \"n_results\": 100,               # You can query up to 100 results.\n        \"n_probes\": 30,                 # From 3x as many collections.\n        \"n_contextify\": 256,            # Contextify controls snippet lengths.\n        \"must_include\": [],             # Be careful when using this!\n        \"must_exclude\": [],             # Be careful when using this!\n\n        \"expansions\": [\n            # Optional & Recommended: include 10 lexically diverse but semantically equivalent expansions.\n            \"What caused Filch to originally seize the Marauder's Map from students?\",\n            \"Why did Filch find it necessary to confiscate the Marauder's Map?\",\n            \"For what specific reason did Filch take the Marauder's Map away?\",\n            \"What led Filch to grab the Marauder's Map during that era?\",\n            \"Why was the Marauder's Map ultimately placed in the office of Filch?\",\n            \"Why did Filch decide to impound the Marauder's Map so long ago?\",\n            \"What rationale did Filch use for confiscating the elusive Marauder's Map?\",\n            \"Why did the caretaker Filch keep the Marauder's Map in his drawer?\",\n            \"Which events caused Filch to strip the Marauder's Map from others?\",\n            \"Why did Filch feel compelled to intercept the famous Marauder's Map?\"\n        ],\n\n        \"sql_filter\": \"SELECT loc FROM engine WHERE words\u003E=30\"\n    },\n    headers={\n        \"Accept-Encoding\": \"gzip\",\n        \"Content-Type\": \"application/json\",\n        \"api-key\": \"NOSIBLE_API_KEY\"\n    }\n)\n\nprint(json.dumps(response.json(), indent=4))\n```\n\n⚠️ Please be aware: latencies are high if all enrichments are enabled.",
        "operationId": "rich_search_search_v2_rich_search_post",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RichSearchSchema"
              },
              "example": {
                "question": "Why did Argus Filch confiscate the Marauder's Map?",
                "n_results": 100
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SearchResponseEnvelope" }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/search/v2/bulk-search": {
      "post": {
        "tags": ["WEB SEARCH"],
        "summary": "Access The Long Tail (10,000 Results)",
        "description": "### **Bulk Search:** Access The Long Tail (10,000 Results).\n\nAccess the top 10,000 search results instead of just the top 100. This endpoint will return a path to a file\non S3 that will contain an encrypted copy of your search result. Searches take 15-45 seconds.\n\n---\n\n### SQL Filter Columns\n\n- **netloc:** include or exclude specific websites from your search results.\n- **published:** a YYYY-MM-DD string for filtering on publish dates.\n- **modified** a YYYY-MM-DD string for filtering on modified dates.\n- **visited:** a YYYY-MM-DD string for filtering on visited/crawled dates.\n- **language:** e.g. en-en (english document, english snippet).\n- **stot:** include or exclude documents based on total number of snippets.\n- **snum:** include or exclude snippets based on their index on the page.\n- **words:** include or exclude snippets based on their word count.\n- **chars:** include or exclude snippets based on their character count.\n\n---\n\n### Python Example\n\n```python\nimport requests\nimport json\nimport time\n\nimport zstandard as zstd\nfrom cryptography.fernet import Fernet\n\nresponse = requests.post(\n    url=\"https://nosible.world/api/search/v2/bulk-search\",\n    json={\n        \"question\": \"Why did Argus Filch confiscate the Marauder's Map?\",\n\n        \"algorithm\": \"hybrid-3\",        # Hybrid-3 is the best choice.\n        \"n_results\": 1000,              # You can query up to 10,000 results.\n        \"n_probes\": 100,                # From 100 collections for deep coverage.\n        \"n_contextify\": 128,            # Contextify controls snippet lengths.\n        \"must_include\": [],             # Be careful when using this!\n        \"must_exclude\": [],             # Be careful when using this!\n\n        \"expansions\": [\n            # Optional & Recommended: include 10 lexically diverse but semantically equivalent expansions.\n            \"What caused Filch to originally seize the Marauder's Map from students?\",\n            \"Why did Filch find it necessary to confiscate the Marauder's Map?\",\n            \"For what specific reason did Filch take the Marauder's Map away?\",\n            \"What led Filch to grab the Marauder's Map during that era?\",\n            \"Why was the Marauder's Map ultimately placed in the office of Filch?\",\n            \"Why did Filch decide to impound the Marauder's Map so long ago?\",\n            \"What rationale did Filch use for confiscating the elusive Marauder's Map?\",\n            \"Why did the caretaker Filch keep the Marauder's Map in his drawer?\",\n            \"Which events caused Filch to strip the Marauder's Map from others?\",\n            \"Why did Filch feel compelled to intercept the famous Marauder's Map?\"\n        ],\n\n        \"sql_filter\": \"SELECT loc FROM engine WHERE words\u003E=30\"\n    },\n    headers={\n        \"Accept-Encoding\": \"gzip\",\n        \"Content-Type\": \"application/json\",\n        \"api-key\": \"NOSIBLE_API_KEY\"\n    }\n)\n\ndownload_details = response.json()\ndownload_from = download_details[\"download_from\"]\ndecrypt_using = download_details[\"decrypt_using\"]\n\nprint(json.dumps(download_details, indent=4))\n\nfor i in range(30):\n    print(\".\", end=\"\")\n    time.sleep(1)\n\nprint(\"\")\nprint(\"downloading ...\")\n\ns3_response = requests.get(download_from)\ns3_response.raise_for_status()\nfernet = Fernet(decrypt_using.encode(\"utf-8\"))\ndecrypted_data = fernet.decrypt(s3_response.content)\ndecompressor = zstd.ZstdDecompressor()\ndecompressed_data = decompressor.decompress(decrypted_data)\n\nprint(json.dumps(json.loads(decompressed_data), indent=4))\n```",
        "operationId": "bulk_search_search_v2_bulk_search_post",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SlowSearchSchema"
              },
              "example": {
                "question": "Why did Argus Filch confiscate the Marauder's Map?",
                "n_results": 1000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/BulkSearchResponse" }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/search/v2/scrape-url": {
      "post": {
        "tags": ["WEB SCRAPER"],
        "summary": "Turn Any Webpage Into Beautiful JSON",
        "description": "### **Scrape URL:** Turn Any Webpage Into Beautiful JSON.\n\nTurn messy HTML pages into structured, machine-readable JSON. Provide a target URL, and NOSIBLE will\nreturn a clean object containing the article text, metadata, authors, publish dates, and more.\n\n---\n\n### Python Example\n\n```python\nimport requests\nimport json\n\nresponse = requests.post(\n    url=\"https://nosible.world/api/search/v2/scrape-url\",\n    json={\n        # The URL that you would like NOSIBLE to scrape, process, and to turn into JSON.\n        \"url\": \"https://zakpodmore.substack.com/p/mothers-for-nuclear-targets-utahs\",\n    },\n    headers={\n        \"Accept-Encoding\": \"gzip\",\n        \"Content-Type\": \"application/json\",\n        \"api-key\": \"NOSIBLE_API_KEY\"\n    }\n)\n\nprint(json.dumps(response.json(), indent=4))\n```",
        "operationId": "scrape_url_search_v2_scrape_url_post",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VisitSchema"
              },
              "example": {
                "url": "https://nosible.ghost.io/ensemble-and-distil/"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/ScrapeResponse" }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/search/v2/topic-trend": {
      "post": {
        "tags": ["WEB MENTIONS"],
        "summary": "Turn Your Query Into a Time-Series",
        "description": "### **Topic Trend:** Turn Your Query Into a Time-Series.\n\nPass a keyword or phrase, and NOSIBLE will return a time-series representing its prevalence across the web\nover time. This is perfect for tracking the rise and fall of narratives, products, or events.\n\n---\n\n### Python Example\n\n```python\nimport requests\nimport json\n\nresponse = requests.post(\n    url=\"https://nosible.world/api/search/v2/topic-trend\",\n    json={\n        \"query\": \"Christmas Shopping\",\n        \"sql_filter\": \"SELECT loc FROM engine\"\n    },\n    headers={\n        \"Accept-Encoding\": \"gzip\",\n        \"Content-Type\": \"application/json\",\n        \"api-key\": \"NOSIBLE_API_KEY\"\n    },\n    timeout=60\n)\n\nprint(json.dumps(response.json(), indent=4))\n```",
        "operationId": "topic_trend_search_v2_topic_trend_post",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TrendSchema"
              },
              "example": {
                "query": "Christmas Shopping"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/TopicTrendResponse" }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/search/v2/save-search": {
      "post": {
        "tags": ["WEB ALERTS [BETA]"],
        "summary": "Let Us Bring The Web To You",
        "description": "### **Save Search:** Let Us Bring The Web To You.\n\nNOTE: This is a beta endpoint. Examples are coming soon.",
        "operationId": "save_search_search_v2_save_search_post",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaveSearchSchema"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SearchResponseEnvelope" }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/search/v2/delete-search": {
      "post": {
        "tags": ["WEB ALERTS [BETA]"],
        "summary": "Turn Off Your Saved Search",
        "description": "### **Delete Search:** Turn Off A Saved Search.\n\nNOTE: This is a beta endpoint. Examples are coming soon.",
        "operationId": "delete_search_search_v2_delete_search_post",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteSearchSchema"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SearchResponseEnvelope" }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    },
    "/search/v2/get-searches": {
      "post": {
        "tags": ["WEB ALERTS [BETA]"],
        "summary": "Retrieve All Your Saved Searches.",
        "description": "### **Get Searches:** Retrieve All Your Saved Searches.\n\nNOTE: This is a beta endpoint. Examples are coming soon.",
        "operationId": "get_searches_search_v2_get_searches_post",
        "parameters": [
          {
            "name": "Api-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "title": "Api-Key"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetSearchesSchema"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": { "$ref": "#/components/schemas/SearchResponseEnvelope" }
              }
            }
          },
          "422": {
            "description": "Validation Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Agents": {
        "type": "string",
        "enum": ["cybernaut-1"],
        "const": "cybernaut-1",
        "title": "Agents"
      },
      "Algorithms": {
        "type": "string",
        "enum": [
          "string",
          "lexical",
          "baseline",
          "hamming",
          "hybrid-1",
          "hybrid-2",
          "hybrid-3",
          "company"
        ],
        "title": "Algorithms"
      },
      "BrandSafety": {
        "type": "string",
        "enum": ["Safe", "Sensitive", "Unsafe"],
        "title": "BrandSafety"
      },
      "Continent": {
        "type": "string",
        "enum": [
          "Africa",
          "Asia",
          "Europe",
          "North America",
          "Oceania",
          "South America",
          "Worldwide"
        ],
        "title": "Continent"
      },
      "CountryName": {
        "type": "string",
        "enum": [
          "Worldwide",
          "Afghanistan",
          "Albania",
          "Algeria",
          "Andorra",
          "Angola",
          "Antigua and Barbuda",
          "Argentina",
          "Armenia",
          "Australia",
          "Austria",
          "Azerbaijan",
          "Bahamas",
          "Bahrain",
          "Bangladesh",
          "Barbados",
          "Belarus",
          "Belgium",
          "Belize",
          "Benin",
          "Bhutan",
          "Bolivia",
          "Bosnia and Herzegovina",
          "Botswana",
          "Brazil",
          "Brunei",
          "Bulgaria",
          "Burkina Faso",
          "Burundi",
          "Cabo Verde",
          "Cambodia",
          "Cameroon",
          "Canada",
          "Central African Republic",
          "Chad",
          "Chile",
          "China",
          "Colombia",
          "Comoros",
          "Congo (Congo-Brazzaville)",
          "Costa Rica",
          "Croatia",
          "Cuba",
          "Cyprus",
          "Czech Republic",
          "Democratic Republic of the Congo",
          "Denmark",
          "Djibouti",
          "Dominica",
          "Dominican Republic",
          "Ecuador",
          "Egypt",
          "El Salvador",
          "Equatorial Guinea",
          "Eritrea",
          "Estonia",
          "Eswatini",
          "Ethiopia",
          "Fiji",
          "Finland",
          "France",
          "Gabon",
          "Gambia",
          "Georgia",
          "Germany",
          "Ghana",
          "Greece",
          "Grenada",
          "Guatemala",
          "Guinea",
          "Guinea-Bissau",
          "Guyana",
          "Haiti",
          "Honduras",
          "Hungary",
          "Iceland",
          "India",
          "Indonesia",
          "Iran",
          "Iraq",
          "Ireland",
          "Israel",
          "Italy",
          "Jamaica",
          "Japan",
          "Jordan",
          "Kazakhstan",
          "Kenya",
          "Kiribati",
          "Kuwait",
          "Kyrgyzstan",
          "Laos",
          "Latvia",
          "Lebanon",
          "Lesotho",
          "Liberia",
          "Libya",
          "Liechtenstein",
          "Lithuania",
          "Luxembourg",
          "Madagascar",
          "Malawi",
          "Malaysia",
          "Maldives",
          "Mali",
          "Malta",
          "Marshall Islands",
          "Mauritania",
          "Mauritius",
          "Mexico",
          "Micronesia",
          "Moldova",
          "Monaco",
          "Mongolia",
          "Montenegro",
          "Morocco",
          "Mozambique",
          "Myanmar",
          "Namibia",
          "Nauru",
          "Nepal",
          "Netherlands",
          "New Zealand",
          "Nicaragua",
          "Niger",
          "Nigeria",
          "North Korea",
          "North Macedonia",
          "Norway",
          "Oman",
          "Pakistan",
          "Palau",
          "Panama",
          "Papua New Guinea",
          "Paraguay",
          "Peru",
          "Philippines",
          "Poland",
          "Portugal",
          "Qatar",
          "Romania",
          "Russia",
          "Rwanda",
          "Saint Kitts and Nevis",
          "Saint Lucia",
          "Saint Vincent and the Grenadines",
          "Samoa",
          "San Marino",
          "Sao Tome and Principe",
          "Saudi Arabia",
          "Senegal",
          "Serbia",
          "Seychelles",
          "Sierra Leone",
          "Singapore",
          "Slovakia",
          "Slovenia",
          "Solomon Islands",
          "Somalia",
          "South Africa",
          "South Korea",
          "South Sudan",
          "Spain",
          "Sri Lanka",
          "Sudan",
          "Suriname",
          "Sweden",
          "Switzerland",
          "Syria",
          "Taiwan",
          "Tajikistan",
          "Tanzania",
          "Thailand",
          "Timor-Leste",
          "Togo",
          "Tonga",
          "Trinidad and Tobago",
          "Tunisia",
          "Turkey",
          "Turkmenistan",
          "Tuvalu",
          "Uganda",
          "Ukraine",
          "United Arab Emirates",
          "United Kingdom",
          "United States",
          "Uruguay",
          "Uzbekistan",
          "Vanuatu",
          "Vatican City",
          "Venezuela",
          "Vietnam",
          "Yemen",
          "Zambia",
          "Zimbabwe",
          "Jersey",
          "Guernsey",
          "Isle of Man",
          "British Virgin Islands",
          "Cayman Islands",
          "Bermuda",
          "Gibraltar",
          "Hong Kong"
        ],
        "title": "CountryName"
      },
      "DeleteSearchSchema": {
        "properties": {
          "search_id": {
            "type": "string",
            "minLength": 1,
            "title": "Search Id",
            "description": "The ID of the search to delete."
          }
        },
        "type": "object",
        "required": ["search_id"],
        "title": "DeleteSearchSchema"
      },
      "FastSearchSchema": {
        "properties": {
          "instruction": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Instruction",
            "description": "The instruction to pass along to the embedding mode. USE WITH CAUTION.",
            "default": "Retrieve semantically similar text."
          },
          "question": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Question",
            "description": "The question you would like your search results to answer.",
            "default": "Why did Argus Filch confiscate the Marauder's Map?"
          },
          "expansions": {
            "items": {},
            "type": "array",
            "maxItems": 10,
            "minItems": 0,
            "title": "Expansions",
            "description": "Semantically and lexically similar expansions.",
            "default": []
          },
          "sql_filter": {
            "type": "string",
            "title": "Sql Filter",
            "description": "A SQL filter to narrow down your search results",
            "default": "SELECT loc FROM engine"
          },
          "algorithm": {
            "$ref": "#/components/schemas/Algorithms",
            "description": "The algorithm to use when scoring search results.",
            "default": "hybrid-3"
          },
          "min_similarity": {
            "type": "number",
            "maximum": 1,
            "minimum": 0,
            "title": "Min Similarity",
            "description": "The minimum similarity that a result must have.",
            "default": 0
          },
          "must_exclude": {
            "items": {},
            "type": "array",
            "maxItems": 100,
            "minItems": 0,
            "title": "Must Exclude",
            "description": "All of the following strings must be excluded from each result.",
            "default": []
          },
          "must_include": {
            "items": {},
            "type": "array",
            "maxItems": 100,
            "minItems": 0,
            "title": "Must Include",
            "description": "Any of the following strings must be included in each result.",
            "default": []
          },
          "brand_safety": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BrandSafety"
              },
              {
                "type": "null"
              }
            ],
            "description": "The brand safety level to apply. Options: 'Safe', 'Sensitive', or 'Unsafe'."
          },
          "language": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Language"
              },
              {
                "type": "null"
              }
            ],
            "description": "The language code. Allowed values: EN, FR, DE, ES, etc. Can be null."
          },
          "continent": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Continent"
              },
              {
                "type": "null"
              }
            ],
            "description": "The continent you would like your search results to be refined to."
          },
          "region": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Region"
              },
              {
                "type": "null"
              }
            ],
            "description": "The geographic region you would like your search results to be refined to."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CountryName"
              },
              {
                "type": "null"
              }
            ],
            "description": "The country you would like your search results to be refined to."
          },
          "sector": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sector"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS sector you would like your search results to be refined to."
          },
          "industry_group": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IndustryGroup"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS industry group you would like your search results to be refined to."
          },
          "industry": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Industry"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS industry you would like your search results to be refined to."
          },
          "sub_industry": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SubIndustry"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS sub-industry you would like your search results to be refined to."
          },
          "iab_tier_1": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier1"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 1 IAB category you would like your search results to be refined to."
          },
          "iab_tier_2": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier2"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 2 IAB category you would like your search results to be refined to."
          },
          "iab_tier_3": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier3"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 3 IAB category you would like your search results to be refined to."
          },
          "iab_tier_4": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier4"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 4 IAB category you would like your search results to be refined to."
          },
          "companies": {
            "items": {},
            "type": "array",
            "maxItems": 3,
            "minItems": 0,
            "title": "Companies",
            "description": "A list of company names. This will be used to refine the search results.",
            "default": []
          },
          "collection": {
            "type": "string",
            "enum": ["everything", "this-week"],
            "title": "Collection",
            "description": "Collection used to constrain retrieval."
          },
          "deduplicate": {
            "type": "boolean",
            "title": "Deduplicate",
            "description": "Whether to remove duplicate documents from the returned evidence set.",
            "default": false
          },
          "internal_use": {
            "type": "object",
            "title": "Internal Use",
            "description": "Internal-only. Used to enable hidden features and new algorithms from time to time."
          },
          "n_results": {
            "type": "integer",
            "maximum": 100,
            "minimum": 10,
            "title": "N Results",
            "description": "The number of search results you would like.",
            "default": 10
          },
          "n_probes": {
            "type": "integer",
            "maximum": 50,
            "minimum": 5,
            "title": "N Probes",
            "description": "The number of shards you would like your search.",
            "default": 30
          },
          "n_contextify": {
            "type": "integer",
            "maximum": 1024,
            "minimum": 64,
            "title": "N Contextify",
            "description": "The amount of context you would like per search result.",
            "default": 256
          }
        },
        "type": "object",
        "title": "FastSearchSchema"
      },
      "FeedAlgorithms": {
        "type": "string",
        "enum": ["hybrid-3"],
        "const": "hybrid-3",
        "title": "FeedAlgorithms"
      },
      "GetSearchesSchema": {
        "properties": {},
        "type": "object",
        "title": "GetSearchesSchema"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "type": "array",
            "title": "Detail"
          }
        },
        "type": "object",
        "title": "HTTPValidationError"
      },
      "IabTier1": {
        "type": "string",
        "enum": [
          "Attractions",
          "Automotive",
          "Books and Literature",
          "Business and Finance",
          "Careers",
          "Communication",
          "Crime",
          "Disasters",
          "Education",
          "Entertainment",
          "Events",
          "Family and Relationships",
          "Fine Art",
          "Food & Drink",
          "Genres",
          "Healthy Living",
          "Hobbies & Interests",
          "Holidays",
          "Home & Garden",
          "Law",
          "Maps & Navigation",
          "Medical Health",
          "Personal Celebrations & Life Events",
          "Personal Finance",
          "Pets",
          "Politics",
          "Pop Culture",
          "Productivity",
          "Real Estate",
          "Religion & Spirituality",
          "Science",
          "Sensitive Topics",
          "Shopping",
          "Sports",
          "Style & Fashion",
          "Technology & Computing",
          "Travel",
          "Video Gaming",
          "War and Conflicts"
        ],
        "title": "IabTier1"
      },
      "IabTier2": {
        "type": "string",
        "enum": [
          "Action/Adventure",
          "Adult & Explicit Sexual Content",
          "Adult Album Alternative",
          "Adult Contemporary Music",
          "Adult Education",
          "Agnosticism",
          "Alcoholic Beverages",
          "Alternative Music",
          "American Football",
          "Amusement and Theme Parks",
          "Animation & Anime",
          "Anniversary",
          "Antiquing and Antiques",
          "Apartments",
          "Apprenticeships",
          "Arms & Ammunition",
          "Art and Photography",
          "Artificial Intelligence",
          "Arts and Crafts",
          "Astrology",
          "Atheism",
          "Attractions",
          "Augmented Reality",
          "Australian Rules Football",
          "Auto Body Styles",
          "Auto Buying and Selling",
          "Auto Insurance",
          "Auto Parts",
          "Auto Racing",
          "Auto Recalls",
          "Auto Rentals",
          "Auto Repair",
          "Auto Safety",
          "Auto Shows",
          "Auto Technology",
          "Auto Type",
          "Automotive",
          "Awards Shows",
          "Baby Shower",
          "Bachelor Party",
          "Bachelorette Party",
          "Badminton",
          "Barbecues and Grilling",
          "Bars & Restaurants",
          "Baseball",
          "Basketball",
          "Beach Volleyball",
          "Beauty",
          "Beekeeping",
          "Bereavement",
          "Biographies",
          "Biological Sciences",
          "Birds",
          "Birdwatching",
          "Birth",
          "Birthday",
          "Blues",
          "Body Art",
          "Bodybuilding",
          "Books and Literature",
          "Bowling",
          "Boxing",
          "Buddhism",
          "Business",
          "Business Expos & Conferences",
          "Business and Finance",
          "Car Culture",
          "Career Advice",
          "Career Planning",
          "Careers",
          "Casinos & Gambling",
          "Cats",
          "Celebrity Deaths",
          "Celebrity Families",
          "Celebrity Homes",
          "Celebrity Pregnancy",
          "Celebrity Relationships",
          "Celebrity Scandal",
          "Celebrity Style",
          "Cheerleading",
          "Chemistry",
          "Children's Clothing",
          "Children's Games and Toys",
          "Children's Health",
          "Children's Music",
          "Christianity",
          "Cigars",
          "Civic affairs",
          "Classic Hits",
          "Classical Music",
          "Collecting",
          "College Education",
          "College Radio",
          "College Sports",
          "Comedy",
          "Comedy (Music and Audio)",
          "Comics and Graphic Novels",
          "Communication",
          "Computing",
          "Console Games",
          "Consumer Banking",
          "Consumer Electronics",
          "Contemporary Hits/Pop/Top 40",
          "Content Production",
          "Cooking",
          "Cosmetic Medical Services",
          "Costume",
          "Country Music",
          "Coupons and Discounts",
          "Cricket",
          "Crime",
          "Crime & Harmful Acts to Individuals, Society & Human Right Violations",
          "Cycling",
          "Dance",
          "Dance and Electronic Music",
          "Darts",
          "Dash Cam Videos",
          "Dating",
          "Death, Injury, or Military Conflict",
          "Debated Sensitive Social Issues",
          "Design",
          "Designer Clothing",
          "Desserts and Baking",
          "Developmental Sites",
          "Digital Arts",
          "Dining Out",
          "Disabled Sports",
          "Disasters",
          "Diseases and Conditions",
          "Diving",
          "Divorce",
          "Documentary",
          "Dogs",
          "Drama",
          "Early Childhood Education",
          "Economy",
          "Education",
          "Educational Assessment",
          "Eldercare",
          "Elections",
          "Entertainment",
          "Environment",
          "Equine Sports",
          "Events",
          "Extreme Sports",
          "Factual",
          "Family and Relationships",
          "Family/Children",
          "Fan Conventions",
          "Fantasy",
          "Fantasy Sports",
          "Fashion Trends",
          "Fiction",
          "Field Hockey",
          "Figure Skating",
          "Financial Assistance",
          "Financial Planning",
          "Fine Art",
          "Fine Art Photography",
          "Fish and Aquariums",
          "Fishing Sports",
          "Fitness and Exercise",
          "Flower Shopping",
          "Food & Drink",
          "Food Allergies",
          "Food Movements",
          "Frugal Living",
          "Funeral",
          "Games and Puzzles",
          "Gardening",
          "Genealogy and Ancestry",
          "Genetics",
          "Genres",
          "Geography",
          "Geology",
          "Gifts and Greetings Cards",
          "Golf",
          "Gospel Music",
          "Graduation",
          "Grocery Shopping",
          "Gymnastics",
          "Hate Speech and Acts of Aggression",
          "Healthy Cooking and Eating",
          "Healthy Living",
          "High Fashion",
          "Hinduism",
          "Hip Hop Music",
          "Historic Site and Landmark Tours",
          "History",
          "Hobbies & Interests",
          "Holiday",
          "Holiday Shopping",
          "Holidays",
          "Home & Garden",
          "Home Appliances",
          "Home Entertaining",
          "Home Improvement",
          "Home Security",
          "Home Utilities",
          "Homeschooling",
          "Homework and Study",
          "Horror",
          "Hotel Properties",
          "Household Supplies",
          "Houses",
          "Humor and Satire",
          "Hunting and Shooting",
          "Ice Hockey",
          "Illegal Drugs, Tobacco, eCigarettes, Vaping, Alcohol",
          "Indoor Environmental Quality",
          "Industrial Property",
          "Industries",
          "Inline Skating",
          "Inspirational/New Age Music",
          "Insurance",
          "Interior Decorating",
          "Islam",
          "Jazz",
          "Job Search",
          "Judaism",
          "Lacrosse",
          "Land and Farms",
          "Landscaping",
          "Language Learning",
          "Large Animals",
          "Law",
          "Lifestyle",
          "Lotteries and Scratchcards",
          "Magic and Illusion",
          "Malls & Shopping Centers",
          "Maps & Navigation",
          "Marriage and Civil Unions",
          "Martial Arts",
          "Medical Health",
          "Medical Tests",
          "Men's Fashion",
          "Men's Health",
          "Mobile Games",
          "Model Toys",
          "Modern Art",
          "Motorcycles",
          "Movies",
          "Museums & Galleries",
          "Music",
          "Music Video",
          "Musical",
          "Musical Instruments",
          "Mystery",
          "National & Civic Holidays",
          "Nature",
          "Nightclubs",
          "Non-Alcoholic Beverages",
          "Nutrition",
          "Obscenity and Profanity",
          "Office Property",
          "Oldies/Adult Standards",
          "Olympic Sports",
          "Online Education",
          "Online Piracy",
          "Opera",
          "Outdoor Activities",
          "Outdoor Decorating",
          "PC Games",
          "Paranormal Phenomena",
          "Parenting",
          "Parks & Nature",
          "Party Supplies and Decorations",
          "Personal Care",
          "Personal Celebrations & Life Events",
          "Personal Debt",
          "Personal Finance",
          "Personal Investing",
          "Personal Taxes",
          "Pet Adoptions",
          "Pet Supplies",
          "Pets",
          "Pharmaceutical Drugs",
          "Physics",
          "Poetry",
          "Poker and Professional Gambling",
          "Political Issues & policy",
          "Politics",
          "Pop Culture",
          "Primary Education",
          "Private School",
          "Productivity",
          "Prom",
          "R&B/Soul/Funk",
          "Radio Control",
          "Real Estate",
          "Real Estate Buying and Selling",
          "Real Estate Renting and Leasing",
          "Reality TV",
          "Reggae",
          "Religion & Spirituality",
          "Religious (Music and Audio)",
          "Remodeling & Construction",
          "Remote Working",
          "Reptiles",
          "Retail Property",
          "Retirement Planning",
          "Road-Side Assistance",
          "Robotics",
          "Rock Music",
          "Rodeo",
          "Romance",
          "Rowing",
          "Rugby",
          "Sailing",
          "Sales and Promotions",
          "Sci-fi and Fantasy",
          "Science",
          "Science Fiction",
          "Scooters",
          "Secondary Education",
          "Senior Health",
          "Sensitive Topics",
          "Shopping",
          "Sikhism",
          "Single Life",
          "Skiing",
          "Smart Home",
          "Snooker/Pool/Billiards",
          "Soap Opera",
          "Soccer",
          "Softball",
          "Songwriters/Folk",
          "Soundtracks, TV and Showtunes",
          "Space and Astronomy",
          "Spam or Harmful Content",
          "Special Education",
          "Special Interest (Indie/Art House)",
          "Spirituality",
          "Sports",
          "Sports Equipment",
          "Sports Radio",
          "Squash",
          "Street Style",
          "Style & Fashion",
          "Surgery",
          "Swimming",
          "Table Tennis",
          "Talk Radio",
          "Talk Show",
          "Technology & Computing",
          "Television",
          "Tennis",
          "Terrorism",
          "Theater",
          "Theater Venues",
          "Thriller",
          "Track and Field",
          "Travel",
          "Travel Accessories",
          "Travel Locations",
          "Travel Preparation and Advice",
          "Travel Type",
          "True Crime",
          "Urban Contemporary Music",
          "Vacation Properties",
          "Vaccines",
          "Variety (Music and Audio)",
          "Vegan Diets",
          "Vegetarian Diets",
          "Veterinary Medicine",
          "Video Game Genres",
          "Video Gaming",
          "Virtual Reality",
          "Vocational Training",
          "Volleyball",
          "Walking",
          "War and Conflicts",
          "Water Polo",
          "Weather",
          "Wedding",
          "Weight Loss",
          "Weightlifting",
          "Wellness",
          "Western",
          "Women's Fashion",
          "Women's Health",
          "Workshops and Classes",
          "World Cuisines",
          "World/International Music",
          "Wrestling",
          "Young Adult",
          "Zoos & Aquariums",
          "eSports"
        ],
        "title": "IabTier2"
      },
      "IabTier3": {
        "type": "string",
        "enum": [
          "Action Video Games",
          "Action-Adventure Video Games",
          "Action/Adventure",
          "Adoption and Fostering",
          "Adult & Explicit Sexual Content",
          "Adult Album Alternative",
          "Adult Contemporary Music",
          "Adult Education",
          "Adult Video Games",
          "Adventure Travel",
          "Adventure Video Games",
          "Advertising Industry",
          "Africa Travel",
          "Agnosticism",
          "Agriculture",
          "Air Travel",
          "Album-oriented Rock",
          "Alcoholic Beverages",
          "Allergies",
          "Alternative Medicine",
          "Alternative Music",
          "Alternative Rock",
          "American Football",
          "Amusement and Theme Parks",
          "Animation & Anime",
          "Anniversary",
          "Antiquing and Antiques",
          "Apartments",
          "Apparel Industry",
          "Apprenticeships",
          "Arms & Ammunition",
          "Art and Photography",
          "Artificial Intelligence",
          "Arts and Crafts",
          "Asia Travel",
          "Astrology",
          "Atheism",
          "Attractions",
          "Audio Production",
          "Augmented Reality",
          "Australia and Oceania Travel",
          "Australian Rules Football",
          "Auto Body Styles",
          "Auto Buying and Selling",
          "Auto Infotainment Technologies",
          "Auto Insurance",
          "Auto Navigation Systems",
          "Auto Parts",
          "Auto Racing",
          "Auto Recalls",
          "Auto Rentals",
          "Auto Repair",
          "Auto Safety",
          "Auto Safety Technologies",
          "Auto Shows",
          "Auto Technology",
          "Auto Type",
          "Automotive",
          "Automotive Industry",
          "Aviation Industry",
          "Awards Shows",
          "Baby Shower",
          "Bachelor Party",
          "Bachelorette Party",
          "Badminton",
          "Barbecues and Grilling",
          "Bars & Restaurants",
          "Baseball",
          "Basketball",
          "Bath and Shower",
          "Beach Travel",
          "Beach Volleyball",
          "Beadwork",
          "Beauty",
          "Bed & Breakfasts",
          "Beekeeping",
          "Bereavement",
          "Biographies",
          "Biological Sciences",
          "Biotech and Biomedical Industry",
          "Birds",
          "Birdwatching",
          "Birth",
          "Birthday",
          "Blood Disorders",
          "Blues",
          "Board Games and Puzzles",
          "Body Art",
          "Bodybuilding",
          "Bone and Joint Conditions",
          "Books and Literature",
          "Bowling",
          "Boxing",
          "Brain and Nervous System Disorders",
          "Buddhism",
          "Budget Cars",
          "Budget Travel",
          "Business",
          "Business Accounting & Finance",
          "Business Administration",
          "Business Banking & Finance",
          "Business Expos & Conferences",
          "Business I.T.",
          "Business Operations",
          "Business Travel",
          "Business Utilities",
          "Business and Finance",
          "Cameras and Camcorders",
          "Camping",
          "Cancer",
          "Candle and Soap Making",
          "Canoeing and Kayaking",
          "Car Culture",
          "Card Games",
          "Career Advice",
          "Career Planning",
          "Careers",
          "Casino and Gambling Video Games",
          "Casinos & Gambling",
          "Casual Games",
          "Cats",
          "Celebrity Deaths",
          "Celebrity Families",
          "Celebrity Homes",
          "Celebrity Pregnancy",
          "Celebrity Relationships",
          "Celebrity Scandal",
          "Celebrity Style",
          "Certified Pre-Owned Cars",
          "Cheerleading",
          "Chemistry",
          "Children's Clothing",
          "Children's Games and Toys",
          "Children's Health",
          "Children's Music",
          "Christianity",
          "Cigars",
          "Civic affairs",
          "Civil Engineering Industry",
          "Classic Cars",
          "Classic Hits",
          "Classic Rock",
          "Classical Music",
          "Climbing",
          "Cold and Flu",
          "Collecting",
          "College Baseball",
          "College Basketball",
          "College Education",
          "College Football",
          "College Planning",
          "College Radio",
          "College Sports",
          "Comedy",
          "Comedy (Music and Audio)",
          "Comic Books",
          "Comics and Graphic Novels",
          "Commercial Trucks",
          "Commodities",
          "Communication",
          "Computer Networking",
          "Computer Peripherals",
          "Computer Software and Applications",
          "Computing",
          "Concept Cars",
          "Console Games",
          "Construction Industry",
          "Consumer Banking",
          "Consumer Electronics",
          "Consumer Issues",
          "Contemporary Hits/Pop/Top 40",
          "Content Production",
          "Convertible",
          "Cooking",
          "Cosmetic Medical Services",
          "Costume",
          "Country Music",
          "Coupe",
          "Coupons and Discounts",
          "Credit Cards",
          "Cricket",
          "Crime",
          "Crime & Harmful Acts to Individuals, Society & Human Right Violations",
          "Crossover",
          "Cruises",
          "Currencies",
          "Cycling",
          "Dance",
          "Dance and Electronic Music",
          "Darts",
          "Dash Cam Videos",
          "Data Storage and Warehousing",
          "Dating",
          "Day Trips",
          "Daycare and Pre-School",
          "Death, Injury, or Military Conflict",
          "Debated Sensitive Social Issues",
          "Defense Industry",
          "Dental Health",
          "Deodorant and Antiperspirant",
          "Design",
          "Designer Clothing",
          "Desktops",
          "Desserts and Baking",
          "Developmental Sites",
          "Diabetes",
          "Digestive Disorders",
          "Digital Arts",
          "Dining Out",
          "Disabled Sports",
          "Disasters",
          "Diseases and Conditions",
          "Diving",
          "Divorce",
          "Documentary",
          "Dogs",
          "Drama",
          "Drawing and Sketching",
          "Driverless Cars",
          "Ear, Nose and Throat Conditions",
          "Early Childhood Education",
          "Economy",
          "Education",
          "Education industry",
          "Educational Assessment",
          "Educational Video Games",
          "Eldercare",
          "Elections",
          "Endocrine and Metabolic Diseases",
          "Entertainment",
          "Entertainment Industry",
          "Environment",
          "Environmental Services Industry",
          "Equine Sports",
          "Europe Travel",
          "Events",
          "Executive Leadership & Management",
          "Exercise and Fitness Video Games",
          "Extreme Sports",
          "Eye and Vision Conditions",
          "Factual",
          "Family Travel",
          "Family Video Games",
          "Family and Relationships",
          "Family/Children",
          "Fan Conventions",
          "Fantasy",
          "Fantasy Sports",
          "Fashion Trends",
          "Fiction",
          "Field Hockey",
          "Figure Skating",
          "Financial Assistance",
          "Financial Crisis",
          "Financial Industry",
          "Financial Planning",
          "Financial Reform",
          "Financial Regulation",
          "Fine Art",
          "Fine Art Photography",
          "Fish and Aquariums",
          "Fishing Sports",
          "Fitness and Exercise",
          "Flower Shopping",
          "Food & Drink",
          "Food Allergies",
          "Food Industry",
          "Food Movements",
          "Foot Health",
          "Freelance Writing",
          "Frugal Living",
          "Funeral",
          "Games and Puzzles",
          "Gardening",
          "Gas and Electric",
          "Gasoline Prices",
          "Genealogy and Ancestry",
          "Genetics",
          "Genres",
          "Geography",
          "Geology",
          "Gifts and Greetings Cards",
          "Golf",
          "Gospel Music",
          "Government Business",
          "Government Support and Welfare",
          "Graduation",
          "Green Solutions",
          "Green Vehicles",
          "Grocery Shopping",
          "Gymnastics",
          "Hair Care",
          "Hard Rock",
          "Hatchback",
          "Hate Speech and Acts of Aggression",
          "Health Insurance",
          "Healthcare Industry",
          "Healthy Cooking and Eating",
          "Healthy Living",
          "Heart and Cardiovascular Diseases",
          "Hedge Funds",
          "High Fashion",
          "Hinduism",
          "Hip Hop Music",
          "Historic Site and Landmark Tours",
          "History",
          "Hobbies & Interests",
          "Holiday",
          "Holiday Shopping",
          "Holidays",
          "Home & Garden",
          "Home Appliances",
          "Home Entertaining",
          "Home Entertainment Systems",
          "Home Financing",
          "Home Improvement",
          "Home Insurance",
          "Home Security",
          "Home Utilities",
          "Homeschooling",
          "Homework and Study",
          "Honeymoons and Getaways",
          "Horror",
          "Horror Video Games",
          "Horse Racing",
          "Hospitality Industry",
          "Hotel Properties",
          "Hotels and Motels",
          "Household Supplies",
          "Houses",
          "Housing Market",
          "Human Resources",
          "Humor and Satire",
          "Hunting and Shooting",
          "Ice Hockey",
          "Illegal Drugs, Tobacco, eCigarettes, Vaping, Alcohol",
          "Indoor Environmental Quality",
          "Industrial Property",
          "Industries",
          "Infectious Diseases",
          "Information Services Industry",
          "Information and Network Security",
          "Injuries",
          "Inline Skating",
          "Inspirational/New Age Music",
          "Insurance",
          "Interest Rates",
          "Interior Decorating",
          "Internet",
          "Internet Safety",
          "Internet Service Providers",
          "Islam",
          "Jazz",
          "Jewelry Making",
          "Job Fairs",
          "Job Market",
          "Job Search",
          "Judaism",
          "Lacrosse",
          "Land and Farms",
          "Landscaping",
          "Language Learning",
          "Laptops",
          "Large Animals",
          "Large Business",
          "Law",
          "Legal Services Industry",
          "Life Insurance",
          "Lifestyle",
          "Logistics",
          "Logistics and Transportation Industry",
          "Lotteries and Scratchcards",
          "Lung and Respiratory Health",
          "Luxury Cars",
          "MMOs",
          "Magic and Illusion",
          "Makeup and Accessories",
          "Malls & Shopping Centers",
          "Management Consulting Industry",
          "Manufacturing Industry",
          "Maps & Navigation",
          "Marketing and Advertising",
          "Marriage and Civil Unions",
          "Martial Arts",
          "Mechanical and Industrial Engineering Industry",
          "Media Industry",
          "Medical Health",
          "Medical Tests",
          "Men's Accessories",
          "Men's Clothing",
          "Men's Fashion",
          "Men's Health",
          "Men's Shoes and Footwear",
          "Mental Health",
          "Metals Industry",
          "Microcar",
          "Minivan",
          "Mobile Games",
          "Model Toys",
          "Modern Art",
          "Motor Insurance",
          "Motorcycle Sports",
          "Motorcycles",
          "Movies",
          "Museums & Galleries",
          "Music",
          "Music Video",
          "Music and Party Video Games",
          "Musical Instruments",
          "Musicals",
          "Mutual Funds",
          "Mystery",
          "Nail Care",
          "National & Civic Holidays",
          "Natural and Organic Beauty",
          "Nature",
          "Needlework",
          "Nightclubs",
          "Non-Alcoholic Beverages",
          "Non-Profit Organizations",
          "North America Travel",
          "Nutrition",
          "Obscenity and Profanity",
          "Off-Road Vehicles",
          "Office Property",
          "Oldies/Adult Standards",
          "Olympic Sports",
          "Online Education",
          "Online Piracy",
          "Opera",
          "Options",
          "Oral care",
          "Outdoor Attractions",
          "Outdoor Decorating",
          "PC Games",
          "Paintball",
          "Painting",
          "Paranormal Phenomena",
          "Parenting",
          "Parenting Babies and Toddlers",
          "Parenting Children Aged 4-11",
          "Parenting Teens",
          "Parks",
          "Participant Sports",
          "Party Supplies and Decorations",
          "Performance Cars",
          "Perfume and Fragrance",
          "Personal Care",
          "Personal Celebrations & Life Events",
          "Personal Debt",
          "Personal Finance",
          "Personal Investing",
          "Personal Loans",
          "Personal Taxes",
          "Pet Adoptions",
          "Pet Insurance",
          "Pet Supplies",
          "Pets",
          "Pharmaceutical Drugs",
          "Pharmaceutical Industry",
          "Phone Services",
          "Photography",
          "Physical Therapy",
          "Physics",
          "Pickup Trucks",
          "Poetry",
          "Poker and Professional Gambling",
          "Polar Travel",
          "Political Issues & Policy",
          "Politics",
          "Pop Culture",
          "Postgraduate Education",
          "Power and Energy Industry",
          "Primary Education",
          "Private School",
          "Productivity",
          "Programming Languages",
          "Prom",
          "Public Radio",
          "Publishing Industry",
          "Puzzle Video Games",
          "R&B/Soul/Funk",
          "Racing Video Games",
          "Radio Control",
          "Rail Travel",
          "Real Estate",
          "Real Estate Buying and Selling",
          "Real Estate Industry",
          "Real Estate Renting and Leasing",
          "Reality TV",
          "Reggae",
          "Religion & Spirituality",
          "Religious (Music and Audio)",
          "Remodeling & Construction",
          "Remote Working",
          "Reproductive Health",
          "Reptiles",
          "Resume Writing and Advice",
          "Retail Industry",
          "Retail Property",
          "Retirement Planning",
          "Road Trips",
          "Road-Side Assistance",
          "Robotics",
          "Rock Music",
          "Rodeo",
          "Role-Playing Video Games",
          "Roleplaying Games",
          "Romance",
          "Rowing",
          "Rugby",
          "Rugby League",
          "Rugby Union",
          "Running and Jogging",
          "SUV",
          "Sailing",
          "Sales",
          "Sales and Promotions",
          "Sci-fi and Fantasy",
          "Science",
          "Science Fiction",
          "Scooters",
          "Scrapbooking",
          "Screenwriting",
          "Scuba Diving",
          "Secondary Education",
          "Sedan",
          "Senior Health",
          "Sensitive Topics",
          "Sexual Health",
          "Shaving",
          "Shopping",
          "Sikhism",
          "Simulation Video Games",
          "Single Life",
          "Skateboarding",
          "Skiing",
          "Skin Care",
          "Skin and Dermatology",
          "Sleep Disorders",
          "Small and Medium-sized Business",
          "Smart Home",
          "Smartphones",
          "Smoking Cessation",
          "Snooker/Pool/Billiards",
          "Snowboarding",
          "Soap Opera",
          "Soccer",
          "Soft AC Music",
          "Soft Rock",
          "Softball",
          "Songwriters/Folk",
          "Soundtracks, TV and Showtunes",
          "South America Travel",
          "Space and Astronomy",
          "Spam or Harmful Content",
          "Spas",
          "Special Education",
          "Special Interest (Indie/Art House)",
          "Special Needs Kids",
          "Spirituality",
          "Sports",
          "Sports Equipment",
          "Sports Radio",
          "Sports Video Games",
          "Squash",
          "Stamps and Coins",
          "Standardized Testing",
          "Startups",
          "Station Wagon",
          "Stocks and Bonds",
          "Strategy Video Games",
          "Street Style",
          "Student Financial Aid",
          "Student Loans",
          "Style & Fashion",
          "Substance Abuse",
          "Summer Olympic Sports",
          "Surfing and Bodyboarding",
          "Surgery",
          "Swimming",
          "Table Tennis",
          "Tablets and E-readers",
          "Talk Radio",
          "Talk Show",
          "Technology & Computing",
          "Technology Industry",
          "Telecommunications Industry",
          "Television",
          "Tennis",
          "Terrorism",
          "Theater",
          "Theater Venues",
          "Thriller",
          "Track and Field",
          "Travel",
          "Travel Accessories",
          "Travel Insurance",
          "Travel Locations",
          "Travel Preparation and Advice",
          "Travel Type",
          "True Crime",
          "Undergraduate Education",
          "Urban AC Music",
          "Urban Contemporary Music",
          "Vacation Properties",
          "Vaccines",
          "Van",
          "Variety (Music and Audio)",
          "Vegan Diets",
          "Vegetarian Diets",
          "Veterinary Medicine",
          "Video Game Genres",
          "Video Gaming",
          "Video Production",
          "Virtual Reality",
          "Vocational Training",
          "Volleyball",
          "Walking",
          "War and Conflicts",
          "Water Polo",
          "Water Services",
          "Waterskiing and Wakeboarding",
          "Wearable Technology",
          "Weather",
          "Wedding",
          "Weight Loss",
          "Weightlifting",
          "Wellness",
          "Western",
          "Winter Olympic Sports",
          "Women's Accessories",
          "Women's Clothing",
          "Women's Fashion",
          "Women's Health",
          "Women's Shoes and Footwear",
          "Woodworking",
          "Workshops and Classes",
          "World Cuisines",
          "World/International Music",
          "Wrestling",
          "Young Adult",
          "Zoos & Aquariums",
          "eSports"
        ],
        "title": "IabTier3"
      },
      "IabTier4": {
        "type": "string",
        "enum": [
          "3-D Graphics",
          "Action Video Games",
          "Action-Adventure Video Games",
          "Action/Adventure",
          "Adoption and Fostering",
          "Adult & Explicit Sexual Content",
          "Adult Album Alternative",
          "Adult Contemporary Music",
          "Adult Education",
          "Adult Video Games",
          "Adventure Travel",
          "Adventure Video Games",
          "Advertising Industry",
          "Africa Travel",
          "Agnosticism",
          "Agriculture",
          "Air Travel",
          "Album-oriented Rock",
          "Alcoholic Beverages",
          "Allergies",
          "Alternative Medicine",
          "Alternative Music",
          "Alternative Rock",
          "American Football",
          "Amusement and Theme Parks",
          "Angel Investment",
          "Animation & Anime",
          "Anniversary",
          "Antiquing and Antiques",
          "Antivirus Software",
          "Apartments",
          "Apparel Industry",
          "Apprenticeships",
          "Arms & Ammunition",
          "Art and Photography",
          "Artificial Intelligence",
          "Arts and Crafts",
          "Asia Travel",
          "Astrology",
          "Atheism",
          "Attractions",
          "Audio Production",
          "Augmented Reality",
          "Australia and Oceania Travel",
          "Australian Rules Football",
          "Auto Body Styles",
          "Auto Buying and Selling",
          "Auto Infotainment Technologies",
          "Auto Insurance",
          "Auto Navigation Systems",
          "Auto Parts",
          "Auto Racing",
          "Auto Recalls",
          "Auto Rentals",
          "Auto Repair",
          "Auto Safety",
          "Auto Safety Technologies",
          "Auto Shows",
          "Auto Technology",
          "Auto Type",
          "Automotive",
          "Automotive Industry",
          "Aviation Industry",
          "Awards Shows",
          "Baby Shower",
          "Bachelor Party",
          "Bachelorette Party",
          "Badminton",
          "Bankruptcy",
          "Barbecues and Grilling",
          "Bars & Restaurants",
          "Baseball",
          "Basketball",
          "Bath and Shower",
          "Beach Travel",
          "Beach Volleyball",
          "Beadwork",
          "Beauty",
          "Bed & Breakfasts",
          "Beekeeping",
          "Bereavement",
          "Biographies",
          "Biological Sciences",
          "Biotech and Biomedical Industry",
          "Birds",
          "Birdwatching",
          "Birth",
          "Birth Control",
          "Birthday",
          "Blood Disorders",
          "Blues",
          "Board Games and Puzzles",
          "Body Art",
          "Bodybuilding",
          "Bone and Joint Conditions",
          "Books and Literature",
          "Bowling",
          "Boxing",
          "Brain and Nervous System Disorders",
          "Browsers",
          "Buddhism",
          "Budget Cars",
          "Budget Travel",
          "Business",
          "Business Accounting & Finance",
          "Business Administration",
          "Business Banking & Finance",
          "Business Expos & Conferences",
          "Business I.T.",
          "Business Loans",
          "Business Operations",
          "Business Travel",
          "Business Utilities",
          "Business and Finance",
          "Cameras and Camcorders",
          "Camping",
          "Cancer",
          "Candle and Soap Making",
          "Canoeing and Kayaking",
          "Car Culture",
          "Card Games",
          "Career Advice",
          "Career Planning",
          "Careers",
          "Casino and Gambling Video Games",
          "Casinos & Gambling",
          "Casual Games",
          "Cats",
          "Celebrity Deaths",
          "Celebrity Families",
          "Celebrity Homes",
          "Celebrity Pregnancy",
          "Celebrity Relationships",
          "Celebrity Scandal",
          "Celebrity Style",
          "Certified Pre-Owned Cars",
          "Cheerleading",
          "Chemistry",
          "Children's Clothing",
          "Children's Games and Toys",
          "Children's Health",
          "Children's Music",
          "Christianity",
          "Cigars",
          "Civic affairs",
          "Civil Engineering Industry",
          "Classic Cars",
          "Classic Hits",
          "Classic Rock",
          "Classical Music",
          "Climbing",
          "Cloud Computing",
          "Cold and Flu",
          "Collecting",
          "College Baseball",
          "College Basketball",
          "College Education",
          "College Football",
          "College Planning",
          "College Radio",
          "College Sports",
          "Comedy",
          "Comedy (Music and Audio)",
          "Comic Books",
          "Comics and Graphic Novels",
          "Commercial Trucks",
          "Commodities",
          "Communication",
          "Computer Animation",
          "Computer Networking",
          "Computer Peripherals",
          "Computing",
          "Concept Cars",
          "Console Games",
          "Construction Industry",
          "Consumer Banking",
          "Consumer Electronics",
          "Consumer Issues",
          "Contemporary Hits/Pop/Top 40",
          "Content Production",
          "Convertible",
          "Cooking",
          "Cosmetic Medical Services",
          "Costume",
          "Country Music",
          "Coupe",
          "Coupons and Discounts",
          "Credit Cards",
          "Cricket",
          "Crime",
          "Crime & Harmful Acts to Individuals, Society & Human Right Violations",
          "Crossover",
          "Cruises",
          "Currencies",
          "Cycling",
          "Dance",
          "Dance and Electronic Music",
          "Darts",
          "Dash Cam Videos",
          "Data Storage and Warehousing",
          "Databases",
          "Dating",
          "Day Trips",
          "Daycare and Pre-School",
          "Death, Injury, or Military Conflict",
          "Debated Sensitive Social Issues",
          "Debt Factoring & Invoice Discounting",
          "Defense Industry",
          "Dental Health",
          "Deodorant and Antiperspirant",
          "Design",
          "Designer Clothing",
          "Desktop Publishing",
          "Desktops",
          "Desserts and Baking",
          "Developmental Sites",
          "Diabetes",
          "Digestive Disorders",
          "Digital Arts",
          "Digital Audio",
          "Dining Out",
          "Disabled Sports",
          "Disasters",
          "Diseases and Conditions",
          "Diving",
          "Divorce",
          "Documentary",
          "Dogs",
          "Drama",
          "Drawing and Sketching",
          "Driverless Cars",
          "Ear, Nose and Throat Conditions",
          "Early Childhood Education",
          "Economy",
          "Education",
          "Education industry",
          "Educational Assessment",
          "Educational Video Games",
          "Eldercare",
          "Elections",
          "Email",
          "Endocrine and Metabolic Diseases",
          "Entertainment",
          "Entertainment Industry",
          "Environment",
          "Environmental Services Industry",
          "Equine Sports",
          "Europe Travel",
          "Events",
          "Executive Leadership & Management",
          "Exercise and Fitness Video Games",
          "Extreme Sports",
          "Eye and Vision Conditions",
          "Factual",
          "Family Travel",
          "Family Video Games",
          "Family and Relationships",
          "Family/Children",
          "Fan Conventions",
          "Fantasy",
          "Fantasy Sports",
          "Fashion Trends",
          "Fiction",
          "Field Hockey",
          "Figure Skating",
          "Financial Assistance",
          "Financial Crisis",
          "Financial Industry",
          "Financial Planning",
          "Financial Reform",
          "Financial Regulation",
          "Fine Art",
          "Fine Art Photography",
          "First Aid",
          "Fish and Aquariums",
          "Fishing Sports",
          "Fitness and Exercise",
          "Flower Shopping",
          "Food & Drink",
          "Food Allergies",
          "Food Industry",
          "Food Movements",
          "Foot Health",
          "Freelance Writing",
          "Frugal Living",
          "Funeral",
          "Games and Puzzles",
          "Gardening",
          "Gas and Electric",
          "Gasoline Prices",
          "Genealogy and Ancestry",
          "Genetics",
          "Genres",
          "Geography",
          "Geology",
          "Gifts and Greetings Cards",
          "Golf",
          "Gospel Music",
          "Government Business",
          "Government Support and Welfare",
          "Graduation",
          "Graphics Software",
          "Green Solutions",
          "Green Vehicles",
          "Grocery Shopping",
          "Gymnastics",
          "Hair Care",
          "Hard Rock",
          "Hatchback",
          "Hate Speech and Acts of Aggression",
          "Health Insurance",
          "Healthcare Industry",
          "Healthy Cooking and Eating",
          "Healthy Living",
          "Heart and Cardiovascular Diseases",
          "Hedge Funds",
          "Herbs and Supplements",
          "High Fashion",
          "Hinduism",
          "Hip Hop Music",
          "Historic Site and Landmark Tours",
          "History",
          "Hobbies & Interests",
          "Holiday",
          "Holiday Shopping",
          "Holidays",
          "Holistic Health",
          "Home & Garden",
          "Home Appliances",
          "Home Entertaining",
          "Home Entertainment Systems",
          "Home Financing",
          "Home Improvement",
          "Home Insurance",
          "Home Security",
          "Home Utilities",
          "Homeschooling",
          "Homework and Study",
          "Honeymoons and Getaways",
          "Hormonal Disorders",
          "Horror",
          "Horror Video Games",
          "Horse Racing",
          "Hospitality Industry",
          "Hotel Properties",
          "Hotels and Motels",
          "Household Supplies",
          "Houses",
          "Housing Market",
          "Human Resources",
          "Humor and Satire",
          "Hunting and Shooting",
          "IT and Internet Support",
          "Ice Hockey",
          "Illegal Drugs, Tobacco, eCigarettes, Vaping, Alcohol",
          "Indoor Environmental Quality",
          "Industrial Property",
          "Industries",
          "Infectious Diseases",
          "Infertility",
          "Information Services Industry",
          "Information and Network Security",
          "Injuries",
          "Inline Skating",
          "Inspirational/New Age Music",
          "Insurance",
          "Interest Rates",
          "Interior Decorating",
          "Internet",
          "Internet Safety",
          "Internet Service Providers",
          "Internet for Beginners",
          "Internet of Things",
          "Islam",
          "Jazz",
          "Jewelry Making",
          "Job Fairs",
          "Job Market",
          "Job Search",
          "Judaism",
          "Lacrosse",
          "Land and Farms",
          "Landscaping",
          "Language Learning",
          "Laptops",
          "Large Animals",
          "Large Business",
          "Law",
          "Legal Services Industry",
          "Life Insurance",
          "Lifestyle",
          "Logistics",
          "Logistics and Transportation Industry",
          "Lotteries and Scratchcards",
          "Lung and Respiratory Health",
          "Luxury Cars",
          "MMOs",
          "Magic and Illusion",
          "Makeup and Accessories",
          "Malls & Shopping Centers",
          "Management Consulting Industry",
          "Manufacturing Industry",
          "Maps & Navigation",
          "Marketing and Advertising",
          "Marriage and Civil Unions",
          "Martial Arts",
          "Mechanical and Industrial Engineering Industry",
          "Media Industry",
          "Medical Health",
          "Medical Tests",
          "Men's Accessories",
          "Men's Business Wear",
          "Men's Casual Wear",
          "Men's Clothing",
          "Men's Fashion",
          "Men's Formal Wear",
          "Men's Health",
          "Men's Jewelry and Watches",
          "Men's Outerwear",
          "Men's Shoes and Footwear",
          "Men's Sportswear",
          "Men's Underwear and Sleepwear",
          "Menopause",
          "Mental Health",
          "Mergers and Acquisitions",
          "Metals Industry",
          "Microcar",
          "Minivan",
          "Mobile Games",
          "Model Toys",
          "Modern Art",
          "Motor Insurance",
          "Motorcycle Sports",
          "Motorcycles",
          "Movies",
          "Museums & Galleries",
          "Music",
          "Music Video",
          "Music and Party Video Games",
          "Musical Instruments",
          "Musicals",
          "Mutual Funds",
          "Mystery",
          "Nail Care",
          "National & Civic Holidays",
          "Natural and Organic Beauty",
          "Nature",
          "Needlework",
          "Nightclubs",
          "Non-Alcoholic Beverages",
          "Non-Profit Organizations",
          "North America Travel",
          "Nutrition",
          "Obscenity and Profanity",
          "Off-Road Vehicles",
          "Office Property",
          "Oldies/Adult Standards",
          "Olympic Sports",
          "Online Education",
          "Online Piracy",
          "Opera",
          "Operating Systems",
          "Options",
          "Oral care",
          "Outdoor Attractions",
          "Outdoor Decorating",
          "PC Games",
          "Paintball",
          "Painting",
          "Paranormal Phenomena",
          "Parenting",
          "Parenting Babies and Toddlers",
          "Parenting Children Aged 4-11",
          "Parenting Teens",
          "Parks",
          "Participant Sports",
          "Party Supplies and Decorations",
          "Performance Cars",
          "Perfume and Fragrance",
          "Personal Care",
          "Personal Celebrations & Life Events",
          "Personal Debt",
          "Personal Finance",
          "Personal Investing",
          "Personal Loans",
          "Personal Taxes",
          "Pet Adoptions",
          "Pet Insurance",
          "Pet Supplies",
          "Pets",
          "Pharmaceutical Drugs",
          "Pharmaceutical Industry",
          "Phone Services",
          "Photo Editing Software",
          "Photography",
          "Physical Therapy",
          "Physics",
          "Pickup Trucks",
          "Poetry",
          "Poker and Professional Gambling",
          "Polar Travel",
          "Political Issues & Policy",
          "Politics",
          "Pop Culture",
          "Postgraduate Education",
          "Power and Energy Industry",
          "Pregnancy",
          "Primary Education",
          "Private Equity",
          "Private School",
          "Productivity",
          "Professional School",
          "Programming Languages",
          "Prom",
          "Public Radio",
          "Publishing Industry",
          "Puzzle Video Games",
          "R&B/Soul/Funk",
          "Racing Video Games",
          "Radio Control",
          "Rail Travel",
          "Real Estate",
          "Real Estate Buying and Selling",
          "Real Estate Industry",
          "Real Estate Renting and Leasing",
          "Reality TV",
          "Recalls",
          "Reggae",
          "Religion & Spirituality",
          "Religious (Music and Audio)",
          "Remodeling & Construction",
          "Remote Working",
          "Reproductive Health",
          "Reptiles",
          "Resume Writing and Advice",
          "Retail Industry",
          "Retail Property",
          "Retirement Planning",
          "Road Trips",
          "Road-Side Assistance",
          "Robotics",
          "Rock Music",
          "Rodeo",
          "Role-Playing Video Games",
          "Roleplaying Games",
          "Romance",
          "Rowing",
          "Rugby",
          "Rugby League",
          "Rugby Union",
          "Running and Jogging",
          "SUV",
          "Sailing",
          "Sale & Lease Back",
          "Sales",
          "Sales and Promotions",
          "Sci-fi and Fantasy",
          "Science",
          "Science Fiction",
          "Scooters",
          "Scrapbooking",
          "Screenwriting",
          "Scuba Diving",
          "Search",
          "Secondary Education",
          "Sedan",
          "Senior Health",
          "Sensitive Topics",
          "Sexual Conditions",
          "Sexual Health",
          "Shareware and Freeware",
          "Shaving",
          "Shopping",
          "Sikhism",
          "Simulation Video Games",
          "Single Life",
          "Skateboarding",
          "Skiing",
          "Skin Care",
          "Skin and Dermatology",
          "Sleep Disorders",
          "Small and Medium-sized Business",
          "Smart Home",
          "Smartphones",
          "Smoking Cessation",
          "Snooker/Pool/Billiards",
          "Snowboarding",
          "Soap Opera",
          "Soccer",
          "Social Networking",
          "Soft AC Music",
          "Soft Rock",
          "Softball",
          "Software and Applications",
          "Songwriters/Folk",
          "Soundtracks, TV and Showtunes",
          "South America Travel",
          "Space and Astronomy",
          "Spam or Harmful Content",
          "Spas",
          "Special Education",
          "Special Interest (Indie/Art House)",
          "Special Needs Kids",
          "Spirituality",
          "Sports",
          "Sports Equipment",
          "Sports Radio",
          "Sports Video Games",
          "Squash",
          "Stamps and Coins",
          "Standardized Testing",
          "Startups",
          "Station Wagon",
          "Stocks and Bonds",
          "Strategy Video Games",
          "Street Style",
          "Student Financial Aid",
          "Student Loans",
          "Style & Fashion",
          "Substance Abuse",
          "Summer Olympic Sports",
          "Surfing and Bodyboarding",
          "Surgery",
          "Swimming",
          "Table Tennis",
          "Tablets and E-readers",
          "Talk Radio",
          "Talk Show",
          "Technology & Computing",
          "Technology Industry",
          "Telecommunications Industry",
          "Television",
          "Tennis",
          "Terrorism",
          "Theater",
          "Theater Venues",
          "Thriller",
          "Thyroid Disorders",
          "Track and Field",
          "Travel",
          "Travel Accessories",
          "Travel Insurance",
          "Travel Locations",
          "Travel Preparation and Advice",
          "Travel Type",
          "True Crime",
          "Undergraduate Education",
          "Urban AC Music",
          "Urban Contemporary Music",
          "Vacation Properties",
          "Vaccines",
          "Van",
          "Variety (Music and Audio)",
          "Vegan Diets",
          "Vegetarian Diets",
          "Venture Capital",
          "Veterinary Medicine",
          "Video Game Genres",
          "Video Gaming",
          "Video Production",
          "Video Software",
          "Virtual Reality",
          "Vocational Training",
          "Volleyball",
          "Walking",
          "War and Conflicts",
          "Water Polo",
          "Water Services",
          "Waterskiing and Wakeboarding",
          "Wearable Technology",
          "Weather",
          "Web Conferencing",
          "Web Design and HTML",
          "Web Development",
          "Web Hosting",
          "Wedding",
          "Weight Loss",
          "Weightlifting",
          "Wellness",
          "Western",
          "Winter Olympic Sports",
          "Women's Accessories",
          "Women's Business Wear",
          "Women's Casual Wear",
          "Women's Clothing",
          "Women's Fashion",
          "Women's Formal Wear",
          "Women's Glasses",
          "Women's Handbags and Wallets",
          "Women's Hats and Scarves",
          "Women's Health",
          "Women's Intimates and Sleepwear",
          "Women's Jewelry and Watches",
          "Women's Outerwear",
          "Women's Shoes and Footwear",
          "Women's Sportswear",
          "Woodworking",
          "Workshops and Classes",
          "World Cuisines",
          "World/International Music",
          "Wrestling",
          "Young Adult",
          "Zoos & Aquariums",
          "eSports"
        ],
        "title": "IabTier4"
      },
      "Industry": {
        "type": "string",
        "enum": [
          "Other",
          "Financial Services",
          "Aerospace & Defense",
          "Air Freight & Logistics",
          "Automobile Components",
          "Automobiles",
          "Banks",
          "Beverages",
          "Biotechnology",
          "Broadline Retail",
          "Building Products",
          "Capital Markets",
          "Chemicals",
          "Commercial Services & Supplies",
          "Communications Equipment",
          "Construction & Engineering",
          "Construction Materials",
          "Consumer Finance",
          "Consumer Staples Distribution & Retail",
          "Containers & Packaging",
          "Distributors",
          "Diversified Consumer Services",
          "Diversified REITs",
          "Diversified Telecommunication Services",
          "Electric Utilities",
          "Electrical Equipment",
          "Electronic Equipment, Instruments & Components",
          "Energy Equipment & Services",
          "Entertainment",
          "Food Products",
          "Gas Utilities",
          "Ground Transportation",
          "Health Care Equipment & Supplies",
          "Health Care Providers & Services",
          "Health Care REITs",
          "Health Care Technology",
          "Hotel & Resort REITs",
          "Hotels, Restaurants & Leisure",
          "Household Durables",
          "Household Products",
          "IT Services",
          "Independent Power and Renewable Electricity Producers",
          "Industrial Conglomerates",
          "Industrial REITs",
          "Insurance",
          "Interactive Media & Services",
          "Leisure Products",
          "Life Sciences Tools & Services",
          "Machinery",
          "Marine Transportation",
          "Media",
          "Metals & Mining",
          "Mortgage Real Estate Investment Trusts (REITs)",
          "Multi-Utilities",
          "Office REITs",
          "Oil, Gas & Consumable Fuels",
          "Paper & Forest Products",
          "Passenger Airlines",
          "Personal Care Products",
          "Pharmaceuticals",
          "Professional Services",
          "Real Estate Management & Development",
          "Residential REITs",
          "Retail REITs",
          "Semiconductors & Semiconductor Equipment",
          "Software",
          "Specialized REITs",
          "Specialty Retail",
          "Technology Hardware, Storage & Peripherals",
          "Textiles, Apparel & Luxury Goods",
          "Tobacco",
          "Trading Companies & Distributors",
          "Transportation Infrastructure",
          "Water Utilities",
          "Wireless Telecommunication Services"
        ],
        "title": "Industry"
      },
      "IndustryGroup": {
        "type": "string",
        "enum": [
          "Other",
          "Automobiles & Components",
          "Banks",
          "Capital Goods",
          "Commercial  & Professional Services",
          "Consumer Discretionary Distribution & Retail",
          "Consumer Durables & Apparel",
          "Consumer Services",
          "Consumer Staples Distribution & Retail",
          "Energy",
          "Equity Real Estate Investment Trusts (REITs)",
          "Financial Services",
          "Food, Beverage & Tobacco",
          "Health Care Equipment & Services",
          "Household & Personal Products",
          "Insurance",
          "Materials",
          "Media & Entertainment",
          "Pharmaceuticals, Biotechnology & Life Sciences",
          "Real Estate Management & Development",
          "Semiconductors & Semiconductor Equipment",
          "Software & Services",
          "Technology Hardware & Equipment",
          "Telecommunication Services",
          "Transportation",
          "Utilities"
        ],
        "title": "IndustryGroup"
      },
      "Language": {
        "type": "string",
        "enum": [
          "af",
          "am",
          "ar",
          "as",
          "az",
          "be",
          "bg",
          "bn",
          "br",
          "bs",
          "ca",
          "cs",
          "cy",
          "da",
          "de",
          "el",
          "en",
          "eo",
          "es",
          "et",
          "eu",
          "fa",
          "fi",
          "fr",
          "fy",
          "ga",
          "gd",
          "gl",
          "gu",
          "ha",
          "he",
          "hi",
          "hr",
          "hu",
          "hy",
          "id",
          "is",
          "it",
          "ja",
          "jv",
          "ka",
          "kk",
          "km",
          "kn",
          "ko",
          "ku",
          "ky",
          "la",
          "lo",
          "lt",
          "lv",
          "mg",
          "mk",
          "ml",
          "mn",
          "mr",
          "ms",
          "my",
          "ne",
          "nl",
          "no",
          "om",
          "or",
          "pa",
          "pl",
          "ps",
          "pt",
          "ro",
          "ru",
          "sa",
          "sd",
          "sh",
          "si",
          "sk",
          "sl",
          "so",
          "sq",
          "sr",
          "su",
          "sv",
          "sw",
          "ta",
          "te",
          "th",
          "tl",
          "tr",
          "ug",
          "uk",
          "ur",
          "uz",
          "vi",
          "xh",
          "yi",
          "zh"
        ],
        "title": "Language"
      },
      "Region": {
        "type": "string",
        "enum": [
          "Caribbean",
          "Central Africa",
          "Central America",
          "Central Asia",
          "Central Europe",
          "East Africa",
          "East Asia",
          "Eastern Europe",
          "Middle East",
          "North Africa",
          "North America",
          "Northern Europe",
          "Oceania",
          "South America",
          "South Asia",
          "Southeast Asia",
          "Southern Africa",
          "Southern Europe",
          "Sub-Saharan Africa",
          "The Amazon Basin",
          "The Andes",
          "The Arctic Region",
          "The Balkans",
          "The Caucasus",
          "The Horn of Africa",
          "The Levant",
          "The Middle East",
          "The Sahel",
          "West Africa",
          "Western Europe",
          "Worldwide"
        ],
        "title": "Region"
      },
      "RichSearchSchema": {
        "properties": {
          "instruction": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Instruction",
            "description": "The instruction to pass along to the embedding mode. USE WITH CAUTION.",
            "default": "Retrieve semantically similar text."
          },
          "question": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Question",
            "description": "The question you would like your search results to answer.",
            "default": "Why did Argus Filch confiscate the Marauder's Map?"
          },
          "expansions": {
            "items": {},
            "type": "array",
            "maxItems": 10,
            "minItems": 0,
            "title": "Expansions",
            "description": "Semantically and lexically similar expansions.",
            "default": []
          },
          "sql_filter": {
            "type": "string",
            "title": "Sql Filter",
            "description": "A SQL filter to narrow down your search results",
            "default": "SELECT loc FROM engine"
          },
          "algorithm": {
            "$ref": "#/components/schemas/Algorithms",
            "description": "The algorithm to use when scoring search results.",
            "default": "hybrid-3"
          },
          "min_similarity": {
            "type": "number",
            "maximum": 1,
            "minimum": 0,
            "title": "Min Similarity",
            "description": "The minimum similarity that a result must have.",
            "default": 0
          },
          "must_exclude": {
            "items": {},
            "type": "array",
            "maxItems": 100,
            "minItems": 0,
            "title": "Must Exclude",
            "description": "All of the following strings must be excluded from each result.",
            "default": []
          },
          "must_include": {
            "items": {},
            "type": "array",
            "maxItems": 100,
            "minItems": 0,
            "title": "Must Include",
            "description": "Any of the following strings must be included in each result.",
            "default": []
          },
          "brand_safety": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BrandSafety"
              },
              {
                "type": "null"
              }
            ],
            "description": "The brand safety level to apply. Options: 'Safe', 'Sensitive', or 'Unsafe'."
          },
          "language": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Language"
              },
              {
                "type": "null"
              }
            ],
            "description": "The language code. Allowed values: EN, FR, DE, ES, etc. Can be null."
          },
          "continent": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Continent"
              },
              {
                "type": "null"
              }
            ],
            "description": "The continent you would like your search results to be refined to."
          },
          "region": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Region"
              },
              {
                "type": "null"
              }
            ],
            "description": "The geographic region you would like your search results to be refined to."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CountryName"
              },
              {
                "type": "null"
              }
            ],
            "description": "The country you would like your search results to be refined to."
          },
          "sector": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sector"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS sector you would like your search results to be refined to."
          },
          "industry_group": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IndustryGroup"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS industry group you would like your search results to be refined to."
          },
          "industry": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Industry"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS industry you would like your search results to be refined to."
          },
          "sub_industry": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SubIndustry"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS sub-industry you would like your search results to be refined to."
          },
          "iab_tier_1": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier1"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 1 IAB category you would like your search results to be refined to."
          },
          "iab_tier_2": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier2"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 2 IAB category you would like your search results to be refined to."
          },
          "iab_tier_3": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier3"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 3 IAB category you would like your search results to be refined to."
          },
          "iab_tier_4": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier4"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 4 IAB category you would like your search results to be refined to."
          },
          "companies": {
            "items": {},
            "type": "array",
            "maxItems": 3,
            "minItems": 0,
            "title": "Companies",
            "description": "A list of company names. This will be used to refine the search results.",
            "default": []
          },
          "collection": {
            "type": "string",
            "enum": ["everything", "this-week"],
            "title": "Collection",
            "description": "Collection used to constrain retrieval."
          },
          "deduplicate": {
            "type": "boolean",
            "title": "Deduplicate",
            "description": "Whether to remove duplicate documents from the returned evidence set.",
            "default": false
          },
          "internal_use": {
            "type": "object",
            "title": "Internal Use",
            "description": "Internal-only. Used to enable hidden features and new algorithms from time to time."
          },
          "n_results": {
            "type": "integer",
            "maximum": 100,
            "minimum": 10,
            "title": "N Results",
            "description": "The number of search results you would like.",
            "default": 10
          },
          "n_probes": {
            "type": "integer",
            "maximum": 50,
            "minimum": 5,
            "title": "N Probes",
            "description": "The number of shards you would like your search.",
            "default": 30
          },
          "n_contextify": {
            "type": "integer",
            "maximum": 1024,
            "minimum": 64,
            "title": "N Contextify",
            "description": "The amount of context you would like per search result.",
            "default": 256
          },
          "enrich_profile": {
            "type": "boolean",
            "title": "Enrich Profile",
            "description": "Whether to enrich the search results with source website profiles.",
            "default": true
          },
          "enrich_targeting": {
            "type": "boolean",
            "title": "Enrich Targeting",
            "description": "Whether to enrich the search results with ad targeting information.",
            "default": true
          },
          "enrich_history": {
            "type": "boolean",
            "title": "Enrich History",
            "description": "Whether to enrich the search results with publishing track records.",
            "default": true
          },
          "enrich_signals": {
            "type": "boolean",
            "title": "Enrich Signals",
            "description": "Whether to enrich the search results with quantitative signals.",
            "default": true
          },
          "enrich_vectors": {
            "type": "boolean",
            "title": "Enrich Vectors",
            "description": "Whether to enrich the search results with vectors a.k.a. embeddings.",
            "default": true
          }
        },
        "type": "object",
        "title": "RichSearchSchema"
      },
      "SaveSearchSchema": {
        "properties": {
          "search_id": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 100,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Search Id",
            "description": "ID of the search. Use this if you want to update searches."
          },
          "extra_args": {
            "type": "object",
            "title": "Extra Args",
            "description": "Extra arguments to pass to the search."
          },
          "instruction": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Instruction",
            "description": "The instruction to pass along to the embedding mode. USE WITH CAUTION.",
            "default": "Retrieve semantically similar text."
          },
          "question": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Question",
            "description": "The question you would like your search results to answer.",
            "default": "Has Donald Trump announced any new tariffs?"
          },
          "expansions": {
            "items": {},
            "type": "array",
            "maxItems": 10,
            "minItems": 0,
            "title": "Expansions",
            "description": "Semantically and lexically similar expansions.",
            "default": []
          },
          "sql_filter": {
            "type": "string",
            "title": "Sql Filter",
            "description": "A SQL filter to narrow down your search results",
            "default": "SELECT loc FROM engine"
          },
          "algorithm": {
            "$ref": "#/components/schemas/FeedAlgorithms",
            "description": "The algorithm to use when scoring search results.",
            "default": "hybrid-3"
          },
          "n_results": {
            "type": "integer",
            "maximum": 100,
            "minimum": 10,
            "title": "N Results",
            "description": "The number of search results you would like.",
            "default": 100
          },
          "n_probes": {
            "type": "integer",
            "maximum": 1000,
            "minimum": 5,
            "title": "N Probes",
            "description": "The number of shards you would like your search.",
            "default": 500
          },
          "n_contextify": {
            "type": "integer",
            "maximum": 1024,
            "minimum": 64,
            "title": "N Contextify",
            "description": "The amount of context you would like per search result.",
            "default": 256
          },
          "min_similarity": {
            "type": "number",
            "maximum": 1,
            "minimum": 0,
            "title": "Min Similarity",
            "description": "The minimum similarity that a result must have.",
            "default": 0
          },
          "must_exclude": {
            "items": {},
            "type": "array",
            "maxItems": 100,
            "minItems": 0,
            "title": "Must Exclude",
            "description": "All of the following strings must be excluded from each result.",
            "default": []
          },
          "must_include": {
            "items": {},
            "type": "array",
            "maxItems": 100,
            "minItems": 0,
            "title": "Must Include",
            "description": "Any of the following strings must be included in each result.",
            "default": []
          },
          "brand_safety": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BrandSafety"
              },
              {
                "type": "null"
              }
            ],
            "description": "The brand safety level to apply. Options: 'Safe', 'Sensitive', or 'Unsafe'."
          },
          "language": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Language"
              },
              {
                "type": "null"
              }
            ],
            "description": "The language code. Allowed values: EN, FR, DE, ES, etc. Can be null."
          },
          "continent": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Continent"
              },
              {
                "type": "null"
              }
            ],
            "description": "The continent you would like your search results to be refined to."
          },
          "region": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Region"
              },
              {
                "type": "null"
              }
            ],
            "description": "The geographic region you would like your search results to be refined to."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CountryName"
              },
              {
                "type": "null"
              }
            ],
            "description": "The country you would like your search results to be refined to."
          },
          "sector": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sector"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS sector you would like your search results to be refined to."
          },
          "industry_group": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IndustryGroup"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS industry group you would like your search results to be refined to."
          },
          "industry": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Industry"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS industry you would like your search results to be refined to."
          },
          "sub_industry": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SubIndustry"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS sub-industry you would like your search results to be refined to."
          },
          "iab_tier_1": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier1"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 1 IAB category you would like your search results to be refined to."
          },
          "iab_tier_2": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier2"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 2 IAB category you would like your search results to be refined to."
          },
          "iab_tier_3": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier3"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 3 IAB category you would like your search results to be refined to."
          },
          "iab_tier_4": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier4"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 4 IAB category you would like your search results to be refined to."
          },
          "companies": {
            "items": {},
            "type": "array",
            "maxItems": 3,
            "minItems": 0,
            "title": "Companies",
            "description": "A list of company names. This will be used to refine the search results.",
            "default": []
          },
          "collection": {
            "type": "string",
            "enum": ["everything", "this-week"],
            "title": "Collection",
            "description": "The collection used by the saved search."
          },
          "deduplicate": {
            "type": "boolean",
            "title": "Deduplicate",
            "description": "Whether to deduplicate saved-search results by duplicate headline.",
            "default": false
          },
          "internal_use": {
            "type": "object",
            "title": "Internal Use",
            "description": "Internal-only. Hidden from API docs."
          }
        },
        "type": "object",
        "title": "SaveSearchSchema"
      },
      "SearchResponseEnvelope": {
        "type": "object",
        "description": "Standard Search response envelope returned by Agentic, Fast, Free, and Rich Search.",
        "required": ["message", "query", "response"],
        "properties": {
          "message": { "type": "string" },
          "query": { "type": "object", "additionalProperties": true },
          "response": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
        }
      },
      "BulkSearchResponse": {
        "type": "object",
        "required": ["message", "decrypt_using", "download_from"],
        "properties": {
          "message": { "type": "string", "example": "Slow search task accepted." },
          "decrypt_using": { "type": "string", "description": "Fernet key used to decrypt the downloaded result." },
          "download_from": { "type": "string", "format": "uri", "description": "Short-lived encrypted result URL." }
        }
      },
      "ScrapeResponse": {
        "type": "object",
        "required": ["message", "added_to_batch", "response"],
        "properties": {
          "message": { "type": "string" },
          "added_to_batch": { "type": "boolean" },
          "response": { "type": "object", "additionalProperties": true }
        }
      },
      "TopicTrendResponse": {
        "type": "object",
        "required": ["query", "response"],
        "properties": {
          "query": { "type": "object", "additionalProperties": true },
          "response": { "type": "object", "additionalProperties": { "type": "number" }, "description": "ISO-date keys mapped to trend scores." }
        }
      },
      "LimitsResponse": {
        "type": "object",
        "required": ["limits"],
        "properties": {
          "api_key_id": { "type": "string" },
          "subscription_id": { "type": "string" },
          "limits": { "type": "array", "items": { "type": "object", "additionalProperties": true } }
        }
      },
      "SearchSchema": {
        "properties": {
          "prompt": {
            "type": "string",
            "maxLength": 2500,
            "minLength": 25,
            "title": "Prompt",
            "description": "The information you are looking for.",
            "default": "Interesting news from AI startups last week."
          },
          "agent": {
            "$ref": "#/components/schemas/Agents",
            "description": "The search agent you want to use.",
            "default": "cybernaut-1"
          }
        },
        "type": "object",
        "title": "SearchSchema"
      },
      "Sector": {
        "type": "string",
        "enum": [
          "Other",
          "Communication Services",
          "Consumer Discretionary",
          "Consumer Staples",
          "Energy",
          "Financials",
          "Health Care",
          "Industrials",
          "Information Technology",
          "Materials",
          "Real Estate",
          "Utilities"
        ],
        "title": "Sector"
      },
      "TimeSearchSchema": {
        "allOf": [
          { "$ref": "#/components/schemas/SlowSearchSchema" }
        ],
        "type": "object",
        "required": ["start", "end"],
        "description": "Independent relevance searches bucketed by indexed publication time.",
        "properties": {
          "n_results": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000,
            "default": 25,
            "description": "Maximum relevant documents returned per interval search."
          },
          "n_probes": {
            "type": "integer",
            "minimum": 5,
            "maximum": 300,
            "default": 10,
            "description": "Number of shards evaluated per interval."
          },
          "n_contextify": {
            "type": "integer",
            "minimum": 128,
            "maximum": 1024,
            "default": 128,
            "description": "Context words returned per result."
          },
          "frequency": {
            "type": "string",
            "minLength": 2,
            "maxLength": 8,
            "default": "1d",
            "description": "Positive integer followed by h, d, w, or mo."
          },
          "start": {
            "type": "string",
            "format": "date-time",
            "description": "Inclusive timezone-aware start of the search range."
          },
          "end": {
            "type": "string",
            "format": "date-time",
            "description": "Exclusive timezone-aware end of the search range."
          },
          "sort": {
            "type": "string",
            "enum": ["ascending", "descending"],
            "default": "ascending",
            "description": "Chronological ordering of the interval searches."
          },
          "require_timezone": {
            "type": "boolean",
            "default": false,
            "description": "Only return documents with an indexed source publication timezone."
          }
        },
        "title": "TimeSearchSchema"
      },
      "SlowSearchSchema": {
        "properties": {
          "instruction": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Instruction",
            "description": "The instruction to pass along to the embedding mode. USE WITH CAUTION.",
            "default": "Retrieve semantically similar text."
          },
          "question": {
            "type": "string",
            "maxLength": 500,
            "minLength": 1,
            "title": "Question",
            "description": "The question you would like your search results to answer.",
            "default": "Why did Argus Filch confiscate the Marauder's Map?"
          },
          "expansions": {
            "items": {},
            "type": "array",
            "maxItems": 10,
            "minItems": 0,
            "title": "Expansions",
            "description": "Semantically and lexically similar expansions.",
            "default": []
          },
          "sql_filter": {
            "type": "string",
            "title": "Sql Filter",
            "description": "A SQL filter to narrow down your search results",
            "default": "SELECT loc FROM engine"
          },
          "algorithm": {
            "$ref": "#/components/schemas/Algorithms",
            "description": "The algorithm to use when scoring search results.",
            "default": "hybrid-3"
          },
          "min_similarity": {
            "type": "number",
            "maximum": 1,
            "minimum": 0,
            "title": "Min Similarity",
            "description": "The minimum similarity that a result must have.",
            "default": 0
          },
          "must_exclude": {
            "items": {},
            "type": "array",
            "maxItems": 100,
            "minItems": 0,
            "title": "Must Exclude",
            "description": "All of the following strings must be excluded from each result.",
            "default": []
          },
          "must_include": {
            "items": {},
            "type": "array",
            "maxItems": 100,
            "minItems": 0,
            "title": "Must Include",
            "description": "Any of the following strings must be included in each result.",
            "default": []
          },
          "brand_safety": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BrandSafety"
              },
              {
                "type": "null"
              }
            ],
            "description": "The brand safety level to apply. Options: 'Safe', 'Sensitive', or 'Unsafe'."
          },
          "language": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Language"
              },
              {
                "type": "null"
              }
            ],
            "description": "The language code. Allowed values: EN, FR, DE, ES, etc. Can be null."
          },
          "continent": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Continent"
              },
              {
                "type": "null"
              }
            ],
            "description": "The continent you would like your search results to be refined to."
          },
          "region": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Region"
              },
              {
                "type": "null"
              }
            ],
            "description": "The geographic region you would like your search results to be refined to."
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CountryName"
              },
              {
                "type": "null"
              }
            ],
            "description": "The country you would like your search results to be refined to."
          },
          "sector": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sector"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS sector you would like your search results to be refined to."
          },
          "industry_group": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IndustryGroup"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS industry group you would like your search results to be refined to."
          },
          "industry": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Industry"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS industry you would like your search results to be refined to."
          },
          "sub_industry": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SubIndustry"
              },
              {
                "type": "null"
              }
            ],
            "description": "The GICS sub-industry you would like your search results to be refined to."
          },
          "iab_tier_1": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier1"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 1 IAB category you would like your search results to be refined to."
          },
          "iab_tier_2": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier2"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 2 IAB category you would like your search results to be refined to."
          },
          "iab_tier_3": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier3"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 3 IAB category you would like your search results to be refined to."
          },
          "iab_tier_4": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IabTier4"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tier 4 IAB category you would like your search results to be refined to."
          },
          "companies": {
            "items": {},
            "type": "array",
            "maxItems": 3,
            "minItems": 0,
            "title": "Companies",
            "description": "A list of company names. This will be used to refine the search results.",
            "default": []
          },
          "collection": {
            "type": "string",
            "enum": ["everything", "this-week"],
            "title": "Collection",
            "description": "Collection used to constrain retrieval."
          },
          "deduplicate": {
            "type": "boolean",
            "title": "Deduplicate",
            "description": "Whether to remove duplicate documents from the returned evidence set.",
            "default": false
          },
          "internal_use": {
            "type": "object",
            "title": "Internal Use",
            "description": "Internal-only. Used to enable hidden features and new algorithms from time to time."
          },
          "n_results": {
            "type": "integer",
            "maximum": 10000,
            "minimum": 1000,
            "title": "N Results",
            "description": "The number of search results that you would like to be returned.",
            "default": 1000
          },
          "n_probes": {
            "type": "integer",
            "maximum": 300,
            "minimum": 5,
            "title": "N Probes",
            "description": "The number of shards you would like your search to be evaluated over.",
            "default": 10
          },
          "n_contextify": {
            "type": "integer",
            "maximum": 1024,
            "minimum": 128,
            "title": "N Contextify",
            "description": "The number of context words you would like back per search result.",
            "default": 128
          }
        },
        "type": "object",
        "title": "SlowSearchSchema"
      },
      "SubIndustry": {
        "type": "string",
        "enum": [
          "Other",
          "Advertising",
          "Aerospace & Defense",
          "Agricultural & Farm Machinery",
          "Agricultural Products & Services",
          "Air Freight & Logistics",
          "Airport Services",
          "Alternative Carriers",
          "Aluminum",
          "Apparel Retail",
          "Apparel, Accessories & Luxury Goods",
          "Application Software",
          "Asset Management & Custody Banks",
          "Automobile Manufacturers",
          "Automotive Parts & Equipment",
          "Automotive Retail",
          "Biotechnology",
          "Brewers",
          "Broadcasting",
          "Broadline Retail",
          "Building Products",
          "Cable & Satellite",
          "Cargo Ground Transportation",
          "Casinos & Gaming",
          "Coal & Consumable Fuels",
          "Commercial & Residential Mortgage Finance",
          "Commercial Printing",
          "Commodity Chemicals",
          "Communications Equipment",
          "Computer & Electronics Retail",
          "Construction & Engineering",
          "Construction Machinery & Heavy Transportation Equipment",
          "Construction Materials",
          "Consumer Electronics",
          "Consumer Finance",
          "Consumer Staples Merchandise Retail",
          "Copper",
          "Data Center REITs*",
          "Data Processing & Outsourced Services",
          "Distillers & Vintners",
          "Distributors",
          "Diversified Banks",
          "Diversified Capital Markets",
          "Diversified Chemicals",
          "Diversified Financial Services",
          "Diversified Metals & Mining",
          "Diversified REITs*",
          "Diversified Real Estate Activities",
          "Diversified Support Services",
          "Drug Retail",
          "Education Services",
          "Electric Utilities",
          "Electrical Components & Equipment",
          "Electronic Components",
          "Electronic Equipment & Instruments",
          "Electronic Manufacturing Services",
          "Environmental & Facilities Services",
          "Fertilizers & Agricultural Chemicals",
          "Financial Exchanges & Data",
          "Food Distributors",
          "Food Retail",
          "Footwear",
          "Forest Products",
          "Gas Utilities",
          "Gold",
          "Health Care Distributors",
          "Health Care Equipment",
          "Health Care Facilities",
          "Health Care REITs*",
          "Health Care Services",
          "Health Care Supplies",
          "Health Care Technology",
          "Heavy Electrical Equipment",
          "Highways & Railtracks",
          "Home Furnishings",
          "Home Improvement Retail",
          "Homebuilding",
          "Homefurnishing Retail",
          "Hotel & Resort REITs*",
          "Hotels, Resorts & Cruise Lines",
          "Household Appliances",
          "Household Products",
          "Housewares & Specialties",
          "Human Resource & Employment Services",
          "IT Consulting & Other Services",
          "Independent Power Producers & Energy Traders",
          "Industrial Conglomerates",
          "Industrial Gases",
          "Industrial Machinery & Supplies & Components",
          "Industrial REITs*",
          "Insurance Brokers",
          "Integrated Oil & Gas",
          "Integrated Telecommunication Services",
          "Interactive Home Entertainment",
          "Interactive Media & Services",
          "Internet Services & Infrastructure",
          "Investment Banking & Brokerage",
          "Leisure Facilities",
          "Leisure Products",
          "Life & Health Insurance",
          "Life Sciences Tools & Services",
          "Managed Health Care",
          "Marine Ports & Services",
          "Marine Transportation",
          "Metal, Glass & Plastic Containers",
          "Mortgage REITs*",
          "Motorcycle Manufacturers",
          "Movies & Entertainment",
          "Multi-Family Residential REITs*",
          "Multi-Sector Holdings",
          "Multi-Utilities",
          "Multi-line Insurance",
          "Office REITs*",
          "Office Services & Supplies",
          "Oil & Gas Drilling",
          "Oil & Gas Equipment & Services",
          "Oil & Gas Exploration & Production",
          "Oil & Gas Refining & Marketing",
          "Oil & Gas Storage & Transportation",
          "Other Specialized REITs*",
          "Other Specialty Retail",
          "Packaged Foods & Meats",
          "Paper & Plastic Packaging Products & Materials",
          "Paper Products",
          "Passenger Airlines",
          "Passenger Ground Transportation",
          "Personal Care Products",
          "Pharmaceuticals",
          "Precious Metals & Minerals",
          "Property & Casualty Insurance",
          "Publishing",
          "Rail Transportation",
          "Real Estate Development",
          "Real Estate Operating Companies",
          "Real Estate Services",
          "Regional Banks",
          "Reinsurance",
          "Renewable Electricity",
          "Research & Consulting Services",
          "Restaurants",
          "Retail REITs*",
          "Security & Alarm Services",
          "Self-Storage REITs*",
          "Semiconductor Materials & Equipment",
          "Semiconductors",
          "Silver",
          "Single-Family Residential REITs*",
          "Soft Drinks & Non-alcoholic Beverages",
          "Specialized Consumer Services",
          "Specialized Finance",
          "Specialty Chemicals",
          "Steel",
          "Systems Software",
          "Technology Distributors",
          "Technology Hardware, Storage & Peripherals",
          "Telecom Tower REITs*",
          "Textiles",
          "Timber REITs*",
          "Tires & Rubber",
          "Tobacco",
          "Trading Companies & Distributors",
          "Transaction & Payment Processing Services",
          "Water Utilities",
          "Wireless Telecommunication Services"
        ],
        "title": "SubIndustry"
      },
      "TrendSchema": {
        "properties": {
          "query": {
            "type": "string",
            "maxLength": 100,
            "minLength": 5,
            "title": "Query",
            "description": "The search term we would like to see a trend for.",
            "default": "Christmas Shopping"
          },
          "sql_filter": {
            "type": "string",
            "title": "Sql Filter",
            "description": "An optional SQL filter to apply to the trend query.",
            "default": "SELECT loc, published FROM engine"
          }
        },
        "type": "object",
        "title": "TrendSchema"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "type": "array",
            "title": "Location"
          },
          "msg": {
            "type": "string",
            "title": "Message"
          },
          "type": {
            "type": "string",
            "title": "Error Type"
          }
        },
        "type": "object",
        "required": ["loc", "msg", "type"],
        "title": "ValidationError"
      },
      "VisitSchema": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url",
            "description": "The URL this route will use for processing.",
            "default": "https://nosible.ghost.io/ensemble-and-distil/"
          },
          "html": {
            "type": "string",
            "title": "Html",
            "description": "The HTML associated with this URL. Optional.",
            "default": ""
          },
          "render": {
            "type": "boolean",
            "title": "Render",
            "description": "Force the crawler to render the JavaScript.",
            "default": false
          },
          "recrawl": {
            "type": "boolean",
            "title": "Recrawl",
            "description": "Whether to re-crawl the url again. Optional.",
            "default": false
          }
        },
        "type": "object",
        "title": "VisitSchema"
      }
    }
  },
  "tags": [
    {
      "name": "RATE LIMITS",
      "description": "Retrieve your rate limits from app.nosible.com."
    },
    {
      "name": "WEB SEARCH",
      "description": "Find relevant content published on the web."
    },
    {
      "name": "WEB AGENTS",
      "description": "Prompt your way to perfect search results."
    },
    {
      "name": "WEB SCRAPER",
      "description": "Turn messy HTML pages into beautiful JSON."
    },
    {
      "name": "WEB MENTIONS",
      "description": "Turn keyword queries into mention time-series."
    },
    {
      "name": "WEB ALERTS [BETA]",
      "description": "Monitor the web for exciting new content."
    }
  ]
}
