Com APIafricfoodstore.com.ng ↗
Read the Afric Food Store catalogue, product details, NGN prices, allergens, store contact info, and per-country delivery rates via 4 structured API endpoints.
What is the Com API?
The Afric Food Store API provides structured access to africfoodstore.com.ng across 4 endpoints, covering the full product catalogue, individual product details, store contact and ordering information, and per-country shipping rates. The list_products endpoint returns all 65 catalogue cards in a single call, including variant slugs, categories, and pricing. The get_product endpoint exposes NGN prices, allergen statements, stock status, and option menus for products sold in multiple varieties or sizes.
curl -X GET 'https://api.parse.bot/scraper/16532c70-d112-4456-b486-2a889b52d588/list_products?sort=featured' \ -H 'X-API-Key: $PARSE_API_KEY'
Lists the store's whole catalogue in one call (the shop page renders every product; 65 products at build time, no pagination). Each row is one catalogue card: a single product, or an option group (e.g. a pepper family sold in several varieties/sizes) whose purchasable members are listed under variants with their own product_id and slug. Prices are in Nigerian naira (NGN); price_min/price_max span the variants (equal for single products). Optional category filter is applied by the site and must be one of the category names returned in categories; query is a case-insensitive substring match over each card's name, summary, SKU and variant names, applied locally; sort is applied by the site. Returns an empty products list when nothing matches the query.
| Param | Type | Description |
|---|---|---|
| sort | string | Catalogue ordering as offered by the shop's sort dropdown. |
| query | string | Free-text search term matched case-insensitively against product name, summary, SKU and variant names. Omitted = no text filter. |
| category | string | Shop category filter as labelled in the shop sidebar. Omitted = all categories. |
{
"type": "object",
"fields": {
"sort": "sort applied",
"count": "number of products returned after filters",
"query": "query applied or null",
"category": "category filter applied or null",
"products": "array of catalogue cards; each has product_id (string, the card's representative purchasable product), slug (consumed by get_product), name, category, summary, allergens (string or null), min_order_qty (integer), price_min/price_max (NGN numbers), price_display, currency, in_stock, has_options, variants (array of purchasable members: product_id, name, variety, size, price, price_display, in_stock, min_order_qty, slug) and url",
"categories": "array of all category names the shop offers",
"total_catalog_count": "number of cards in the full catalogue before filtering"
},
"sample": {
"data": {
"sort": "featured",
"count": 2,
"query": "pepper",
"category": null,
"products": [
{
"url": "https://africfoodstore.com.ng/shop/blended-chilli-pepper-1kg",
"name": "Pepper",
"slug": "blended-chilli-pepper-1kg",
"summary": null,
"category": "Spices & Seasoning",
"currency": "NGN",
"in_stock": true,
"variants": [
{
"name": "Blended Chilli Pepper 1kg",
"size": "1kg",
"slug": "blended-chilli-pepper-1kg",
"price": 16000,
"variety": "Blended Chilli Pepper",
"in_stock": true,
"product_id": "146",
"min_order_qty": 1,
"price_display": "₦16,000"
},
{
"name": "Dried Cameron Pepper Unblended 500g",
"size": "500g",
"slug": "dried-cameron-pepper-unblended-500g",
"price": 8000,
"variety": "Cameroon Pepper (Dried, Unblended)",
"in_stock": true,
"product_id": "67",
"min_order_qty": 1,
"price_display": "₦8,000"
}
],
"allergens": null,
"price_max": 16000,
"price_min": 6000,
"product_id": "146",
"has_options": true,
"min_order_qty": 1,
"price_display": "₦6,000 – ₦16,000"
},
{
"url": "https://africfoodstore.com.ng/shop/apo-fish",
"name": "APO FISH",
"slug": "apo-fish",
"summary": "rich source of lean protein",
"category": "Fish & Meat",
"currency": "NGN",
"in_stock": true,
"variants": [],
"allergens": "Fish",
"price_max": 1200,
"price_min": 1200,
"product_id": "59",
"has_options": false,
"min_order_qty": 10,
"price_display": "₦1,200.00"
}
],
"categories": [
"Beans, Nuts & Tubers",
"Combo Sales",
"Fish & Meat",
"Flour",
"Grains",
"Oils & Condiments",
"Snacks",
"Soup Bases",
"Spices & Seasoning"
],
"total_catalog_count": 65
},
"status": "success"
}
}About the Com API
Catalogue and Product Data
The list_products endpoint returns the store's full catalogue in one response — no pagination. Each catalogue card includes a product_id, slug, variant names, and a summary. You can filter by category (using the category names the store's sidebar exposes), pass a query string for case-insensitive search across product names, SKUs, and variant names, or specify a sort order matching the shop's own sort dropdown. The response also carries a categories array listing every shop category and a total_catalog_count for the unfiltered catalogue size.
Individual Product Details
Passing a slug from list_products to get_product retrieves a single product's full detail page. Returned fields include price (as an NGN number), tax_note, allergens (a statement string or null), in_stock, min_order_qty, max_order_qty, image_url, and options — an object keyed by option type (e.g. Variety, Size) where each entry carries a label, a slug pointing to the sibling product that option switches to, and a selected flag. Products with no variants return an empty options object.
Store Info and Ordering Flow
The get_store_info endpoint returns the store name, tagline, contact methods (emails, tel links, WhatsApp links, and contact form details), business_location indicators, and an ordering object that describes whether online ordering is available, the checkout steps, accepted payment gateways, and checkout fields. Phone numbers may be absent from the structured phones array when they appear only within banner images on the source site.
Shipping Rates by Country
The get_shipping_options endpoint accepts an ISO-2 country code and returns an array of rates — each with name, price in NGN, price_display, delivery_time, and a condition note for weight minimums. The basket_basis field quotes the site's reference basket statement so you know the weight/quantity context the rates were calculated against. A note field carries any free-text shipping note the store shows for that destination.
The Com API is a managed, monitored endpoint for africfoodstore.com.ng — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when africfoodstore.com.ng changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official africfoodstore.com.ng API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Sync the full Afric Food Store catalogue into a price-comparison tool using
list_productswith category filters - Display allergen information for African food products by fetching
allergensfromget_product - Check real-time NGN prices and stock status for specific product slugs before surfacing them to customers
- Build a delivery cost estimator for diaspora shoppers by querying
get_shipping_optionswith their ISO-2 country code - Populate a product variant picker (size, variety) using the
optionsobject returned byget_product - Extract store contact methods and payment gateway details from
get_store_infofor a third-party ordering integration - Track catalogue size changes over time using
total_catalog_countfromlist_products
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does africfoodstore.com.ng have an official developer API?+
What does `get_product` return for products sold in multiple sizes or varieties?+
options field is an object keyed by option type (e.g. Variety, Size). Each entry is an array of objects with a label, a slug pointing to the sibling product that option represents, and a selected boolean. Single products return an empty options object. This lets you navigate the full variant tree using only additional get_product calls.Does the catalogue endpoint paginate results?+
list_products returns the entire catalogue in a single response — 65 products at the time this API was built. The count field reflects results after any query or category filter, and total_catalog_count always reflects the unfiltered size.Are customer reviews or ratings available through this API?+
Are phone numbers always present in the `get_store_info` contact data?+
phones array may be empty when phone numbers appear only inside banner images on the site rather than as text or tel links. The emails, whatsapp_links, and contact_form fields are more reliably populated. If phone extraction matters for your use case, you can fork the API on Parse and revise it to add additional extraction logic.