Quickstart

The easiest way to start using factiva-news is by running a news extraction volume estimation using the Explain operation.

from factiva.news.snapshot import Snapshot
my_query = "publication_datetime >= '2020-01-01 00:00:00' AND LOWER(language_code) = 'en'"
my_snapshot = Snapshot(user_key='abcd1234abcd1234abcd1234abcd1234', query=my_query)
my_snapshot.process_explain()  # This operation can take several minutes to complete
print(my_snapshot.last_explain_job.document_volume)

After its execution, the object last_explain_job contains details about the job itself and the estimated volume.