Logo
GitHub Website

User Guide

  • Getting Started
  • Search API v2.1
    • Interactive Search
    • Asynchronous Search
    • Endpoint coverage
  • NOSIBLE World
    • Models
    • Endpoint coverage
  • Errors and transport
    • Exception hierarchy
      • NosibleAPIError
      • AuthenticationError
      • ValidationError
      • RateLimitError
      • ConflictError
      • GoneError
      • CursorExpiredError
      • AccessDeniedError
      • NotFoundError
      • BackendError
    • Retry behavior
  • Configuration
    • Client configuration
    • Authentication routing
    • Search defaults
    • Bulk and Time downloads
    • Retry policy
    • LLM configuration
  • Releasing
    • Release metadata
    • Local release checks
  • Examples & Demos
  • MCP Server
    • Usage

API Reference

  • Nosible
    • Nosible
      • Nosible.search()
      • Nosible.fast_searches()
      • Nosible.rich_search()
      • Nosible.bulk_search()
      • Nosible.time_search()
      • Nosible.scrape_url()
      • Nosible.topic_trend()
      • Nosible.save_search()
      • Nosible.get_searches()
      • Nosible.delete_search()
      • Nosible.get_limits()
      • Nosible.answer()
      • Nosible.fast_search()
      • Nosible.close()
      • Nosible.search_payload()
      • Nosible.generate_expansions()
      • Nosible.format_sql()
      • Nosible.validate_sql()
      • Nosible.downloaded_search()
      • Nosible.search_json()
  • Result
    • Result
      • Result.present_fields
      • Result.scrape_url()
      • Result.sentiment()
      • Result.similar()
      • Result.to_dict()
      • Result.from_dict()
  • ResultSet
    • ResultSet
      • ResultSet.message
      • ResultSet.query
      • ResultSet.index
      • ResultSet.find_in_search_results()
      • ResultSet.analyze()
      • ResultSet.write_csv()
      • ResultSet.to_pandas()
      • ResultSet.write_json()
      • ResultSet.to_dict()
      • ResultSet.write_ndjson()
      • ResultSet.write_parquet()
      • ResultSet.write_ipc()
      • ResultSet.write_duckdb()
      • ResultSet.to_polars()
      • ResultSet.to_dicts()
      • ResultSet.read_csv()
      • ResultSet.read_json()
      • ResultSet.from_pandas()
      • ResultSet.read_ndjson()
      • ResultSet.read_parquet()
      • ResultSet.read_ipc()
      • ResultSet.read_duckdb()
      • ResultSet.from_polars()
      • ResultSet.from_dict()
      • ResultSet.from_dicts()
      • ResultSet.close()
  • RichResult
    • RichResult
      • RichResult.page
      • RichResult.snippet
      • RichResult.tokens
      • RichResult.semantics
      • RichResult.profile
      • RichResult.targeting
      • RichResult.history
      • RichResult.signals
      • RichResult.vectors
      • RichResult.extra
      • RichResult.present_fields
      • RichResult.similarity
      • RichResult.from_dict()
      • RichResult.to_dict()
  • Search
    • Search
      • Search.write_json()
      • Search.to_dict()
      • Search.read_json()
      • Search.from_dict()
  • SearchSet
    • SearchSet
      • SearchSet.index
      • SearchSet.add()
      • SearchSet.remove()
      • SearchSet.write_json()
      • SearchSet.to_dicts()
      • SearchSet.read_json()
  • WebPageData
    • WebPageData
      • WebPageData.write_json()
      • WebPageData.to_dict()
      • WebPageData.read_json()
  • Snippet
    • Snippet
      • Snippet.unknown_fields
      • Snippet.present_fields
      • Snippet.from_dict()
      • Snippet.write_json()
      • Snippet.to_dict()
  • SnippetSet
    • SnippetSet
      • SnippetSet.index
      • SnippetSet.write_json()
      • SnippetSet.to_dict()
      • SnippetSet.from_dict()
  • WorldClient
    • WorldClient
      • WorldClient.events()
      • WorldClient.entity_events()
      • WorldClient.ticker_events()
      • WorldClient.ontology_events()
      • WorldClient.search()
      • WorldClient.aggregate()
      • WorldClient.resolve()
      • WorldClient.version()
      • WorldClient.dates()
      • WorldClient.entity_summary()
      • WorldClient.ticker()
      • WorldClient.search_schema()
      • WorldClient.autocomplete()
      • WorldClient.semantic_search()
      • WorldClient.day_search()
      • WorldClient.snapshot()
      • WorldClient.event()
      • WorldClient.similar_events()
      • WorldClient.event_aggregates()
      • WorldClient.coverage()
      • WorldClient.markdown_index()
      • WorldClient.markdown_today()
      • WorldClient.markdown_yesterday()
      • WorldClient.markdown_resolve()
      • WorldClient.markdown_entity()
      • WorldClient.markdown_ticker()
      • WorldClient.markdown_event()
      • WorldClient.markdown_bulk()
  • WorldEvent
    • WorldEvent
      • WorldEvent.event_id
      • WorldEvent.version
      • WorldEvent.has_tickers
      • WorldEvent.event
      • WorldEvent.coordinate
      • WorldEvent.signals
      • WorldEvent.coverage
      • WorldEvent.entities
      • WorldEvent.tickers
      • WorldEvent.ontology
      • WorldEvent.provenance
      • WorldEvent.timestamps
      • WorldEvent.similar
      • WorldEvent.oai_vector
      • WorldEvent.extra
      • WorldEvent.unknown_fields
      • WorldEvent.present_fields
      • WorldEvent.from_dict()
      • WorldEvent.to_dict()
  • WorldEventPage
    • WorldEventPage
      • WorldEventPage.from_dict()
      • WorldEventPage.to_dict()
NOSIBLE Python SDK
  • Search
  • Edit on GitHub

Search

class Search(question=None, expansions=None, sql_filter=None, n_results=None, n_probes=None, n_contextify=None, algorithm=None, min_similarity=None, must_include=None, must_exclude=None, autogenerate_expansions=False, publish_start=None, publish_end=None, visited_start=None, visited_end=None, certain=None, include_netlocs=None, exclude_netlocs=None, include_companies=None, exclude_companies=None, include_docs=None, exclude_docs=None, brand_safety=None, language=None, continent=None, region=None, country=None, sector=None, industry_group=None, industry=None, sub_industry=None, iab_tier_1=None, iab_tier_2=None, iab_tier_3=None, iab_tier_4=None, instruction=None, companies=None, collection=None, deduplicate=None, internal_use=None)

Bases: object

Parameters for a NOSIBLE Search request.

Attributes

question

expansions

sql_filter

n_results

n_probes

n_contextify

algorithm

min_similarity

must_include

must_exclude

autogenerate_expansions

publish_start

publish_end

visited_start

visited_end

certain

include_netlocs

exclude_netlocs

include_companies

exclude_companies

include_docs

exclude_docs

brand_safety

language

continent

region

country

sector

industry_group

industry

sub_industry

iab_tier_1

iab_tier_2

iab_tier_3

iab_tier_4

instruction

companies

collection

deduplicate

internal_use

Methods

from_dict(data)

Create a search from known dictionary fields.

read_json(path)

Read a search from a JSON file.

write_json(path)

Write the search to a JSON file.

to_dict()

Convert the search to a dictionary.

Parameters:
  • question (str | None)

  • expansions (List[str] | None)

  • sql_filter (str | None)

  • n_results (int | None)

  • n_probes (int | None)

  • n_contextify (int | None)

  • algorithm (str | None)

  • min_similarity (float | None)

  • must_include (List[str] | None)

  • must_exclude (List[str] | None)

  • autogenerate_expansions (bool)

  • publish_start (str | None)

  • publish_end (str | None)

  • visited_start (str | None)

  • visited_end (str | None)

  • certain (bool | None)

  • include_netlocs (List[str] | None)

  • exclude_netlocs (List[str] | None)

  • include_companies (List[str] | None)

  • exclude_companies (List[str] | None)

  • include_docs (List[str] | None)

  • exclude_docs (List[str] | None)

  • brand_safety (str | None)

  • language (str | None)

  • continent (str | None)

  • region (str | None)

  • country (str | None)

  • sector (str | None)

  • industry_group (str | None)

  • industry (str | None)

  • sub_industry (str | None)

  • iab_tier_1 (str | None)

  • iab_tier_2 (str | None)

  • iab_tier_3 (str | None)

  • iab_tier_4 (str | None)

  • instruction (str | None)

  • companies (List[str] | None)

  • collection (str | None)

  • deduplicate (bool | None)

  • internal_use (Dict[str, Any] | None)

write_json(path)

Write the search to a JSON file.

Parameters:
  • path (str) – Destination file path.

  • self (Search)

Returns:

None.

Return type:

None

to_dict()

Convert the search to a dictionary.

Returns:

Search parameters.

Parameters:

self (Search)

Return type:

Dict[str, Any]

classmethod read_json(path)

Read a search from a JSON file.

Parameters:

path (str) – Source file path.

Returns:

Parsed search.

Return type:

Search

classmethod from_dict(data)

Create a search from known dictionary fields.

Parameters:

data (Dict[str, Any]) – Search parameters.

Returns:

Parsed search.

Return type:

Search

Previous Next

© Copyright 2026, NOSIBLE.

Built with Sphinx using a theme provided by Read the Docs.