64 lines
1.4 KiB
Markdown
64 lines
1.4 KiB
Markdown
# Simple API for DuckDuckGo
|
|
|
|
Simple API for DuckDuckGo that performs searches by scraping.
|
|
|
|
No money or registration is necessary.
|
|
|
|
## Use 🚀
|
|
|
|
```sh
|
|
curl localhost:8000/search/?q=test
|
|
```
|
|
|
|
Return
|
|
|
|
```json
|
|
[
|
|
{
|
|
"title": "Test - Test de CI Oficial",
|
|
"link": "test-iq-online.com",
|
|
"body": "Test oficial en Francia. 20 preguntas en 20 minutos. La prueba de CI oficial determina su CI y envía resultados certificados.",
|
|
"icon": false
|
|
},
|
|
{
|
|
"title": "Speedtest by Ookla - The Global Broadband Speed Test",
|
|
"link": "www.speedtest.net",
|
|
"body": "Speedtest by Ookla is a global broadband speed test that lets you measure your internet connection speed and performance. You can also access various features and insights on network performance, 5G deployment, and enterprise solutions.",
|
|
"icon": "external-content.duckduckgo.com/ip3/www.speedtest.net.ico"
|
|
},
|
|
...
|
|
]
|
|
```
|
|
|
|
## Endpoints 🛣️
|
|
|
|
`/search/` - Search for a term.
|
|
|
|
Params:
|
|
- `q` - The term to search for.
|
|
|
|
## Requirements 📋
|
|
|
|
- [Docker](https://www.docker.com/).
|
|
- [Docker Compose](https://docs.docker.com/compose/install/).
|
|
|
|
## Run 🏃
|
|
|
|
```
|
|
docker compose up
|
|
```
|
|
|
|
## Roadmap 🗺️
|
|
|
|
- [x] Param Query
|
|
- [ ] Good testing
|
|
- [ ] Param region
|
|
- [ ] Param time
|
|
- [ ] Pagination
|
|
|
|
## Nerd stuff 🤓
|
|
|
|
- Language: Python
|
|
- Architecture: Clean architecture
|
|
- Libraries: FastAPI, requests, beautifulsoup4, uvicorn and pytest.
|