This article is relevant only for our News, Blogs, Forums & Reviews APIs and not for our dark and cyber web data APIs
Webz.io’s open web API includes a powerful free text search feature that allows users to conduct Boolean queries on both the title and text of articles. This feature enables users to find articles matching specific keywords or phrases and apply complex Boolean logic (e.g., AND, OR, NOT) to refine search results. Combined with Webz.io’s extensive filtering capabilities, this feature helps users pinpoint highly relevant content with precision. Here’s how the free text search feature can be used effectively:
- Flexible Keyword-Based Searches: Users can search for articles containing specific keywords, phrases, or combinations of terms. For instance, a query like "climate change" AND "policy" allows users to focus on articles discussing climate change in a policy context, filtering out unrelated content.
- Boolean Logic for Precision: The ability to use Boolean operators such as AND, OR, and NOT adds precision to searches. For example, a query like "artificial intelligence" AND NOT "gaming" enables users to find articles on AI while excluding those focused on gaming. This improves the relevance of results and eliminates unwanted content.
- Filtering by Topic and Context: After performing a free text search, users can leverage additional filters to further refine results. For example, combining a keyword search with the site_type filter can help find articles on AI specifically in news sources or blogs, or by using site_country to restrict results to a particular region.
- Enhanced Topic Discovery and Trend Tracking: By using keywords related to a specific topic or trend, users can monitor mentions and discussions as they emerge and evolve. This allows researchers and businesses to identify popular topics, industry developments, and public sentiment surrounding key issues.
- Advanced Content Curation: Content platforms or news aggregators can use the free text feature to build highly tailored news feeds. For instance, using Boolean logic with phrases like "financial technology" OR fintech allows for comprehensive coverage of articles across different terminology for the same topic.
- Combining Keywords with Entity Detection: Users can search for articles mentioning specific entities (e.g., "Tesla" AND "electric vehicles") and apply entity filters to focus on mentions of key people, places, or organizations. This helps enrich analysis and provide a clear view of coverage surrounding specific entities within a topic.
- Precise Monitoring for Brand and Competitor Mentions: Brands can use the free text search to monitor mentions of their brand, products, or competitors, refining results with Boolean logic. For example, "BrandName" AND ("review" OR "launch") can capture reviews or launch coverage, while excluding unrelated mentions.
- Reducing Noise with Keyword Exclusions: The Boolean NOT operator helps filter out irrelevant content, such as excluding specific topics or contexts that aren’t relevant to the search. For example, "cybersecurity" AND NOT "hacking" can focus on articles about cybersecurity without stories specifically about hacking incidents.
- Customizable Sentiment and Popularity Insights: Users can combine free text searches with sentiment and performance_score filters. For instance, "cryptocurrency" AND sentiment:positive
AND performance_score:>2 would return popular, positive articles on cryptocurrency, helping identify top stories and positive public opinion.
Webz.io’s free text search, combined with Boolean logic and extensive filtering options, enables users to build highly targeted, nuanced searches. This feature is ideal for content discovery, trend analysis, competitive monitoring, and creating custom content feeds tailored to specific information needs.
Example Queries per Use Case
Use Case | Example Query |
---|---|
Sentiment Analysis Monitor negative news about Microsoft | title:Microsoft sentiment:negative language:english |
Trending News Find engaging news about Android and iPhone | title:(Android OR iPhone) social.facebook.likes:>10 language:english |
Samsung Product Launches News stories related to the Samsung new products, features, or updates. | (title:samsung AND sentiment:positive) AND title:("unveils" OR "introduces" OR "debuts" OR "launches" OR "releases" OR "announces" OR "showcases" OR "rolls out" OR "features" OR "innovation" OR "cutting-edge" OR "breakthrough" OR "next-generation" OR "revolutionary" OR "pre-order") language:english |
Tesla Adverse Media Mentions of Tesla in a negative context in English | sentiment:negative title:Tesla category:"Disaster and Accident" language:english |
Product Launch Announcements Tracking news about new product launches from competitors or major brands in your industry. | category:"Economy, Business and Finance" title:("product launch" OR launch OR unveiling OR debut OR introduction OR reveal OR announcement OR features OR specifications OR availability OR "pre-order" OR "release date" OR innovative OR upgrade OR "limited edition" OR partnership OR collaboration OR showcase OR "market entry" OR campaign OR "consumer response") sentiment:positive |
Brand Partnerships and Collaborations Monitoring news regarding partnerships, collaborations, or sponsorships involving key brands. | category:"Economy, Business and Finance" title:("brand partnership" OR partnership OR collaboration OR alliance OR "joint venture" OR agreement OR "co-branding" OR sponsorship OR "strategic partnership" OR "team up" OR "launch together" OR merger OR innovation OR exclusive OR initiative OR campaign OR network OR synergy OR conjunction OR cooperation OR endorsement) sentiment:positive |
Regulatory Changes Tracking new laws and guidelines that impact a brand's compliance, operations, and reputation. | (category:"Social Issue" OR category:Labor OR category:"Human Interest" ) title:("regulation" OR "legislation" OR "compliance" OR "law" OR "policy change" OR "enforcement" OR "reform" OR "amendment" OR "government mandate" OR "legal update" OR "statutory requirements" OR "new rules" OR "compliance deadline" OR "penalties" OR "fines" OR "violation" OR "government oversight" OR "regulatory authority" OR "regulatory body" OR "effective date") |
Corporate Social Responsibility (CSR) Track stories covering the brand’s CSR activities or sustainability efforts to enhance its public image. | category:"Economy, Business and Finance" title:("Sustainability" OR "Ethical Practices" OR "Environmental Impact" OR "Green Initiatives" OR "Community Engagement" OR "Social Responsibility" OR "Philanthropy" OR "Carbon Footprint" OR "Diversity and Inclusion" OR "Eco-friendly" OR "Corporate Giving" OR "Renewable Energy" OR "Responsible Sourcing" OR "Employee Well-being" OR "Climate Action" OR "Human Rights" OR "Volunteer Programs" OR "Corporate Accountability" OR "Sustainable Development" OR "Impact Investing") |
Commodity News - Gold The latest news and blogs for the gold commodity market | site_type:(news OR blogs) is_first:true gold$ AND metal AND (trade$ OR volatility$ OR fund$ OR funds$) AND (market$ OR asset$ OR futures OR exchange) AND (forecast OR commodity OR "gold$ price$") AND (traders$ OR trading$ OR equity OR etf OR etfs OR portfolio) title:gold |
Recent IPOs News about initial public offerings (IPOs) | site_type:(news OR blogs) is_first:true thread.title:ipo |
Company Stock Ticker News Monitor mentions of the Apple stock symbol in news & blogs | site_type:(news OR blogs) is_first:true aapl AND title:(apple OR aapl) |
M&A Activity Merger & acquisition events within the Healthcare industry | site_type:news topic:"mergers and acquisitions" |
Third Party Risk News regarding financial, criminal, compliance, cyber, reputational, and operational risks for third-parties | site_type:(news OR blogs) is_first:true ("the company" OR "the firm" OR "the organization") AND ("filed for bankruptcy" OR "close their doors" OR "furlough" OR "leveraged buyout" OR "administrative$ leave$" OR "be bankrupt by" OR "could be bankrupt" OR "capacity cuts" OR "cash flow problems" OR "Chapter 11" OR "close doors" OR "closed indefinitely" OR "closes all stores" OR "closing store" OR "cutting pay" OR "distribution challenges" OR "fights for survival" OR "halt deliveries" OR "hemorrhaging cash" OR "layoff" OR "lay-offs" OR "lay offs" OR "pay cut" OR "plans to close" OR "salary cuts" OR "sales slowdown" OR "sales slowing" OR "scale back" OR "scale down" OR "seek bailout" OR "shuts$ down$" OR turmoil OR "debt" OR "offload" OR "weak position" OR "suspended buybacks" OR "suspend operations" OR "suspend production" OR "financially distressed" OR "restructuring" OR "reorganization" OR "trustee" OR "insider trade" OR seizures OR fired$ OR lawsuit OR sued$ OR breach OR "civil rights" OR "labor rights" OR scandal OR "write-down" OR "court fight" OR allegation OR downgraded OR delisted$ OR restructure OR "cash squeeze" OR penalties OR investigation OR fined OR failure OR resign OR sacked OR "profit miss" OR "missed profit" OR "profit warning" OR subpoena OR fraud OR "class action" OR "legal challenge" OR crisis OR insolvent) |
Emerging Risk News indicating emerging threats in Nigeria | site_type:(news OR blogs) is_first:true (disaster OR accident OR security OR "social problems" OR conflict OR exploded OR explosion OR attacked OR fire OR killed OR kidnapped OR behead OR injured OR ransom) AND nigeria AND (kidnapper OR gunmen OR bandits OR criminals OR terrorist OR terror OR police OR "law enforcement" OR "unsafe" OR authorities$) AND (killed OR abducted OR injured) |
Know Your Customer (KYC & AML) News about individuals accused of financial criminal activity | site_type:(news OR blogs) is_first:true (embezzling OR "tax evasion" OR misappropriated "money laundering" OR "wire fraud" OR "accept bribe") AND (accused OR convicted OR "on trial" OR "sentenced" OR guilty OR pleads OR investigate OR charged OR arrested OR hearing OR court OR allegation) AND (he OR she OR his OR her OR man OR woman) |
Android & iOS discussions about problems in Android and iOS. | site_type:discussions language:english thread.title:((android OR ios) AND (problem OR bug OR fail)) |
Climate Change discussions about climate change. | site_type:discussions language:english thread.title:"climate change" |
Mental Health Posts discussing the issue of mental health. | site_type:discussions ((anxiety OR anxious OR "panic attack") AND ("mental health" OR disorders OR "mental illness" OR Trauma OR stress OR Illness OR Drugs OR alcohol OR "Financial concerns" OR "Medications")) |