SearchLy API v1

asuarez · Media

Media No Auth Free & Open media

# Introduction The SearchLy API provides similarity searching based on song lyrics. # Operations The API allows for the `/similarity/by_song` operation, which allows clients to search the similarity for an existing song in the database. Also, the API has an additional `/similarity/by_content` endpoint which allows clients to search similarity given a free String input through a JSON request body. Additional `/song/search` operation is available for searching songs given a query String. # Endpo

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET API endpoint to search similarity using a song identifier

Endpoint for an end-user client to search similarity by song identifier. If you want to run the /similarity/by_song operation, you can do so via an HTTP GET command to the following URL: ``` https://searchly.asuarez.dev/api/v1/similarity/by_song ```

https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_song?song_id=1

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_song?song_id=1"

import requests
params = {
    "song_id": "1"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_song",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_song');
url.searchParams.set('song_id', '1');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_song")
	q := baseURL.Query()
	q.Set("song_id", "1")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_song")
uri.query = URI.encode_www_form({
  "song_id" => "1"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_song?" . http_build_query([
    "song_id" => "1"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET API endpoint to search songs from the database given a query

Endpoint for an end-user client to search songs from the database given a String query. If you want to run the /song/search operation, you can do so via an HTTP GET command to the following URL: ``` https://searchly.asuarez.dev/api/v1/song/search ```

https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/song/search?query=test

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/song/search?query=test"

import requests
params = {
    "query": "test"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/song/search",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/song/search');
url.searchParams.set('query', 'test');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/song/search")
	q := baseURL.Query()
	q.Set("query", "test")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/song/search")
uri.query = URI.encode_www_form({
  "query" => "test"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/song/search?" . http_build_query([
    "query" => "test"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

POST API endpoint to search similarity using content

Endpoint for an end-user client to search similarity by content. If you want to run the /similarity/by_content operation, you can do so via an HTTP POST command to the following URL: ``` https://searchly.asuarez.dev/api/v1/similarity/by_content ```

https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_content

Hover any highlighted part to learn what it does

curl -X POST "https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_content"

import requests
response = requests.post(
    "https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_content",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_content';

const response = await fetch(url, {
  method: 'POST',
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_content"
	req, _ := http.NewRequest("POST", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_content")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Post.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/asuarez.dev/searchly/1.0/similarity/by_content";
$opts = ["http" => [
    "method" => "POST",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with SearchLy API v1?

SearchLy API v1 is a Media API. Developers commonly use media APIs for:

storing and delivering images, video, and audio
building digital asset management and media libraries
transcoding and optimising media for the web
adding video streaming and playback to your app
automating content tagging and metadata extraction

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. SearchLy API v1 is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗