Bluesky Source Provider
The Bluesky Source feeds data from the Bluesky social platform supporting Author Feed, List Feed, Posts and Profile queries.
Settings
| Setting | Description | Default |
|---|---|---|
| Name | The name that will identify this source instance. | |
| Default Cache Time | The default duration in seconds before the cache is renewed, set to 0 to disable caching. This setting can be overriden in each query configuration. | 3600 |
| Setting | Description |
|---|---|
| Actor | The Bluesky actor AT Identifier from which to create the source. |
Author Feed Query
Fetches posts and reposts made by the authenticated profile and resolves to Feed Type.
| Setting | Description | Default | Dynamic |
|---|---|---|---|
| Limit | The maximum number of posts to fetch. | ✓ | |
| Cache | The duration in seconds before the cache is invalidated and the query re-executed. | 3600 |
List Feed Query
Fetches posts and reposts from profiles from a list and resolves to Feed Type.
| Setting | Description | Default | Dynamic |
|---|---|---|---|
| List | The list of profiles from which to create the source from. | ✓ | |
| Limit | The maximum number of posts to fetch. | ✓ | |
| Cache | The duration in seconds before the cache is invalidated and the query re-executed. | 3600 |
Posts Query
Fetches posts made by the authenticated profile matching a search criteria and resolves to Post Type.
| Setting | Description | Default | Dynamic |
|---|---|---|---|
| Query | Syntax, phrase, boolean, and faceting is unspecified, but Lucene query syntax is recommended. | ✓ | |
| Since | Filter results for posts after the indicated datetime (inclusive). Can be a datetime, or just an ISO date YYYY-MM-DD. | ✓ | |
| Until | Filter results for posts before the indicated datetime (not inclusive). Can be a datetime, or just an ISO date YYYY-MM-DD. | ✓ | |
| Mentions | Filter to posts which mention the given account. | ✓ | |
| Language | Filter to posts in the given language. Expected to be based on post language field, though Bluesky server may override language detection. | ✓ | |
| Domain | Filter to posts with URLs (facet links or embeds) linking to the given domain (hostname). Bluesky server may apply hostname normalization. | ✓ | |
| URL | Filter to posts with links (facet links or embeds) pointing to this URL. Bluesky server may apply URL normalization or fuzzy matching. | ✓ | |
| Tag | 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. | ✓ | |
| Limit | The maximum number of posts to fetch. | ✓ | |
| Sort | The order by wich to sort the posts, Top or Latest. | Top | |
| Cache | The duration in seconds before the cache is invalidated and the query re-executed. | 3600 |
Profile Query
Fetches the authenticated profile detailed data and resolves to Profile Type.
| Setting | Description | Default |
|---|---|---|
| Cache | The duration in seconds before the cache is invalidated and the query re-executed. | 3600 |
Feed Type
Defines the mapping options of a Bluesky Feed object.
| Field | Description | Type |
|---|---|---|
| Post | The feed post. | Post |
Post Type
Defines the mapping options of a Bluesky Post object.
| Field | Description | Type | Filters |
|---|---|---|---|
| CID | Unique identifier of the content. | String | |
| URI | Uniform Resource Identifier of the post. | String | |
| Author | Author of the post. | Profile | |
| Text | Text of the post. | String | Limit |
| Media Type | If present, the type of media in the post. | String | |
| Images | Images of the post. | Post Image | |
| Images Counts | The total amount of images of the post. | Int | |
| Videos | Videos of the post. | Post Video | |
| GIF | GIF of the post. | Post GIF | |
| Reply Count | Number of replies to the post. | Int | |
| Repost Count | Number of reposts of the post. | Int | |
| Like Count | Number of likes on the post. | Int | |
| Quote Count | Number of quotes of the post. | Int | |
| Indexed At | Timestamp when the post was indexed. | String | Date |
Post Video Type
Defines the mapping options of a Bluesky Post Video object.
| Field | Description | Type |
|---|---|---|
| CID | Content Identifier for the video. | String |
| Thumbnail URL | URL of the thumbnail image. | String |
| Playlist | URL of the video playlist, or a single video. | String |
| Height | Height of the video. | Int |
| Width | Width of the video. | Int |
Post Image Type
Defines the mapping options of a Bluesky Post Image object.
| Field | Description | Type | Filters |
|---|---|---|---|
| Thumbnail URL | URL of the thumbnail image. | String | |
| Fullsize URL | URL of the full-size image. | String | |
| Alt Text | Alternative text for the image. | String | Limit |
| Height | Height of the image. | Int | |
| Width | Width of the image. | Int |
Post GIF Type
Defines the mapping options of a Bluesky Post GIF object.
| Field | Description | Type | Filters |
|---|---|---|---|
| URI | URL of the GIF. | String | |
| Title | Title of the GIF. | String | Limit |
| Description | Description of the GIF. | String | Limit |
| Thumbnail URL | URL of the thumbnail image. | String |
Profile Type
Defines the mapping options of a Bluesky Profile object.
| Field | Description | Type | Filters |
|---|---|---|---|
| DID | Unique identifier. | String | |
| Handle | Unique alias used as username and url for the profile. | String | |
| Display name | Profile Display Name. | String | |
| Description | Profile description. | String | Limit |
| Avatar | Profile avatar URL. | String | |
| Banner | Profile banner URL. | String | |
| Created At | Profile date of creation. | String | Date |
| Followers Count | Total number of followers. | Int | |
| Follows Count | Total number of follows. | Int | |
| Posts Count | Total number of posts. | Int |