{"id":13454760,"url":"https://github.com/lessapi-dev/lessapi-duckduckgo","last_synced_at":"2025-03-24T06:31:21.759Z","repository":{"id":232827829,"uuid":"784284946","full_name":"lessapi-dev/lessapi-duckduckgo","owner":"lessapi-dev","description":"LessAPI-DuckDuckGo is an API service for a search engine. Simple, lightweight, reliable, Docker deployable, easy to maintain. 一个基于DuckDuckGo的搜索引擎API服务。简单、轻量、可靠、Docker部署、易于维护。","archived":false,"fork":false,"pushed_at":"2024-04-24T15:30:52.000Z","size":95,"stargazers_count":17,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-04-25T21:05:21.494Z","etag":null,"topics":["duckduckgo","duckduckgo-api","duckduckgo-search","duckduckgo-search-engine","lessapi","search-api"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lessapi-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-09T14:49:54.000Z","updated_at":"2024-06-19T11:27:06.585Z","dependencies_parsed_at":"2024-04-14T16:00:33.062Z","dependency_job_id":"1323b94b-10b2-4bd6-bdea-d6ae4a74b453","html_url":"https://github.com/lessapi-dev/lessapi-duckduckgo","commit_stats":null,"previous_names":["gentleshare/lessapi-duckduckgo"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lessapi-dev%2Flessapi-duckduckgo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lessapi-dev%2Flessapi-duckduckgo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lessapi-dev%2Flessapi-duckduckgo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lessapi-dev%2Flessapi-duckduckgo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lessapi-dev","download_url":"https://codeload.github.com/lessapi-dev/lessapi-duckduckgo/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245222533,"owners_count":20580179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["duckduckgo","duckduckgo-api","duckduckgo-search","duckduckgo-search-engine","lessapi","search-api"],"created_at":"2024-07-31T08:00:57.715Z","updated_at":"2025-03-24T06:31:21.275Z","avatar_url":"https://github.com/lessapi-dev.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# LessAPI-DuckDuckGo\n\n[![GitHub](https://img.shields.io/github/license/lessapi-dev/lessapi-duckduckgo?style=for-the-badge)](https://github.com/lessapi-dev/lessapi-duckduckgo)\n[![Docker](https://img.shields.io/docker/pulls/lessapi/lessapi-duckduckgo?style=for-the-badge)](https://hub.docker.com/r/lessapi/lessapi-duckduckgo)\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Flessapi-dev%2Flessapi-duckduckgo.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Flessapi-dev%2Flessapi-duckduckgo?ref=badge_shield)\n\n[English](./README.md) |\n[简体中文](./docs/zhs/README.md) |\n[繁體中文](./docs/zht/README.md) |\n[日本語](./docs/ja/README.md) |\n[한국어](./docs/ko/README.md) |\n[Русский](./docs/ru/README.md) |\n[Deutsch](./docs/de/README.md) |\n[Français](./docs/fr/README.md) |\n[Español](./docs/es/README.md) |\n[Italiano](./docs/it/README.md) |\n[Português](./docs/pt/README.md)\n\n## Introduction\n\nLessAPI-DuckDuckGo is an API service for a search engine.\n\nBased on Playwright and DuckDuckGo's search engine, it encapsulates to provide simple API interfaces.\n\nSimple, lightweight, reliable, Docker deployable, easy to maintain.\n\nLarge Language Model (LLM) Friendly. Support Plain Text Response.\n\n## Status\n\n\u003e Experimentally under development and not recommended for use in production environments.\n\n## Deployment\n\nOne command is all it takes to deploy the service to port 8080 using Docker.\n\n```shell\ndocker run -d -p 8080:8080 --restart=unless-stopped --name lessapi-duckduckgo lessapi/lessapi-duckduckgo:v0.0.3\n```\n\n## Usage\n\n### OpenAPI Standard Documentation (Swagger 3.0)\n\n[OpenAPI Standard Documentation (Swagger 3.0)](resource/openapi.json)\n\n### Text Search `GET /search/text`\n\n**Request Parameters:**\n\n- keyword: Search keyword (required)\n- region: Region (optional) such as en-US, fr-FR, zh-CN, ru-RU, etc. Default is en-US\n- maxCount: Maximum number of results returned. (optional) Default is 20\n- viaProxyUrl: The address of the proxy used by the browser. e.g., http://proxy.server:3000 (optional) Default is empty\n- llmStyle: Whether to use Large Language Model (LLM) Friendly style response. e.g. 1, 0 (optional) Default is 0\n\n**Request Example:**\n\n```shell\ncurl 'http://127.0.0.1:8080/search/text?keyword=lessapi\u0026maxCount=10'\n```\n\n```shell\ncurl 'http://127.0.0.1:8080/search/text?keyword=lessapi\u0026maxCount=99\u0026viaProxyUrl=http://proxy.server:3000'\n```\n\n**Response Example:**\n\n```json\n{\n  \"code\": \"success\",\n  \"data\": {\n    \"results\": [\n      {\n        \"order\": 1,\n        \"title\": \"Adele - Hello (Official Music Video) - YouTube\",\n        \"url\": \"https://www.youtube.com/watch?v=YQHsXMglC9A\",\n        \"description\": \"Listen to \\\"Easy On Me\\\" here: http://Adele.lnk.to/EOMPre-order Adele's new album \\\"30\\\" before its release on November 19: https://www.adele.comShop the \\\"Adele...\"\n      },\n      {\n        \"order\": 2,\n        \"title\": \"Hello Definition \u0026 Meaning - Merriam-Webster\",\n        \"url\": \"https://www.merriam-webster.com/dictionary/hello\",\n        \"description\": \"Learn the origin, usage, and synonyms of the word hello, an expression or gesture of greeting. See examples of hello in sentences and related words from the dictionary.\"\n      }\n    ]\n  }\n}\n```\n\n## Advanced\n\n### Use Environment Variables\n\n- **LESSAPI_DEFAULT_LANGUAGE**: (optional) Default language, such as en-US, fr-FR, zh-CN, ru-RU, etc. Default is en-US\n- **LESSAPI_DEFAULT_VIA_PROXY_URL**: (optional) The address of the proxy used by the browser,\n  e.g., http://proxy.server:3000 Default is empty\n\n## Security\n\n[![Security Status](https://www.murphysec.com/platform3/v31/badge/1779906127272730624.svg)](https://www.murphysec.com/console/report/1778449242088529920/1779906127272730624)\n\n## License\n\n[MIT](./LICENSE)\n\n\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Flessapi-dev%2Flessapi-duckduckgo.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Flessapi-dev%2Flessapi-duckduckgo?ref=badge_large)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flessapi-dev%2Flessapi-duckduckgo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flessapi-dev%2Flessapi-duckduckgo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flessapi-dev%2Flessapi-duckduckgo/lists"}