{"files":{"SKILL.md":"---\nname: analytics-api\ndescription: \"Analytics API skill. Use when working with Analytics for rate_limit, user_rate_limit. Covers 2 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Analytics API\nAPI version: v1_beta.0.1\n\n## Auth\nOAuth2\n\n## Base URL\nhttps://api.ebay.com/developer/analytics/v1_beta\n\n## Setup\n1. Configure auth: OAuth2\n2. GET /rate_limit/ -- this method retrieves the call limit and utilization data for an application. the data is retrieved for all restful apis and the legacy trading api.  the response from getratelimits includes a list of the applicable resources and the \"call limit\", or quota, that is set for each resource. in addition to quota information, the response also includes the number of remaining calls available before the limit is reached, the time remaining before the quota resets, the number of calls made to the specific resource, and the length of the \"time window\" to which the quota applies.  by default, this method returns utilization data for all restful api and the legacy trading api resources. use the api_name and api_context query parameters to filter the response to only the desired apis.  for more on call limits, see application growth check.\n3. Explore available endpoints below\n\n## Endpoints\n2 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### Rate_limit\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /rate_limit/ | This method retrieves the call limit and utilization data for an application. The data is retrieved for all RESTful APIs and the legacy Trading API.  The response from getRateLimits includes a list of the applicable resources and the \"call limit\", or quota, that is set for each resource. In addition to quota information, the response also includes the number of remaining calls available before the limit is reached, the time remaining before the quota resets, the number of calls made to the specific resource, and the length of the \"time window\" to which the quota applies.  By default, this method returns utilization data for all RESTful API and the legacy Trading API resources. Use the api_name and api_context query parameters to filter the response to only the desired APIs.  For more on call limits, see Application Growth Check. |\n\n### User_rate_limit\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /user_rate_limit/ | This method retrieves the call limit and utilization data for an application user. The call-limit data is returned for all RESTful APIs and the legacy Trading API that limit calls on a per-user basis.  The response from getUserRateLimits includes a list of the applicable resources and the \"call limit\", or quota, that is set for each resource. In addition to quota information, the response also includes the number of remaining calls available before the limit is reached, the time remaining before the quota resets, the number of calls made to the specific resource, and the length of the \"time window\" to which the quota applies.  By default, this method returns utilization data for all RESTful APIs resources and the legacy Trading API calls that limit request access by user. Use the api_name and api_context query parameters to filter the response to only the desired APIs.  For more on call limits, see Application Growth Check. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all rate_limit?\" -> GET /rate_limit/\n- \"List all user_rate_limit?\" -> GET /user_rate_limit/\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- 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 Analytics API\n@base https://api.ebay.com/developer/analytics/v1_beta\n@version v1_beta.0.1\n@auth OAuth2\n@endpoints 2\n@toc rate_limit(1), user_rate_limit(1)\n\n@group rate_limit\n@endpoint GET /rate_limit/\n@desc This method retrieves the call limit and utilization data for an application. The data is retrieved for all RESTful APIs and the legacy Trading API.  The response from getRateLimits includes a list of the applicable resources and the \"call limit\", or quota, that is set for each resource. In addition to quota information, the response also includes the number of remaining calls available before the limit is reached, the time remaining before the quota resets, the number of calls made to the specific resource, and the length of the \"time window\" to which the quota applies.  By default, this method returns utilization data for all RESTful API and the legacy Trading API resources. Use the api_name and api_context query parameters to filter the response to only the desired APIs.  For more on call limits, see Application Growth Check.\n@optional {api_context: str # This optional query parameter filters the result to include only the specified API context. Valid values: buysell commercedevelopertradingapi, api_name: str # This optional query parameter filters the result to include only the APIs specified. Example values:  browse for the Buy APIs inventory for the Sell APIs  taxonomy for the Commerce APIs  tradingapi for the Trading APIs}\n@returns(200) {rateLimits: [map]} # OK\n@returns(204) No Content\n@errors {500: Internal Server Error}\n\n@endgroup\n\n@group user_rate_limit\n@endpoint GET /user_rate_limit/\n@desc This method retrieves the call limit and utilization data for an application user. The call-limit data is returned for all RESTful APIs and the legacy Trading API that limit calls on a per-user basis.  The response from getUserRateLimits includes a list of the applicable resources and the \"call limit\", or quota, that is set for each resource. In addition to quota information, the response also includes the number of remaining calls available before the limit is reached, the time remaining before the quota resets, the number of calls made to the specific resource, and the length of the \"time window\" to which the quota applies.  By default, this method returns utilization data for all RESTful APIs resources and the legacy Trading API calls that limit request access by user. Use the api_name and api_context query parameters to filter the response to only the desired APIs.  For more on call limits, see Application Growth Check.\n@optional {api_context: str # This optional query parameter filters the result to include only the specified API context. Valid values: buy sell commerce developer tradingapi, api_name: str # This optional query parameter filters the result to include only the APIs specified. Example values: browse for the Buy APIs inventory for the Sell APIs  taxonomy for the Commerce APIs  tradingapi for the Trading APIs}\n@returns(200) {rateLimits: [map]} # OK\n@returns(204) No Content\n@errors {500: Internal Server Error}\n\n@endgroup\n\n@end\n"}}