{"files":{"SKILL.md":"---\nname: times-newswire-api\ndescription: \"Times Newswire API skill. Use when working with Times Newswire for content, content.json. Covers 3 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Times Newswire API\nAPI version: 3.0.0\n\n## Auth\nApiKey api-key in query\n\n## Base URL\nhttp://api.nytimes.com/svc/news/v3\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /content.json -- verify access\n3. Explore available endpoints below\n\n## Endpoints\n3 endpoints across 2 groups. See references/api-spec.lap for full details.\n\n### Content\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /content/{source}/{section}.json |  |\n| GET | /content/{source}/{section}/{time-period}.json |  |\n\n### Content.json\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /content.json |  |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Get content details?\" -> GET /content/{source}/{section}.json\n- \"List all content.json?\" -> GET /content.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- Paginated endpoints accept limit/offset or cursor parameters\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 Times Newswire API\n@base http://api.nytimes.com/svc/news/v3\n@version 3.0.0\n@auth ApiKey api-key in query\n@endpoints 3\n@toc content(2), content.json(1)\n\n@group content\n@endpoint GET /content/{source}/{section}.json\n@required {source: any # Limits the set of items by originating source  all = items from both The New York Times and The International New York Times nyt = New York Times items only iht = International New York Times items only, section: any # Limits the set of items by one or more sections all | One or more section names, separated by semicolons   To get all sections, specify all. To get a particular section or sections, use the section names returned by this request:  http://api.nytimes.com/svc/news/v3/content/section-list.json}\n@optional {limit: any # Limits the number of results, between 1 and 20, offset: any # Sets the starting point of the result set}\n@returns(200) An array of Articles\n\n@endpoint GET /content/{source}/{section}/{time-period}.json\n@required {source: any # Limits the set of items by originating source  all = items from both The New York Times and The International New York Times nyt = New York Times items only iht = International New York Times items only, section: any # Limits the set of items by one or more sections all | One or more section names, separated by semicolons   To get all sections, specify all. To get a particular section or sections, use the section names returned by this request:  http://api.nytimes.com/svc/news/v3/content/section-list.json, time-period: any # Limits the set of items by time published, integer in number of hours}\n@optional {limit: any # Limits the number of results, between 1 and 20, offset: any # Sets the starting point of the result set}\n@returns(200) An array of Articles\n\n@endgroup\n\n@group content.json\n@endpoint GET /content.json\n@required {url: any # The complete URL of a specific news item, URL-encoded or backslash-escaped}\n@returns(200) An array of Articles\n\n@endgroup\n\n@end\n"}}