@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Catalog API
@base https://api.ebay.com/commerce/catalog/v1_beta
@version v1_beta.5.3
@auth OAuth2
@endpoints 2
@toc product(1), product_summary(1)

@group product
@endpoint GET /product/{epid}
@required {epid: str}
@optional {X-EBAY-C-MARKETPLACE-ID: str}
@returns(200) {additionalImages: [map], aspects: [map], brand: str, compatibilityCount: int(int32), description: str, ean: [str], epid: str, gtin: [str], image: map{height: int(int32), imageUrl: str, width: int(int32)}, isbn: [str], mpn: [str], otherApplicableCategoryIds: [str], primaryCategoryId: str, productWebUrl: str, title: str, upc: [str], version: str}
@errors {400, 403, 404, 500}

@endgroup

@group product_summary
@endpoint GET /product_summary/search
@optional {X-EBAY-C-MARKETPLACE-ID: str, aspect_filter: str, category_ids: str, fieldgroups: str, gtin: str, limit: str, mpn: str, offset: str, q: str}
@returns(200) {href: str, limit: int(int32), next: str, offset: int(int32), prev: str, productSummaries: [map], refinement: map{aspectDistributions: [map], dominantCategoryId: str}, total: int(int32)}
@returns(204)
@errors {400, 403, 500}

@endgroup

@end