Go To Swagger API Docs

Embedez API Documentation

NOTE - large changes will happen to api

future changes will break the api, slight changes will have to be made

Base URL

All API endpoints should be prefixed with the following base URL: https://embedez.com/api/v1

Authentication

To access the Embedez API, include your API key in the Authorization header as a Bearer token. You can generate your API key in the Profile Settings section.

Authorization: Bearer YOUR_API_KEY

Endpoints

1. Search Providers

Search for providers using a given URL.

Example Request:

curl - X GET "https://embedez.com/api/v1/providers/search?searchUrl=https://ifunny.co/video/P8b9VRZ3B" \ 
	- H "Authorization: Bearer YOUR_API_KEY"

Response:

{
	"success": true,
	"data": {
		"key": "search_657bd45ecc6599174343e515"
	}
}

2. Provider Preview

Retrieve detailed information about a specific provider using the search key obtained from the / providers / search endpoint.

Example Request:

curl - X GET "https://embedez.com/api/v1/providers/preview?search_key=example_search_key" \
	- H "Authorization: Bearer YOUR_API_KEY"

Response:

{
	"success": true,
	"data": {
		"type": 'tiktok' | 'instagram' | 'twitter' | 'reddit' | 'saved' | 'ifunny',
		"id": string,
		"user": {
			"name": string,
			"displayName": string,
			"followers": string,
			"region": string,
			"friends": string,
			"pictures": {
				"url": string,
				"banner": string
			}
		},
		"content": {
			"id": string,
			"link": string,
			"text": string",
			"title": string,
			"description": string ,
			"embedUrl": string,
			"media": [
				{
					"type": 'video' | 'photo' | 'audio' | 'gif',
					"url": string,
					"height": number,
					"width": number,
					"thumbnail": string,
					"title": string,
					"duration": number
				}
			],
			"generatedMedia": [],
			"statistics": {
				"shares": number,
				"follows": number,
				"likes": number,
				"views": number,
				"comments": number
			}
		}
	}
}

Rate Limiting

The API has a rate limit of 1000 requests per day.

Error Handling

In case of an error, the API will respond with an appropriate HTTP status code and a JSON object containing the error details.

Example Error Response:

{
		"success": false,
		"message": "Error message plain text"
}

Additional Features

More features will be implemented at a later date, and breaking changes will be implemented. Join the discord for more info https://discord.gg/fTaGWmyfY7