Vinyl Value Scout
Vinyl Value Scout · GPT アクション
Discogs API
GET /database/searchSearch the Discogs databaseGET /marketplace/price_suggestions/{release_id}Get price suggestions for a given release
元の API スキーマ
{
"openapi": "3.0.0",
"info": {
"title": "Discogs API",
"version": "1.0.0"
},
"servers": [
{
"url": "https://api.discogs.com"
}
],
"paths": {
"/database/search": {
"get": {
"summary": "Search the Discogs database",
"operationId": "searchDatabase",
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "The token for authentication"
},
{
"name": "query",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Your search query"
},
{
"name": "type",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "One of release, master, artist, label"
},
{
"name": "title",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Search by combined “Artist Name - Release Title” title field"
},
{
"name": "release_title",
"in": "query",
"required": false,
"schema": {
"type": "string"
},
"description": "Search release titles"
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/SearchResponse"
}
}
}
}
}
}
},
"/marketplace/price_suggestions/{release_id}": {
"get": {
"summary": "Get price suggestions for a given release",
"operationId": "getPriceSuggestions",
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "The token for authentication"
},
{
"in": "path",
"name": "release_id",
"required": true,
"schema": {
"type": "string"
},
"description": "The unique identifier of the release"
}
],
"responses": {
"200": {
"description": "Successful response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/PriceSuggestionsResponse"
}
}
}
}
}
}
}
},
"components": {
"schemas": {
"SearchResponse": {
"type": "object",
"properties": {
"pagination": {
"type": "object",
"properties": {
"per_page": {
"type": "integer"
},
"pages": {
"type": "integer"
},
"page": {
"type": "integer"
},
"urls": {
"type": "object",
"properties": {
"last": {
"type": "string"
},
"next": {
"type": "string"
}
}
},
"items": {
"type": "integer"
}
}
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"style": {
"type": "array",
"items": {
"type": "string"
}
},
"thumb": {
"type": "string"
},
"title": {
"type": "string"
},
"country": {
"type": "string"
},
"format": {
"type": "array",
"items": {
"type": "string"
}
},
"uri": {
"type": "string"
},
"community": {
"type": "object",
"properties": {
"want": {
"type": "integer"
},
"have": {
"type": "integer"
}
}
},
"label": {
"type": "array",
"items": {
"type": "string"
}
},
"catno": {
"type": "string"
},
"year": {
"type": "string"
},
"genre": {
"type": "array",
"items": {
"type": "string"
}
},
"resource_url": {
"type": "string"
},
"type": {
"type": "string"
},
"id": {
"type": "integer"
}
}
}
}
}
},
"PriceSuggestionsResponse": {
"type": "object",
"properties": {
"Very Good (VG)": {
"$ref": "#/components/schemas/PriceInfo"
},
"Good Plus (G+)": {
"$ref": "#/components/schemas/PriceInfo"
},
"Near Mint (NM or M-)": {
"$ref": "#/components/schemas/PriceInfo"
},
"Good (G)": {
"$ref": "#/components/schemas/PriceInfo"
},
"Very Good Plus (VG+)": {
"$ref": "#/components/schemas/PriceInfo"
},
"Mint (M)": {
"$ref": "#/components/schemas/PriceInfo"
},
"Fair (F)": {
"$ref": "#/components/schemas/PriceInfo"
},
"Poor (P)": {
"$ref": "#/components/schemas/PriceInfo"
}
}
},
"PriceInfo": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"example": "USD"
},
"value": {
"type": "number",
"format": "float",
"example": 6.7827501
}
}
}
}
}
}