{"files":{"SKILL.md":"---\nname: buy-marketing-api\ndescription: \"Buy Marketing API skill. Use when working with Buy Marketing for merchandised_product. Covers 1 endpoint.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Buy Marketing API\nAPI version: v1_beta.2.0\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://api.ebay.com/buy/marketing/v1_beta\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /merchandised_product -- this method returns an array of products based on the category and metric specified. this includes details of the product, such as the ebay product id (epid), title, and user reviews and ratings for the product. you can use the epid returned by this method in the browse api search method to retrieve items for this product. restrictions  to test  getmerchandisedproducts in sandbox, you must use category id 9355 and the response will be mock data.     for a list of supported sites and other restrictions, see api restrictions.\n3. Explore available endpoints below\n\n## Endpoints\n1 endpoint across 1 group. See references/api-spec.lap for full details.\n\n### Merchandised_product\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /merchandised_product | This method returns an array of products based on the category and metric specified. This includes details of the product, such as the eBay product ID (EPID), title, and user reviews and ratings for the product. You can use the epid returned by this method in the Browse API search method to retrieve items for this product. Restrictions  To test  getMerchandisedProducts in Sandbox, you must use category ID 9355 and the response will be mock data.     For a list of supported sites and other restrictions, see API Restrictions. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all merchandised_product?\" -> GET /merchandised_product\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Paginated endpoints accept limit/offset or cursor parameters\n- Error responses include status codes and descriptions in the spec\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api Buy Marketing API\n@base https://api.ebay.com/buy/marketing/v1_beta\n@version v1_beta.2.0\n@auth OAuth2\n@endpoints 1\n@toc merchandised_product(1)\n\n@endpoint GET /merchandised_product\n@desc This method returns an array of products based on the category and metric specified. This includes details of the product, such as the eBay product ID (EPID), title, and user reviews and ratings for the product. You can use the epid returned by this method in the Browse API search method to retrieve items for this product. Restrictions  To test  getMerchandisedProducts in Sandbox, you must use category ID 9355 and the response will be mock data.     For a list of supported sites and other restrictions, see API Restrictions.\n@required {category_id: any # This query parameter limits the products returned to a specific eBay category.   The list of eBay category IDs is not published and category IDs are not all the same across all the eBay maketplace. You can use the following techniques to find a category by site:  Use the Category Changes page. Use the Taxonomy API. For details see Get Categories for Buy APIs.   Use the Browse API and submit the following method to get the  dominantCategoryId for an item. /buy/browse/v1/item_summary/search?q=keyword&fieldgroups=ASPECT_REFINEMENTS     Maximum:  1   Required:  1, metric_name: any # This value filters the result set by the specified metric. Only products in this metric are returned. Currently, the only metric supported is  BEST_SELLING.  Default: BEST_SELLING   Maximum:  1   Required:  1}\n@optional {aspect_filter: any # The aspect name/value pairs used to further refine product results.  For example:    /buy/marketing/v1_beta/merchandised_product?category_id=31388&metric_name=BEST_SELLING&aspect_filter=Brand:Canon  You can use the Browse API search method with the fieldgroups=ASPECT_REFINEMENTS field to return the aspects of a product. For implementation help, refer to eBay API documentation at https://developer.ebay.com/api-docs/buy/marketing/types/gct:MarketingAspectFilter, limit: any # This value specifies the maximum number of products to return in a result set.   Note: Maximum value means the method will return up to that many products per set, but it can be less than this value. If the number of products found is less than this value, the method will return all of the products matching the criteria.   Default: 8 Maximum: 100}\n@returns(200) OK\n@errors {400: Bad Request, 409: Conflict, 500: Internal Server Error}\n\n@end\n"}}