Search public web pages and social content. Retrieve source pages or submit a research task. API requests require a bearer API key. Public sources do not mean anonymous API access.
| Method | Endpoint | Purpose |
|---|---|---|
| POST | /v1/maktaba/search | Search indexed web pages |
| POST | /v1/maktaba/social/search | Search social content |
| GET | /v1/maktaba/pages/{page_id} | Retrieve a source page |
| POST | /v1/maktaba/research | Submit a research task |
curl https://api.sawalni.com/v1/maktaba/search \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"query":"renewable energy in Morocco","limit":5}'
The search request accepts query, limit, cursor, and a filters object. Filter fields include domains, languages, source_types, published_from, and published_to.
curl https://api.sawalni.com/v1/maktaba/social/search \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"query":"Moroccan culture","limit":5}'
Optional social filters include language and platform.
curl https://api.sawalni.com/v1/maktaba/research \ -H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"task":"Find sources on renewable energy in Morocco","mode":"deep"}'
Use returned source references in your application. Check the current response and rate-limit headers. Handle failed requests before using their content. Do not treat a retrieved source as a verified fact.