Genius API Documentation

Artist

artists

An artist is how Genius represents the creator of one or more songs (or other documents hosted on Genius). It's usually a musician or group of musicians.

/artists/{id}

Usage and SDK Samples

curl -X POST -H "apieco-key: [[apiKey]]" "https://api.apieco.ir/genius/artists/{id}?text_forma="

import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ArtistApi;

import java.io.File;
import java.util.*;

public class ArtistApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: apieco-key
        ApiKeyAuth apieco-key = (ApiKeyAuth) defaultClient.getAuthentication("apieco-key");
        apieco-key.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apieco-key.setApiKeyPrefix("Token");

        ArtistApi apiInstance = new ArtistApi();
        String apiecoKey = apiecoKey_example; // String | 
        String id = id_example; // String | Artist id
        String textForma = textForma_example; // String | Format for text bodies related to the document. One or more of dom, plain, and html, separated by commas (defaults to dom).
        try {
            inline_response_200 result = apiInstance.artists(apiecoKey, id, textForma);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ArtistApi#artists");
            e.printStackTrace();
        }
    }
}

import io.swagger.client.api.ArtistApi;

public class ArtistApiExample {

    public static void main(String[] args) {
        ArtistApi apiInstance = new ArtistApi();
        String apiecoKey = apiecoKey_example; // String | 
        String id = id_example; // String | Artist id
        String textForma = textForma_example; // String | Format for text bodies related to the document. One or more of dom, plain, and html, separated by commas (defaults to dom).
        try {
            inline_response_200 result = apiInstance.artists(apiecoKey, id, textForma);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ArtistApi#artists");
            e.printStackTrace();
        }
    }
}

Configuration *apiConfig = [Configuration sharedConfig];

// Configure API key authorization: (authentication scheme: apieco-key)
[apiConfig setApiKey:@"YOUR_API_KEY" forApiKeyIdentifier:@"apieco-key"];
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//[apiConfig setApiKeyPrefix:@"Bearer" forApiKeyIdentifier:@"apieco-key"];

String *apiecoKey = apiecoKey_example; // 
String *id = id_example; // Artist id
String *textForma = textForma_example; // Format for text bodies related to the document. One or more of dom, plain, and html, separated by commas (defaults to dom). (optional)

ArtistApi *apiInstance = [[ArtistApi alloc] init];

[apiInstance artistsWith:apiecoKey
    id:id
    textForma:textForma
              completionHandler: ^(inline_response_200 output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];

var GeniusApiDocumentation_ = require('genius_api_documentation_');
var defaultClient = GeniusApiDocumentation_.ApiClient.instance;

// Configure API key authorization: apieco-key
var apieco-key = defaultClient.authentications['apieco-key'];
apieco-key.apiKey = "YOUR API KEY"
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//apieco-key.apiKeyPrefix['apieco-key'] = "Token"

var api = new GeniusApiDocumentation_.ArtistApi()

var apiecoKey = apiecoKey_example; // {String} 

var id = id_example; // {String} Artist id

var opts = { 
  'textForma': textForma_example // {String} Format for text bodies related to the document. One or more of dom, plain, and html, separated by commas (defaults to dom).
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.artists(apiecoKey, id, opts, callback);

using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class artistsExample
    {
        public void main()
        {
            
            // Configure API key authorization: apieco-key
            Configuration.Default.ApiKey.Add("apieco-key", "YOUR_API_KEY");
            // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
            // Configuration.Default.ApiKeyPrefix.Add("apieco-key", "Bearer");

            var apiInstance = new ArtistApi();
            var apiecoKey = apiecoKey_example;  // String | 
            var id = id_example;  // String | Artist id
            var textForma = textForma_example;  // String | Format for text bodies related to the document. One or more of dom, plain, and html, separated by commas (defaults to dom). (optional) 

            try
            {
                inline_response_200 result = apiInstance.artists(apiecoKey, id, textForma);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ArtistApi.artists: " + e.Message );
            }
        }
    }
}

<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: apieco-key
Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('apieco-key', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// Swagger\Client\Configuration::getDefaultConfiguration()->setApiKeyPrefix('apieco-key', 'Bearer');

$api_instance = new Swagger\Client\Api\ArtistApi();
$apiecoKey = apiecoKey_example; // String | 
$id = id_example; // String | Artist id
$textForma = textForma_example; // String | Format for text bodies related to the document. One or more of dom, plain, and html, separated by commas (defaults to dom).

try {
    $result = $api_instance->artists($apiecoKey, $id, $textForma);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ArtistApi->artists: ', $e->getMessage(), PHP_EOL;
}
?>

use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ArtistApi;

# Configure API key authorization: apieco-key
$WWW::SwaggerClient::Configuration::api_key->{'apieco-key'} = 'YOUR_API_KEY';
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#$WWW::SwaggerClient::Configuration::api_key_prefix->{'apieco-key'} = "Bearer";

my $api_instance = WWW::SwaggerClient::ArtistApi->new();
my $apiecoKey = apiecoKey_example; # String | 
my $id = id_example; # String | Artist id
my $textForma = textForma_example; # String | Format for text bodies related to the document. One or more of dom, plain, and html, separated by commas (defaults to dom).

eval { 
    my $result = $api_instance->artists(apiecoKey => $apiecoKey, id => $id, textForma => $textForma);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling ArtistApi->artists: $@\n";
}

from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apieco-key
swagger_client.configuration.api_key['apieco-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# swagger_client.configuration.api_key_prefix['apieco-key'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.ArtistApi()
apiecoKey = apiecoKey_example # String | 
id = id_example # String | Artist id
textForma = textForma_example # String | Format for text bodies related to the document. One or more of dom, plain, and html, separated by commas (defaults to dom). (optional)

try: 
    api_response = api_instance.artists(apiecoKey, id, textForma=textForma)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ArtistApi->artists: %s\n" % e)

Parameters

Path parameters

Name	Description
id*	String Artist id Required

Header parameters

Name	Description
apieco-key*	String Required

Query parameters

Name	Description
text_forma	String Format for text bodies related to the document. One or more of dom, plain, and html, separated by commas (defaults to dom).

Responses

Status: 200 - Succesfull

Schema

Status: 401 - wrong code

Status: 403 - Invalid input

ArtistSongs

artistSongs

RDocuments (songs) for the artist specified. By default, 20 items are returned for each request.

/artists/{id}/songs

Usage and SDK Samples

curl -X POST -H "apieco-key: [[apiKey]]" "https://api.apieco.ir/genius/artists/{id}/songs?sort=&page=&per_page="

import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.ArtistSongsApi;

import java.io.File;
import java.util.*;

public class ArtistSongsApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: apieco-key
        ApiKeyAuth apieco-key = (ApiKeyAuth) defaultClient.getAuthentication("apieco-key");
        apieco-key.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apieco-key.setApiKeyPrefix("Token");

        ArtistSongsApi apiInstance = new ArtistSongsApi();
        String apiecoKey = apiecoKey_example; // String | 
        String id = id_example; // String | Artist id
        String sort = sort_example; // String | title (default) or popularity
        String page = page_example; // String | Paginated offset, (e.g., per_page=5&page=3 returns songs 11–15)
        String perPage = perPage_example; // String | Number of results to return per request
        try {
            inline_response_200 result = apiInstance.artistSongs(apiecoKey, id, sort, page, perPage);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ArtistSongsApi#artistSongs");
            e.printStackTrace();
        }
    }
}

import io.swagger.client.api.ArtistSongsApi;

public class ArtistSongsApiExample {

    public static void main(String[] args) {
        ArtistSongsApi apiInstance = new ArtistSongsApi();
        String apiecoKey = apiecoKey_example; // String | 
        String id = id_example; // String | Artist id
        String sort = sort_example; // String | title (default) or popularity
        String page = page_example; // String | Paginated offset, (e.g., per_page=5&page=3 returns songs 11–15)
        String perPage = perPage_example; // String | Number of results to return per request
        try {
            inline_response_200 result = apiInstance.artistSongs(apiecoKey, id, sort, page, perPage);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling ArtistSongsApi#artistSongs");
            e.printStackTrace();
        }
    }
}

Configuration *apiConfig = [Configuration sharedConfig];

// Configure API key authorization: (authentication scheme: apieco-key)
[apiConfig setApiKey:@"YOUR_API_KEY" forApiKeyIdentifier:@"apieco-key"];
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//[apiConfig setApiKeyPrefix:@"Bearer" forApiKeyIdentifier:@"apieco-key"];

String *apiecoKey = apiecoKey_example; // 
String *id = id_example; // Artist id
String *sort = sort_example; // title (default) or popularity (optional)
String *page = page_example; // Paginated offset, (e.g., per_page=5&page=3 returns songs 11–15) (optional)
String *perPage = perPage_example; // Number of results to return per request (optional)

ArtistSongsApi *apiInstance = [[ArtistSongsApi alloc] init];

[apiInstance artistSongsWith:apiecoKey
    id:id
    sort:sort
    page:page
    perPage:perPage
              completionHandler: ^(inline_response_200 output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];

var GeniusApiDocumentation_ = require('genius_api_documentation_');
var defaultClient = GeniusApiDocumentation_.ApiClient.instance;

// Configure API key authorization: apieco-key
var apieco-key = defaultClient.authentications['apieco-key'];
apieco-key.apiKey = "YOUR API KEY"
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//apieco-key.apiKeyPrefix['apieco-key'] = "Token"

var api = new GeniusApiDocumentation_.ArtistSongsApi()

var apiecoKey = apiecoKey_example; // {String} 

var id = id_example; // {String} Artist id

var opts = { 
  'sort': sort_example, // {String} title (default) or popularity
  'page': page_example, // {String} Paginated offset, (e.g., per_page=5&page=3 returns songs 11–15)
  'perPage': perPage_example // {String} Number of results to return per request
};

var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.artistSongs(apiecoKey, id, opts, callback);

using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class artistSongsExample
    {
        public void main()
        {
            
            // Configure API key authorization: apieco-key
            Configuration.Default.ApiKey.Add("apieco-key", "YOUR_API_KEY");
            // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
            // Configuration.Default.ApiKeyPrefix.Add("apieco-key", "Bearer");

            var apiInstance = new ArtistSongsApi();
            var apiecoKey = apiecoKey_example;  // String | 
            var id = id_example;  // String | Artist id
            var sort = sort_example;  // String | title (default) or popularity (optional) 
            var page = page_example;  // String | Paginated offset, (e.g., per_page=5&page=3 returns songs 11–15) (optional) 
            var perPage = perPage_example;  // String | Number of results to return per request (optional) 

            try
            {
                inline_response_200 result = apiInstance.artistSongs(apiecoKey, id, sort, page, perPage);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling ArtistSongsApi.artistSongs: " + e.Message );
            }
        }
    }
}

<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: apieco-key
Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('apieco-key', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// Swagger\Client\Configuration::getDefaultConfiguration()->setApiKeyPrefix('apieco-key', 'Bearer');

$api_instance = new Swagger\Client\Api\ArtistSongsApi();
$apiecoKey = apiecoKey_example; // String | 
$id = id_example; // String | Artist id
$sort = sort_example; // String | title (default) or popularity
$page = page_example; // String | Paginated offset, (e.g., per_page=5&page=3 returns songs 11–15)
$perPage = perPage_example; // String | Number of results to return per request

try {
    $result = $api_instance->artistSongs($apiecoKey, $id, $sort, $page, $perPage);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling ArtistSongsApi->artistSongs: ', $e->getMessage(), PHP_EOL;
}
?>

use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::ArtistSongsApi;

# Configure API key authorization: apieco-key
$WWW::SwaggerClient::Configuration::api_key->{'apieco-key'} = 'YOUR_API_KEY';
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#$WWW::SwaggerClient::Configuration::api_key_prefix->{'apieco-key'} = "Bearer";

my $api_instance = WWW::SwaggerClient::ArtistSongsApi->new();
my $apiecoKey = apiecoKey_example; # String | 
my $id = id_example; # String | Artist id
my $sort = sort_example; # String | title (default) or popularity
my $page = page_example; # String | Paginated offset, (e.g., per_page=5&page=3 returns songs 11–15)
my $perPage = perPage_example; # String | Number of results to return per request

eval { 
    my $result = $api_instance->artistSongs(apiecoKey => $apiecoKey, id => $id, sort => $sort, page => $page, perPage => $perPage);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling ArtistSongsApi->artistSongs: $@\n";
}

from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apieco-key
swagger_client.configuration.api_key['apieco-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# swagger_client.configuration.api_key_prefix['apieco-key'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.ArtistSongsApi()
apiecoKey = apiecoKey_example # String | 
id = id_example # String | Artist id
sort = sort_example # String | title (default) or popularity (optional)
page = page_example # String | Paginated offset, (e.g., per_page=5&page=3 returns songs 11–15) (optional)
perPage = perPage_example # String | Number of results to return per request (optional)

try: 
    api_response = api_instance.artist_songs(apiecoKey, id, sort=sort, page=page, perPage=perPage)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling ArtistSongsApi->artistSongs: %s\n" % e)

Parameters

Path parameters

Name	Description
id*	String Artist id Required

Header parameters

Name	Description
apieco-key*	String Required

Query parameters

Name	Description
sort	String title (default) or popularity
page	String Paginated offset, (e.g., per_page=5&page=3 returns songs 11–15)
per_page	String Number of results to return per request

Responses

Status: 200 - Succesfull

Schema

Status: 401 - wrong code

Status: 403 - Invalid input

Search

search

The search capability covers all content hosted on Genius (all songs).

/search

Usage and SDK Samples

curl -X POST -H "apieco-key: [[apiKey]]" "https://api.apieco.ir/genius/search?q="

import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SearchApi;

import java.io.File;
import java.util.*;

public class SearchApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: apieco-key
        ApiKeyAuth apieco-key = (ApiKeyAuth) defaultClient.getAuthentication("apieco-key");
        apieco-key.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apieco-key.setApiKeyPrefix("Token");

        SearchApi apiInstance = new SearchApi();
        String apiecoKey = apiecoKey_example; // String | 
        String q = q_example; // String | The term to search for
        try {
            inline_response_200_1 result = apiInstance.search(apiecoKey, q);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SearchApi#search");
            e.printStackTrace();
        }
    }
}

import io.swagger.client.api.SearchApi;

public class SearchApiExample {

    public static void main(String[] args) {
        SearchApi apiInstance = new SearchApi();
        String apiecoKey = apiecoKey_example; // String | 
        String q = q_example; // String | The term to search for
        try {
            inline_response_200_1 result = apiInstance.search(apiecoKey, q);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SearchApi#search");
            e.printStackTrace();
        }
    }
}

Configuration *apiConfig = [Configuration sharedConfig];

// Configure API key authorization: (authentication scheme: apieco-key)
[apiConfig setApiKey:@"YOUR_API_KEY" forApiKeyIdentifier:@"apieco-key"];
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//[apiConfig setApiKeyPrefix:@"Bearer" forApiKeyIdentifier:@"apieco-key"];

String *apiecoKey = apiecoKey_example; // 
String *q = q_example; // The term to search for

SearchApi *apiInstance = [[SearchApi alloc] init];

[apiInstance searchWith:apiecoKey
    q:q
              completionHandler: ^(inline_response_200_1 output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];

var GeniusApiDocumentation_ = require('genius_api_documentation_');
var defaultClient = GeniusApiDocumentation_.ApiClient.instance;

// Configure API key authorization: apieco-key
var apieco-key = defaultClient.authentications['apieco-key'];
apieco-key.apiKey = "YOUR API KEY"
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//apieco-key.apiKeyPrefix['apieco-key'] = "Token"

var api = new GeniusApiDocumentation_.SearchApi()

var apiecoKey = apiecoKey_example; // {String} 

var q = q_example; // {String} The term to search for


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.search(apiecoKey, q, callback);

using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class searchExample
    {
        public void main()
        {
            
            // Configure API key authorization: apieco-key
            Configuration.Default.ApiKey.Add("apieco-key", "YOUR_API_KEY");
            // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
            // Configuration.Default.ApiKeyPrefix.Add("apieco-key", "Bearer");

            var apiInstance = new SearchApi();
            var apiecoKey = apiecoKey_example;  // String | 
            var q = q_example;  // String | The term to search for

            try
            {
                inline_response_200_1 result = apiInstance.search(apiecoKey, q);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SearchApi.search: " + e.Message );
            }
        }
    }
}

<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: apieco-key
Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('apieco-key', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// Swagger\Client\Configuration::getDefaultConfiguration()->setApiKeyPrefix('apieco-key', 'Bearer');

$api_instance = new Swagger\Client\Api\SearchApi();
$apiecoKey = apiecoKey_example; // String | 
$q = q_example; // String | The term to search for

try {
    $result = $api_instance->search($apiecoKey, $q);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SearchApi->search: ', $e->getMessage(), PHP_EOL;
}
?>

use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SearchApi;

# Configure API key authorization: apieco-key
$WWW::SwaggerClient::Configuration::api_key->{'apieco-key'} = 'YOUR_API_KEY';
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#$WWW::SwaggerClient::Configuration::api_key_prefix->{'apieco-key'} = "Bearer";

my $api_instance = WWW::SwaggerClient::SearchApi->new();
my $apiecoKey = apiecoKey_example; # String | 
my $q = q_example; # String | The term to search for

eval { 
    my $result = $api_instance->search(apiecoKey => $apiecoKey, q => $q);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling SearchApi->search: $@\n";
}

from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apieco-key
swagger_client.configuration.api_key['apieco-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# swagger_client.configuration.api_key_prefix['apieco-key'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.SearchApi()
apiecoKey = apiecoKey_example # String | 
q = q_example # String | The term to search for

try: 
    api_response = api_instance.search(apiecoKey, q)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SearchApi->search: %s\n" % e)

Parameters

Header parameters

Name	Description
apieco-key*	String Required

Query parameters

Name	Description
q*	String The term to search for Required

Responses

Status: 200 - Succesfull

Schema

Status: 401 - wrong code

Status: 403 - Invalid input

Songs

songsBuId

A song is a document hosted on Genius. It's usually music lyrics. Data for a song includes details about the document itself and information about all the referents that are attached to it, including the text to which they refer.

/songs/{id}

Usage and SDK Samples

curl -X POST -H "apieco-key: [[apiKey]]" "https://api.apieco.ir/genius/songs/{id}"

import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.SongsApi;

import java.io.File;
import java.util.*;

public class SongsApiExample {

    public static void main(String[] args) {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        
        // Configure API key authorization: apieco-key
        ApiKeyAuth apieco-key = (ApiKeyAuth) defaultClient.getAuthentication("apieco-key");
        apieco-key.setApiKey("YOUR API KEY");
        // Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
        //apieco-key.setApiKeyPrefix("Token");

        SongsApi apiInstance = new SongsApi();
        String apiecoKey = apiecoKey_example; // String | 
        String id = id_example; // String | song id
        try {
            inline_response_200 result = apiInstance.songsBuId(apiecoKey, id);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SongsApi#songsBuId");
            e.printStackTrace();
        }
    }
}

import io.swagger.client.api.SongsApi;

public class SongsApiExample {

    public static void main(String[] args) {
        SongsApi apiInstance = new SongsApi();
        String apiecoKey = apiecoKey_example; // String | 
        String id = id_example; // String | song id
        try {
            inline_response_200 result = apiInstance.songsBuId(apiecoKey, id);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling SongsApi#songsBuId");
            e.printStackTrace();
        }
    }
}

Configuration *apiConfig = [Configuration sharedConfig];

// Configure API key authorization: (authentication scheme: apieco-key)
[apiConfig setApiKey:@"YOUR_API_KEY" forApiKeyIdentifier:@"apieco-key"];
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//[apiConfig setApiKeyPrefix:@"Bearer" forApiKeyIdentifier:@"apieco-key"];

String *apiecoKey = apiecoKey_example; // 
String *id = id_example; // song id

SongsApi *apiInstance = [[SongsApi alloc] init];

[apiInstance songsBuIdWith:apiecoKey
    id:id
              completionHandler: ^(inline_response_200 output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];

var GeniusApiDocumentation_ = require('genius_api_documentation_');
var defaultClient = GeniusApiDocumentation_.ApiClient.instance;

// Configure API key authorization: apieco-key
var apieco-key = defaultClient.authentications['apieco-key'];
apieco-key.apiKey = "YOUR API KEY"
// Uncomment the following line to set a prefix for the API key, e.g. "Token" (defaults to null)
//apieco-key.apiKeyPrefix['apieco-key'] = "Token"

var api = new GeniusApiDocumentation_.SongsApi()

var apiecoKey = apiecoKey_example; // {String} 

var id = id_example; // {String} song id


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.songsBuId(apiecoKey, id, callback);

using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class songsBuIdExample
    {
        public void main()
        {
            
            // Configure API key authorization: apieco-key
            Configuration.Default.ApiKey.Add("apieco-key", "YOUR_API_KEY");
            // Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
            // Configuration.Default.ApiKeyPrefix.Add("apieco-key", "Bearer");

            var apiInstance = new SongsApi();
            var apiecoKey = apiecoKey_example;  // String | 
            var id = id_example;  // String | song id

            try
            {
                inline_response_200 result = apiInstance.songsBuId(apiecoKey, id);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling SongsApi.songsBuId: " + e.Message );
            }
        }
    }
}

<?php
require_once(__DIR__ . '/vendor/autoload.php');

// Configure API key authorization: apieco-key
Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('apieco-key', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// Swagger\Client\Configuration::getDefaultConfiguration()->setApiKeyPrefix('apieco-key', 'Bearer');

$api_instance = new Swagger\Client\Api\SongsApi();
$apiecoKey = apiecoKey_example; // String | 
$id = id_example; // String | song id

try {
    $result = $api_instance->songsBuId($apiecoKey, $id);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling SongsApi->songsBuId: ', $e->getMessage(), PHP_EOL;
}
?>

use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::SongsApi;

# Configure API key authorization: apieco-key
$WWW::SwaggerClient::Configuration::api_key->{'apieco-key'} = 'YOUR_API_KEY';
# uncomment below to setup prefix (e.g. Bearer) for API key, if needed
#$WWW::SwaggerClient::Configuration::api_key_prefix->{'apieco-key'} = "Bearer";

my $api_instance = WWW::SwaggerClient::SongsApi->new();
my $apiecoKey = apiecoKey_example; # String | 
my $id = id_example; # String | song id

eval { 
    my $result = $api_instance->songsBuId(apiecoKey => $apiecoKey, id => $id);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling SongsApi->songsBuId: $@\n";
}

from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# Configure API key authorization: apieco-key
swagger_client.configuration.api_key['apieco-key'] = 'YOUR_API_KEY'
# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# swagger_client.configuration.api_key_prefix['apieco-key'] = 'Bearer'

# create an instance of the API class
api_instance = swagger_client.SongsApi()
apiecoKey = apiecoKey_example # String | 
id = id_example # String | song id

try: 
    api_response = api_instance.songs_bu_id(apiecoKey, id)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling SongsApi->songsBuId: %s\n" % e)

Parameters

Path parameters

Name	Description
id*	String song id Required

Header parameters

Name	Description
apieco-key*	String Required

Genius API Documentation

API and SDK Documentation

Artist

artists

Usage and SDK Samples

Parameters

Responses

Status: 200 - Succesfull

Status: 401 - wrong code

Status: 403 - Invalid input

ArtistSongs

artistSongs

Usage and SDK Samples

Parameters

Responses

Status: 200 - Succesfull

Status: 401 - wrong code

Status: 403 - Invalid input

Search

search

Usage and SDK Samples

Parameters

Responses

Status: 200 - Succesfull

Status: 401 - wrong code

Status: 403 - Invalid input

Songs

songsBuId

Usage and SDK Samples

Parameters

Responses

Status: 200 - Succesfull

Status: 401 - wrong code

Status: 403 - Invalid input