bawabatic.dz APIbawabatic.dz ↗
Access Algerian government public services, themes, sectors, and procedures via the bawabatic.dz API. Supports Arabic, French, and English.
curl -X GET 'https://api.parse.bot/scraper/24ffe10c-26ba-422b-8e0a-db30dcd221f3/get_homepage' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch the main homepage of the Government Portal of Public Services, returning the portal description and basic metadata. Supports lang parameter (ar/fr/en).
| Param | Type | Description |
|---|---|---|
| lang | string | Language (ar/fr/en) |
{
"type": "object",
"fields": {
"url": "string",
"lang": "string",
"title": "string",
"description": "string"
},
"sample": {
"url": "http://bawaba.mna.gov.dz/index.php",
"lang": "en",
"title": "Government Portal of Public Services",
"description": "Algerian Portal for Public Services and Administrative Procedures"
}
}About the bawabatic.dz API
The bawabatic.dz API exposes 9 endpoints covering the Algerian Government Portal of Public Services, returning structured data on service themes, ministries, individual procedures, and official government links. Using get_service_detail, you can retrieve a specific procedure's name, description, metadata object, and target audience array. The API supports Arabic, French, and English via a lang parameter on every endpoint.
What the API Covers
The bawabatic.dz API surfaces data from Algeria's official public services portal. It covers the portal's full taxonomy of services: list_themes returns every theme/category with a total_themes count and per-theme service count, while list_sectors returns all ministries and government sectors with a total_sectors count. Every endpoint accepts an optional lang parameter accepting ar, fr, or en, so responses can be retrieved in the language most useful for your application.
Browsing and Searching Services
get_services_by_theme and get_services_by_sector both require an ID (theme_id or sector_id respectively) and return an array of services plus a count. To drill into a specific procedure, get_service_detail accepts a service_id and returns id, name, description, a metadata object, and a target_audience array — the most field-rich response in the API. search_services accepts a free-text query and returns a results array spanning all themes and sectors, making it the fastest way to locate a service without knowing its theme or sector in advance.
Supporting Endpoints
get_homepage returns the portal's title and description plus the resolved url and active lang — useful for confirming portal availability or surfacing localized portal copy. get_country_info returns structured fields including official_name, government, operator, location, and a contact object with Algeria's national contact details as listed on the portal. get_important_links returns an array of curated external government links featured on the portal homepage.
IDs and Navigation
Theme and sector IDs used by get_services_by_theme and get_services_by_sector are obtained from the themes array returned by list_themes and the sectors array returned by list_sectors respectively. Service IDs for get_service_detail are found within those service arrays. There is no separate ID-lookup endpoint, so the intended flow is: list → browse by theme or sector → detail.
- Build a multilingual directory of Algerian administrative procedures using
list_themesandget_service_detailfields liketarget_audienceanddescription. - Power a government chatbot that resolves citizen queries by calling
search_serviceswith a keyword and returning matching procedure names. - Map ministries to their services by pairing
list_sectorswithget_services_by_sectorfor a sector-level service inventory. - Integrate Algerian public service data into an expat or immigration guide using the
frorenlang parameter. - Aggregate official government portal links from
get_important_linksto build a curated resource hub for public administration. - Surface Algeria country metadata (
official_name,government,contact) in civic-tech or open-data dashboards viaget_country_info. - Monitor which themes have the most services by comparing
total_themescounts fromlist_themesover time.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does bawabatic.dz have an official developer API?+
What does `get_service_detail` return beyond a service name?+
get_service_detail returns id, name, description, a metadata object (which may include procedure-specific fields such as required documents or deadlines as presented on the portal), and a target_audience array identifying who the service applies to. All fields are returned in the language specified by the lang parameter.Does the API return downloadable forms or attached documents for procedures?+
Is there pagination for large result sets from `list_themes` or `list_sectors`?+
total_themes and total_sectors reflect the complete count. There are no offset or page parameters currently. If the portal adds significantly more entries and pagination becomes necessary, you can fork the API on Parse and revise it to add pagination support.Can I filter services by both theme and sector simultaneously?+
get_services_by_theme filters by theme_id and get_services_by_sector filters by sector_id — each filter operates independently. Cross-filtering by both dimensions in a single call is not currently supported. You can fork this API on Parse and revise it to add a combined filter endpoint.