Skip to content

Fetches and returns link preview metadata for a URL so the composer can show a card before the post is saved.

Makes an outbound HTTP request to the target URL, so it is slower than other endpoints and fails with an error payload when the URL yields no usable metadata.

Endpoint

  • Method: GET
  • Path: /feeds/oembed
  • Edition: Core
  • Controller: FeedsController@getOembed
  • Route source: fluent-community/app/Http/Routes/api.php:68
  • Controller source: fluent-community/app/Http/Controllers/FeedsController.php

Live sample

The request and response below were recorded against a running FluentCommunity install and then anonymised — member names, emails, avatars and post content are fictional, and long collections are trimmed to a few entries.

GET Get OEmbed

GET
/feeds/oembed

Fetches and returns link preview metadata for a URL so the composer can show a card before the post is saved.

Controller: FeedsController@getOembed
Route source: fluent-community/app/Http/Routes/api.php:68

Authorizations

ApplicationPasswords

WordPress Application Passwords — use Basic auth with username:application_password.

Type
API Key (header: Authorization)

Parameters

Query Parameters

url

URL read via $request->get() in getOembed().

Type
string

Responses

Successful response

application/json
JSON
{
  
"oembed": {
  
  
"author_name": "string",
  
  
"content_type": "string",
  
  
"html": "string",
  
  
"image": "string",
  
  
"provider": "string",
  
  
"title": "string",
  
  
"type": "string",
  
  
"url": "string"
  
}
}

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

FluentCommunity developer documentation