{"files":{"SKILL.md":"---\nname: word-associations-api\ndescription: \"Word Associations API skill. Use when working with Word Associations for json. Covers 2 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# Word Associations API\nAPI version: 1.0\n\n## Auth\nApiKey apikey in query\n\n## Base URL\nhttps://api.wordassociations.net/associations/v1.0\n\n## Setup\n1. Set your API key in the appropriate header\n2. GET /json/search -- gets associations with the given word or phrase.\n3. POST /json/search -- create first search\n\n## Endpoints\n2 endpoints across 1 group. See references/api-spec.lap for full details.\n\n### Json\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /json/search | Gets associations with the given word or phrase. |\n| POST | /json/search | Gets associations with the given word or phrase. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"List all search?\" -> GET /json/search\n- \"Create a search?\" -> POST /json/search\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- Create/update endpoints return the modified resource on success\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 Word Associations API\n@base https://api.wordassociations.net/associations/v1.0\n@version 1.0\n@auth ApiKey apikey in query\n@endpoints 2\n@toc json(2)\n\n@endpoint GET /json/search\n@desc Gets associations with the given word or phrase.\n@required {text: any # Word or phrase to find associations with. Tip. You can use multiple parameters 'text' in a request (from 1 to 10 inclusive). This way you can get associations for several input words or phrases in one response. Restriction: regardless of the size of the text association lookup is always performed by the first 10 words of the text., lang: any # Query language. Use language code for the language of the text: * de - German; * en - English; * es - Spanish; * fr - French; * it - Italian; * pt - Portuguese; * ru - Russian;}\n@optional {type: any # Type of result. Possible values:  * stimulus - an input data (the text parameter) is considered as a response word. The service returns a list of stimuli words, which evoke a given response word; * response - an input data (the text parameter) is considered as a stimulus word. The service returns a list of response words, which come to mind for a given stimulus word., limit: any # Maximum number of results to return. Allows to limit the number of results (associations) in response. The value of this parameter is an integer number from 1 to 300 inclusive., pos: any # Parts of speech to return. Allows to limit results by specified parts of speech. The value of this parameter is a list of parts of speech separated by comma. The following parts of speech codes are supported: * noun * adjective * verb * adverb, indent: any # Indentation switch for pretty printing of JSON response. Allows to either turn on or off space indentation for a response. The following values are allowed: * yes - turns indentation with spaces on; * no - turn indentation with spaces off;}\n@returns(200) Successful response\n@errors {401: Invalid API key, 429: The monthly limit on the number of requests is exceeded, 501: The specified language is not supported}\n\n@endpoint POST /json/search\n@desc Gets associations with the given word or phrase.\n@required {text: any # Word or phrase to find associations with. Tip. You can use multiple parameters 'text' in a request (from 1 to 10 inclusive). This way you can get associations for several input words or phrases in one response. Restriction: regardless of the size of the text association lookup is always performed by the first 10 words of the text., lang: any # Query language. Use language code for the language of the text: * de - German; * en - English; * es - Spanish; * fr - French; * it - Italian; * pt - Portuguese; * ru - Russian;}\n@optional {type: any # Type of result. Possible values:  * stimulus - an input data (the text parameter) is considered as a response word. The service returns a list of stimuli words, which evoke a given response word; * response - an input data (the text parameter) is considered as a stimulus word. The service returns a list of response words, which come to mind for a given stimulus word., limit: any # Maximum number of results to return. Allows to limit the number of results (associations) in response. The value of this parameter is an integer number from 1 to 300 inclusive., pos: any # Parts of speech to return. Allows to limit results by specified parts of speech. The value of this parameter is a list of parts of speech separated by comma. The following parts of speech codes are supported: * noun * adjective * verb * adverb, indent: any # Indentation switch for pretty printing of JSON response. Allows to either turn on or off space indentation for a response. The following values are allowed: * yes - turns indentation with spaces on; * no - turn indentation with spaces off;}\n@returns(200) Successful response\n@errors {401: Invalid API key, 429: The monthly limit on the number of requests is exceeded, 501: The specified language is not supported}\n\n@end\n"}}