Nil Academy APInilacademy.ir ↗
Retrieve Karbarg Grade 4 worksheet product listings and details from nilacademy.ir, including titles, prices, thumbnails, categories, and download availability.
What is the Nil Academy API?
The Nil Academy API provides 2 endpoints for accessing Karbarg (worksheet) Grade 4 product data from nilacademy.ir. The list_products endpoint returns paginated product listings with titles, prices, thumbnails, and URLs, while get_product returns full product details including description, brand, categories, virtual product status, and download link visibility for a single product by slug.
curl -X GET 'https://api.parse.bot/scraper/097b9b60-3e5c-4050-8895-1b9a0faa9702/list_products?page=1&per_page=10' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns a paginated list of Karbarg Grade 4 worksheet products. Each product includes its title, product page URL, thumbnail image URL, regular price, and sale price (when on sale). Pagination is controlled by the page and per_page parameters. The response includes total product count, total pages, and a has_next flag for continuation.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| per_page | integer | Number of products per page. Omitting returns 10. |
{
"type": "object",
"fields": {
"page": "current page number",
"total": "total number of products in this category",
"has_next": "boolean indicating if there is a next page",
"per_page": "number of products per page",
"products": "array of product objects, each containing title, url, thumbnail, regular_price, and sale_price",
"total_pages": "total number of pages"
},
"sample": {
"data": {
"page": 1,
"total": 85,
"has_next": true,
"per_page": 10,
"products": [
{
"url": "https://nilacademy.ir/product/%da%a9%d8%a7%d8%b1%d8%a8%d8%b1%da%af-%d9%87%d8%a7%db%8c-%d8%ac%d8%a7%d9%85%d8%b9-%d9%87%d8%af%db%8c%d9%87-%d9%87%d8%a7%db%8c-%d8%a2%d8%b3%d9%85%d8%a7%d9%86%db%8c-%da%86%d9%87%d8%a7%d8%b1%d9%85-%d8%a7/",
"title": "کاربرگ های جامع هدیه های آسمانی چهارم ابتدایی 1405",
"thumbnail": "https://nilacademy.ir/wp-content/uploads/2026/08/IMG_3872-600x600.png",
"sale_price": null,
"regular_price": "تومان۳۸۰.۰۰۰"
},
{
"url": "https://nilacademy.ir/product/%da%a9%d8%a7%d8%b1%d8%a8%d8%b1%da%af-%d9%be%db%8c%da%a9-%d9%87%d9%81%d8%aa%da%af%db%8c-%d8%a2%d8%af%db%8c%d9%86%d9%87-%d9%be%d8%a7%db%8c%d9%87-%da%86%d9%87%d8%a7%d8%b1%d9%85/",
"title": "کاربرگ پیک هفتگی (آدینه) پایه چهارم",
"thumbnail": "https://nilacademy.ir/wp-content/uploads/2025/08/0-Copy-Copy-copy.webp",
"sale_price": "تومان۱۴۹.۵۰۰",
"regular_price": "تومان۲۹۹.۰۰۰"
}
],
"total_pages": 9
},
"status": "success"
}
}About the Nil Academy API
Product Listings
The list_products endpoint returns a paginated array of Karbarg Grade 4 worksheet products. Each object in the products array includes title, url, thumbnail, regular_price, and sale_price. Pagination is controlled via page (1-based integer) and per_page (defaults to 10 if omitted). The response also returns total, total_pages, and a has_next boolean so you can traverse the full catalog without guessing at page counts.
Product Detail
The get_product endpoint accepts a slug string — the URL path segment from a product page — and returns a richer data set for a single product. Fields include title, description, regular_price, sale_price, thumbnail, categories (array of strings), brand, product_id (WooCommerce ID), and is_virtual. The download_links array surfaces any publicly visible downloadable files (PDF, ZIP, etc.) as objects with url and text fields. For products that require a purchase before files are accessible, login_required is set accordingly.
Prices and Currency
All price fields are returned as strings with currency symbols in Persian numerals, matching the formatting used on nilacademy.ir. sale_price is null when the product is not on sale, so you can use its presence to filter discounted items. regular_price is always present for listed products.
Coverage Scope
This API covers products specifically under the Karbarg Grade 4 (پایه چهارم) worksheet category on nilacademy.ir. Products from other grade levels or subject categories on the site are outside the current scope.
The Nil Academy API is a managed, monitored endpoint for nilacademy.ir — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when nilacademy.ir 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 nilacademy.ir 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?+
- Build a price-monitoring tool that tracks
sale_pricechanges on Grade 4 worksheet products over time. - Aggregate all Karbarg Grade 4 product thumbnails and titles for a curated educational resource index.
- Check
download_linksacross products to surface freely downloadable worksheet previews without manual browsing. - Sync product catalog data — including
product_id,categories, andbrand— into a local database for offline search. - Filter
is_virtualproducts to distinguish downloadable worksheets from any physical items in the listing. - Display paginated product cards in a parent-facing app using
list_productswithper_pageset per layout requirements.
| 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 nilacademy.ir have an official developer API?+
What does `get_product` return for downloadable files?+
download_links field returns an array of objects, each with a url and text, for any files publicly visible on the product page. If the files are gated behind a purchase or login, the login_required field is set to indicate that, and download_links will be empty or absent for those files.Does the API cover worksheet products from other grade levels on nilacademy.ir?+
How does pagination work in `list_products`, and can I retrieve all products in one call?+
page and per_page parameters. The response includes total_pages and has_next so you can iterate. Omitting per_page defaults to 10 results. To retrieve all products you would need to page through until has_next is false.