Skip to main content
GET
/
api
/
research
cURL
curl --request GET \
  --url https://api.recoupable.com/api/research
{
  "status": "success",
  "results": [
    {
      "name": "<string>",
      "id": 123,
      "image_url": "<string>",
      "imageUrl": "<string>",
      "match_strength": 123,
      "target": "<string>",
      "platform": "<string>",
      "spotify_id": "<string>",
      "artist_names": [
        "<string>"
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.recoupable.com/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
q
string
required

Search query. Can be a name (e.g. Drake, Flowers) or a streaming-platform URL (e.g. https://open.spotify.com/artist/...).

​
type
enum<string>
default:artists

Entity type to search.

Available options:
artists,
tracks,
albums,
playlists,
curators,
stations
​
limit
integer
default:10

Maximum number of results.

​
beta
enum<string>

When true, switches Chartmetric to its improved beta search engine — recommended for ambiguous queries. Results come back sorted by match_strength (higher is better) and include target/platform fields instead of the default-mode shape.

Available options:
true,
false
​
platforms
string

Comma-separated platforms to include in beta results (e.g. cm,spotify). Only valid with beta=true; ignored otherwise.

Example:

"cm,spotify"

​
offset
string

Pagination offset. Defaults to 0 when omitted.

Pattern: ^(0|[1-9][0-9]*)$

Response

Search results

​
status
enum<string>
Available options:
success,
error
Example:

"success"

​
results
object[]

Matching artists with IDs, names, and basic metadata.