{ "operationId": "fetch-trending-feed", "method": "GET", "path": "/v2/farcaster/feed/trending/", "summary": "Trending feeds", "description": "Fetch trending casts or on the global feed or channels feeds. 7d time window available for channel feeds only.", "tags": [ "Feed" ], "parameters": [ { "name": "", "in": "", "required": false, "description": "" }, { "name": "limit", "in": "query", "required": false, "description": "Number of results to fetch", "schema": { "default": 10, "example": 10, "format": "int32", "maximum": 10, "minimum": 1, "type": "integer" } }, { "name": "cursor", "in": "query", "required": false, "description": "Pagination cursor", "schema": { "type": "string" } }, { "name": "viewer_fid", "in": "query", "required": false, "description": "Providing this will return a feed that respects this user's mutes and blocks and includes `viewer_context`.", "schema": { "minimum": 1, "type": "integer" } }, { "name": "time_window", "in": "query", "required": false, "description": "Time window for trending casts (7d window for channel feeds only)", "schema": { "default": "24h", "enum": [ "1h", "6h", "12h", "24h", "7d" ], "example": "24h", "type": "string" } }, { "name": "channel_id", "in": "query", "required": false, "description": "Channel ID to filter trending casts. Less active channels might have no casts in the time window selected. Provide either `channel_id` or `parent_url`, not both.", "schema": { "example": "neynar", "type": "string" } }, { "name": "parent_url", "in": "query", "required": false, "description": "Parent URL to filter trending casts. Less active channels might have no casts in the time window selected. Provide either `channel_id` or `parent_url`, not both.", "schema": { "example": "chain://eip155:1/erc721:0xd4498134211baad5846ce70ce04e7c4da78931cc", "type": "string" } }, { "name": "provider", "in": "query", "required": false, "description": "The provider of the trending casts feed.", "schema": { "default": "neynar", "enum": [ "neynar" ], "example": "neynar", "type": "string" } } ], "requestBody": null, "responses": { "200": { "description": "Success", "schema": { "$ref": "#/components/schemas/FeedResponse" }, "example": null }, "400": { "description": "Bad Request", "schema": { "oneOf": [ { "$ref": "#/components/schemas/ZodError" }, { "$ref": "#/components/schemas/ErrorRes" } ] }, "example": null }, "404": { "description": "Resource not found", "schema": { "$ref": "#/components/schemas/ErrorRes" }, "example": null }, "500": { "description": "Server Error", "schema": { "$ref": "#/components/schemas/ErrorRes" }, "example": null } } }