Skip to main content
POST
/
api
/
discogs
/
search
/discogs/search
curl --request POST \
  --url https://api.anysite.io/api/discogs/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "count": 2,
  "timeout": 300,
  "q": "nirvana",
  "type": "release",
  "title": "<string>",
  "release_title": "<string>",
  "credit": "<string>",
  "artist": "Nirvana",
  "anv": "<string>",
  "label": "DGC",
  "genre": "Rock",
  "style": "Grunge",
  "country": "US",
  "year": "1991",
  "format": "Vinyl",
  "catno": "<string>",
  "barcode": "<string>",
  "track": "<string>",
  "submitter": "<string>",
  "contributor": "<string>"
}
'
[
  {
    "id": 123,
    "@type": "@discogs_search_result",
    "type": "<string>",
    "title": "<string>",
    "year": "<string>",
    "country": "<string>",
    "format": [],
    "label": [],
    "genre": [],
    "style": [],
    "barcode": [],
    "catno": "<string>",
    "master_id": 123,
    "community": {
      "@type": "@discogs_search_result_community",
      "want_count": 0,
      "have_count": 0
    },
    "image": "<string>",
    "url": "<string>"
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
count
integer
required

Max result count

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
q
string | null

Search keyword

Example:

"nirvana"

type
enum<string> | null

Restrict the search to a single entity type

Available options:
release,
master,
artist,
label
Example:

"release"

title
string | null

Search by combined 'Artist - Title' title field

release_title
string | null

Search by release title

credit
string | null

Search by release credit

artist
string | null

Search by artist name

Example:

"Nirvana"

anv
string | null

Search by artist name variation

label
string | null

Search by label name

Example:

"DGC"

genre
string | null

Search by genre

Example:

"Rock"

style
string | null

Search by style

Example:

"Grunge"

country
string | null

Search by country

Example:

"US"

year
string | null

Search by year

Example:

"1991"

format
string | null

Search by format

Example:

"Vinyl"

catno
string | null

Search by catalog number

barcode
string | null

Search by barcode

track
string | null

Search by track title

submitter
string | null

Search by submitter username

contributor
string | null

Search by contributor username

Response

Successful Response

id
integer
required
@type
string
default:@discogs_search_result
type
string | null
title
string | null
year
string | null
country
string | null
format
string[]
label
string[]
genre
string[]
style
string[]
barcode
string[]
catno
string | null
master_id
integer | null
community
DiscogsSearchResultCommunity · object
image
string | null
url
string | null