#main
- queryBackend Posts search, returns only skeleton
Query Parameters
Name | Type | Details |
---|---|---|
author |
string |
Filter to posts by the given account. Handles are resolved to DID before query-time. Syntax Format: |
cursor |
string |
Optional pagination mechanism; may not necessarily allow scrolling through entire result set. |
domain |
string |
Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Server may apply hostname normalization. |
lang |
string |
Filter to posts in the given language. Expected to be based on post language field, though server may override language detection. Syntax Format: |
limit |
integer |
Default: Minimum: Maxumum: |
mentions |
string |
Filter to posts which mention the given account. Handles are resolved to DID before query-time. Only matches rich-text facet mentions. Syntax Format: |
q |
string (required) |
Search query string; syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended. |
since |
string |
Filter results for posts after the indicated datetime (inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYYY-MM-DD). |
sort |
string |
Specifies the ranking order of results. Default: Known Values: |
tag |
array |
Filter to posts with the given tag (hashtag), based on rich-text facet or tag field. Do not include the hash (#) prefix. Multiple tags can be specified, with 'AND' matching. UNHANDLED IN ARRAYS: string |
until |
string |
Filter results for posts before the indicated datetime (not inclusive). Expected to use 'sortAt' timestamp, which may not match 'createdAt'. Can be a datetime, or just an ISO date (YYY-MM-DD). |
url |
string |
Filter to posts with links (facet links or embeds) pointing to this URL. Server may apply URL normalization or fuzzy matching. Syntax Format: |
viewer |
string |
DID of the account making the request (not included for public/unauthenticated queries). Used for 'from:me' queries. Syntax Format: |
Response Body
Content Type: application/json
Data Fields
Name | Type | Details |
---|---|---|
cursor |
string | |
hitsTotal |
integer |
Count of search hits. Optional, may be rounded/truncated, and may not be possible to paginate through all hits. |
posts |
array (required) |
Elements are of type: |
Errors
Name | Description |
---|---|
BadQueryString |