Skip to main content
Tools that accept a query or keywords parameter support a Lucene-style search syntax. This gives you precise control over what results are returned.

​
Quick Reference

​
Plain Keywords

Space-separated keywords are treated as OR queries — results matching any of the terms are returned.
This matches posts containing “artificial” OR “intelligence” (or both).

​
Quoted Phrases

Wrap terms in double quotes to match an exact phrase:
This only matches posts containing the exact phrase “machine learning” as a contiguous string. You can combine phrases with other terms:

​
Boolean Operators

Two boolean operators are supported: AND and OR. They are case-insensitive.
Both terms must be present in the result.

​
Grouping with Parentheses

Use parentheses to control operator precedence:
Without parentheses, operators are evaluated left to right. Use grouping to make your intent explicit, especially when mixing AND and OR.

​
Platform-Specific Search Scope

Different tools search different fields depending on the platform:

​
Examples by Platform

Find posts about AI from specific conversations:
Find posts mentioning a user:
Find fashion-related posts:
Find food content in a specific cuisine:
Find technical discussions:
Find product reviews:
Find trending content:
Find educational content:
For TikTok, also consider using getTiktokPostsByHashtags which searches the indexed hashtags column directly — this is faster and more precise than keyword search for hashtag-based discovery.

​
Syntax Rules

These rules are enforced by the server. Queries that violate them will be rejected.

​
Unsupported Syntax

The following are not supported and will be stripped or treated as spaces:
If you need to filter by date range, language, or author, use the dedicated tool parameters (e.g., startDate, endDate, language, username) instead of embedding them in the query string.