{"files":{"SKILL.md":"---\nname: most-popular-api\ndescription: \"Most Popular API skill. Use when working with Most Popular for mostshared, mostemailed, mostviewed. Covers 3 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Most Popular API\nAPI version: 2.0.0\n\n## Auth\nApiKey api-key in query\n\n## Base URL\nhttp://api.nytimes.com/svc/mostpopular/v2\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /mostshared/{section}/{time-period}.json -- most shared by section & time period\n3. Explore available endpoints below\n\n## Endpoints\n3 endpoints across 3 groups. See references/api-spec.lap for full details.\n\n### Mostshared\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /mostshared/{section}/{time-period}.json | Most Shared by Section & Time Period |\n\n### Mostemailed\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /mostemailed/{section}/{time-period}.json | Most Emailed by Section & Time Period |\n\n### Mostviewed\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /mostviewed/{section}/{time-period}.json | Most Viewed by Section & Time Period |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Get mostshared details?\" -> GET /mostshared/{section}/{time-period}.json\n- \"Get mostemailed details?\" -> GET /mostemailed/{section}/{time-period}.json\n- \"Get mostviewed details?\" -> GET /mostviewed/{section}/{time-period}.json\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 Most Popular API\n@base http://api.nytimes.com/svc/mostpopular/v2\n@version 2.0.0\n@auth ApiKey api-key in query\n@endpoints 3\n@toc mostshared(1), mostemailed(1), mostviewed(1)\n\n@group mostshared\n@endpoint GET /mostshared/{section}/{time-period}.json\n@desc Most Shared by Section & Time Period\n@returns(200) An array of Articles\n@errors {400}\n\n@endgroup\n\n@group mostemailed\n@endpoint GET /mostemailed/{section}/{time-period}.json\n@desc Most Emailed by Section & Time Period\n@returns(200) An array of Articles\n@errors {400, 403}\n\n@endgroup\n\n@group mostviewed\n@endpoint GET /mostviewed/{section}/{time-period}.json\n@desc Most Viewed by Section & Time Period\n@returns(200) An array of Articles\n\n@endgroup\n\n@end\n"}}