https://cookifed.dev/docs/api/v1/recommendations/ Recent content in Recommendations on Cookifed Hugo en-US https://cookifed.dev/docs/api/v1/recommendations/get-recommendations-trending-recipe/ Mon, 01 Jan 0001 00:00:00 +0000 https://cookifed.dev/docs/api/v1/recommendations/get-recommendations-trending-recipe/ <div class="expressive-code"> <figure class="frame not-content"> <figcaption class="header"> <span class="title"></span> </figcaption> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">GET /api/v1/recommendations/trending/recipe</span></span></code></pre></div> </figure> </div> <p>Returns the recipes which are currently trending, best first. Recipes rank by their recent likes, boosts and preparations. The response only holds public items, minus the ones from accounts the viewer blocked. Publicly accessible without authentication.</p> <h2 id="required-scopes">Required Scopes</h2> <p><em>None (public endpoint).</em></p> <h2 id="request-body">Request Body</h2> <p><em>None.</em></p> <h2 id="responses">Responses</h2> <h3 id="200">200</h3> <p>trending recipes</p> <p><strong>Schema:</strong> array[<code>recipe_output</code>]</p> <h4 id="recipe_output"><code>recipe_output</code></h4> <table> <thead> <tr> <th>Field</th> <th>Type</th> <th>Required</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>slug</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>name</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>description</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>description_html</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>locale</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>serving</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>serving_type</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>visibility</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>account</code></td> <td><code>account_output</code></td> <td>yes</td> <td></td> </tr> <tr> <td><code>likes_count</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>boosts_count</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>liked</code></td> <td>boolean</td> <td>yes</td> <td></td> </tr> <tr> <td><code>boosted</code></td> <td>boolean</td> <td>yes</td> <td></td> </tr> <tr> <td><code>collection_ids</code></td> <td>array[integer]</td> <td>yes</td> <td></td> </tr> <tr> <td><code>created_at</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>published_at</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>ingredients</code></td> <td>array[<code>ingredient_output</code>]</td> <td>yes</td> <td></td> </tr> <tr> <td><code>steps</code></td> <td>array[]</td> <td>yes</td> <td></td> </tr> </tbody> </table> https://cookifed.dev/docs/api/v1/recommendations/get-recommendations-trending-preparation/ Mon, 01 Jan 0001 00:00:00 +0000 https://cookifed.dev/docs/api/v1/recommendations/get-recommendations-trending-preparation/ <div class="expressive-code"> <figure class="frame not-content"> <figcaption class="header"> <span class="title"></span> </figcaption> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">GET /api/v1/recommendations/trending/preparation</span></span></code></pre></div> </figure> </div> <p>Returns the preparations which are currently trending, best first. Preparations rank by their likes and boosts, weighed by their age. The response only holds public items, minus the ones from accounts the viewer blocked. Publicly accessible without authentication.</p> <h2 id="required-scopes">Required Scopes</h2> <p><em>None (public endpoint).</em></p> <h2 id="request-body">Request Body</h2> <p><em>None.</em></p> <h2 id="responses">Responses</h2> <h3 id="200">200</h3> <p>trending preparations</p> <p><strong>Schema:</strong> array[<code>preparation_output</code>]</p> <h4 id="preparation_output"><code>preparation_output</code></h4> <table> <thead> <tr> <th>Field</th> <th>Type</th> <th>Required</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>name</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>description</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>description_html</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>locale</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>status</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>serving</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>prepared_at</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>recipe_id</code></td> <td>integer</td> <td>no</td> <td></td> </tr> <tr> <td><code>serving_type</code></td> <td>string</td> <td>no</td> <td></td> </tr> <tr> <td><code>likes_count</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>boosts_count</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>liked</code></td> <td>boolean</td> <td>yes</td> <td></td> </tr> <tr> <td><code>boosted</code></td> <td>boolean</td> <td>yes</td> <td></td> </tr> <tr> <td><code>collection_ids</code></td> <td>array[integer]</td> <td>yes</td> <td></td> </tr> <tr> <td><code>created_at</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>published_at</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>account</code></td> <td><code>account_output</code></td> <td>yes</td> <td></td> </tr> <tr> <td><code>ingredients</code></td> <td>array[<code>ingredient_output</code>]</td> <td>yes</td> <td></td> </tr> <tr> <td><code>steps</code></td> <td>array[]</td> <td>yes</td> <td></td> </tr> <tr> <td><code>media</code></td> <td>array[<code>medium_output</code>]</td> <td>yes</td> <td></td> </tr> </tbody> </table> https://cookifed.dev/docs/api/v1/recommendations/get-recommendations-trending-status/ Mon, 01 Jan 0001 00:00:00 +0000 https://cookifed.dev/docs/api/v1/recommendations/get-recommendations-trending-status/ <div class="expressive-code"> <figure class="frame not-content"> <figcaption class="header"> <span class="title"></span> </figcaption> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">GET /api/v1/recommendations/trending/status</span></span></code></pre></div> </figure> </div> <p>Returns the statuses which are currently trending, best first. Statuses rank by their likes and boosts, weighed by their age. The response only holds public items, minus the ones from accounts the viewer blocked. Publicly accessible without authentication.</p> <h2 id="required-scopes">Required Scopes</h2> <p><em>None (public endpoint).</em></p> <h2 id="request-body">Request Body</h2> <p><em>None.</em></p> <h2 id="responses">Responses</h2> <h3 id="200">200</h3> <p>trending statuses</p> <p><strong>Schema:</strong> array[<code>status_output</code>]</p> <h4 id="status_output"><code>status_output</code></h4> <table> <thead> <tr> <th>Field</th> <th>Type</th> <th>Required</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>content</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>content_html</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>locale</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>likes_count</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>boosts_count</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>liked</code></td> <td>boolean</td> <td>yes</td> <td></td> </tr> <tr> <td><code>boosted</code></td> <td>boolean</td> <td>yes</td> <td></td> </tr> <tr> <td><code>collection_ids</code></td> <td>array[integer]</td> <td>yes</td> <td></td> </tr> <tr> <td><code>created_at</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>published_at</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>account</code></td> <td><code>account_output</code></td> <td>yes</td> <td></td> </tr> <tr> <td><code>media</code></td> <td>array[<code>medium_output</code>]</td> <td>yes</td> <td></td> </tr> </tbody> </table> https://cookifed.dev/docs/api/v1/recommendations/get-recommendations-trending-account/ Mon, 01 Jan 0001 00:00:00 +0000 https://cookifed.dev/docs/api/v1/recommendations/get-recommendations-trending-account/ <div class="expressive-code"> <figure class="frame not-content"> <figcaption class="header"> <span class="title"></span> </figcaption> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">GET /api/v1/recommendations/trending/account</span></span></code></pre></div> </figure> </div> <p>Returns the local accounts which are currently trending, best first. Accounts rank by their recent followers, and by the trending recipes, preparations and statuses they authored. The response leaves out the accounts the viewer blocked. Publicly accessible without authentication.</p> <h2 id="required-scopes">Required Scopes</h2> <p><em>None (public endpoint).</em></p> <h2 id="request-body">Request Body</h2> <p><em>None.</em></p> <h2 id="responses">Responses</h2> <h3 id="200">200</h3> <p>trending accounts</p> <p><strong>Schema:</strong> array[<code>account_output</code>]</p> <h4 id="account_output"><code>account_output</code></h4> <table> <thead> <tr> <th>Field</th> <th>Type</th> <th>Required</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>id</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>username</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>name</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>summary</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>summary_html</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>instance</code></td> <td>string</td> <td>yes</td> <td></td> </tr> <tr> <td><code>avatar</code></td> <td>object</td> <td>yes</td> <td></td> </tr> <tr> <td><code>state</code></td> <td>string</td> <td>yes</td> <td>The account&rsquo;s current sync status. - <code>unknown</code>: We don&rsquo;t know anything about this account. It may not even exist. - <code>loading</code>: We have loaded this account&rsquo;s direct information, and are currently loading the statuses. - <code>loaded</code>: We have loaded the data from this account. Note that this doesn&rsquo;t mean we actually have 100% of the data. There could be new data we haven&rsquo;t loaded yet, or that wasn&rsquo;t delivered to us. Local and managed accounts always have a state of <code>loaded</code>.</td> </tr> <tr> <td><code>following_count</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>followers_count</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> <tr> <td><code>like_id</code></td> <td>integer</td> <td>yes</td> <td></td> </tr> </tbody> </table>