GeniuslinkAPI

<back to all web services

IsbnMetadataLookupRequest

Requires Authentication
The following routes are available for this service:
GET/v3.5/product-metadata/lookup/isbn

// @DataContract
export class ProductIdentifiers
{
    // @DataMember(Name="productGuid", EmitDefaultValue=false)
    public productGuid: string;

    // @DataMember(Name="gtins", EmitDefaultValue=false)
    public gtins: string[];

    // @DataMember(Name="mpns", EmitDefaultValue=false)
    public mpns: string[];

    // @DataMember(Name="ean8", EmitDefaultValue=false)
    public ean8: string[];

    // @DataMember(Name="ean13", EmitDefaultValue=false)
    public ean13: string[];

    // @DataMember(Name="isbn9", EmitDefaultValue=false)
    public isbn9: string[];

    // @DataMember(Name="isbn10", EmitDefaultValue=false)
    public isbn10: string[];

    // @DataMember(Name="isbn13", EmitDefaultValue=false)
    public isbn13: string[];

    // @DataMember(Name="itf14", EmitDefaultValue=false)
    public itf14: string[];

    // @DataMember(Name="upc12", EmitDefaultValue=false)
    public upc12: string[];

    public constructor(init?: Partial<ProductIdentifiers>) { (Object as any).assign(this, init); }
}

// @DataContract
export class BookAttributes
{
    // @DataMember(Name="authors", EmitDefaultValue=false)
    public authors: string[];

    public constructor(init?: Partial<BookAttributes>) { (Object as any).assign(this, init); }
}

// @DataContract
export class AudiobookAttributes extends BookAttributes
{

    public constructor(init?: Partial<AudiobookAttributes>) { super(init); (Object as any).assign(this, init); }
}

// @DataContract
export class EBookAttributes extends BookAttributes
{

    public constructor(init?: Partial<EBookAttributes>) { super(init); (Object as any).assign(this, init); }
}

// @DataContract
export class ItemAttributes
{
    // @DataMember(Name="book", EmitDefaultValue=false)
    public book: BookAttributes;

    // @DataMember(Name="audiobook", EmitDefaultValue=false)
    public audiobook: AudiobookAttributes;

    // @DataMember(Name="ebook", EmitDefaultValue=false)
    public ebook: EBookAttributes;

    public constructor(init?: Partial<ItemAttributes>) { (Object as any).assign(this, init); }
}

// @DataContract
export class ProductAttributes
{
    // @DataMember(Name="retailer", EmitDefaultValue=false)
    public retailer: string;

    // @DataMember(Name="retailerGuid", EmitDefaultValue=false)
    public retailerGuid: string;

    // @DataMember(Name="storefront", EmitDefaultValue=false)
    public storefront: string;

    // @DataMember(Name="storefrontIso2", EmitDefaultValue=false)
    public storefrontIso2: string;

    // @DataMember(Name="storefrontGuid", EmitDefaultValue=false)
    public storefrontGuid: string;

    // @DataMember(Name="category", EmitDefaultValue=false)
    public category: string;

    // @DataMember(Name="categoryGuid", EmitDefaultValue=false)
    public categoryGuid: string;

    // @DataMember(Name="brand", EmitDefaultValue=false)
    public brand: string;

    // @DataMember(Name="brandGuid", EmitDefaultValue=false)
    public brandGuid: string;

    // @DataMember(Name="manufacturer", EmitDefaultValue=false)
    public manufacturer: string;

    // @DataMember(Name="manufacturerGuid", EmitDefaultValue=false)
    public manufacturerGuid: string;

    // @DataMember(Name="identifiers", EmitDefaultValue=false)
    public identifiers: ProductIdentifiers;

    // @DataMember(Name="itemAttributes", EmitDefaultValue=false)
    public itemAttributes: ItemAttributes;

    public constructor(init?: Partial<ProductAttributes>) { (Object as any).assign(this, init); }
}

// @DataContract
export class RetailerSpecificAttributes
{
    // @DataMember(Name="name", EmitDefaultValue=false)
    public name: string;

    // @DataMember(Name="description", EmitDefaultValue=false)
    public description: string;

    // @DataMember(Name="skus", EmitDefaultValue=false)
    public skus: string[];

    // @DataMember(Name="asin", EmitDefaultValue=false)
    public asin: string;

    // @DataMember(Name="url", EmitDefaultValue=false)
    public url: string;

    // @DataMember(Name="productImages", EmitDefaultValue=false)
    public productImages: { [index:string]: string; };

    // @DataMember(Name="additionalData", EmitDefaultValue=false)
    public additionalData: { [index:string]: string; };

    public constructor(init?: Partial<RetailerSpecificAttributes>) { (Object as any).assign(this, init); }
}

// @DataContract
export class ProductData
{
    // @DataMember(Name="attributes", EmitDefaultValue=false)
    public attributes: ProductAttributes;

    // @DataMember(Name="retailerSpecificAttributes", EmitDefaultValue=false)
    public retailerSpecificAttributes: RetailerSpecificAttributes;

    // @DataMember(Name="rawSourceData", EmitDefaultValue=false)
    public rawSourceData: string;

    public constructor(init?: Partial<ProductData>) { (Object as any).assign(this, init); }
}

export class ProductMetadataLookupResponse implements IProductMetadataLookupResponse
{
    // @DataMember(Name="productMetadata")
    public productMetadata: ProductData;

    // @DataMember(Name="responseStatus")
    public responseStatus: ResponseStatus;

    public constructor(init?: Partial<ProductMetadataLookupResponse>) { (Object as any).assign(this, init); }
}

export class IsbnMetadataLookupRequest implements IIsbnMetadataLookupRequest
{
    public isbn: string;

    public constructor(init?: Partial<IsbnMetadataLookupRequest>) { (Object as any).assign(this, init); }
}

TypeScript IsbnMetadataLookupRequest DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /v3.5/product-metadata/lookup/isbn HTTP/1.1 
Host: geniuslink-api-zane.dev.platform.georiot.com 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	productMetadata: 
	{
		attributes: 
		{
			retailer: String,
			storefront: String,
			storefrontIso2: String,
			category: String,
			brand: String,
			manufacturer: String,
			identifiers: 
			{
				gtins: 
				[
					String
				],
				mpns: 
				[
					String
				],
				ean8: 
				[
					String
				],
				ean13: 
				[
					String
				],
				isbn9: 
				[
					String
				],
				isbn10: 
				[
					String
				],
				isbn13: 
				[
					String
				],
				itf14: 
				[
					String
				],
				upc12: 
				[
					String
				]
			},
			itemAttributes: 
			{
				book: 
				{
					authors: 
					[
						String
					]
				},
				audiobook: 
				{
					authors: 
					[
						String
					]
				},
				ebook: 
				{
					authors: 
					[
						String
					]
				}
			}
		},
		retailerSpecificAttributes: 
		{
			name: String,
			description: String,
			skus: 
			[
				String
			],
			asin: String,
			productImages: {},
			additionalData: 
			{
				String: String
			}
		},
		rawSourceData: String
	},
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String,
				meta: 
				{
					String: String
				}
			}
		],
		meta: 
		{
			String: String
		}
	}
}