runoob.com APIrunoob.com ↗
Access Runoob.com programming tutorials via API. Browse categories, retrieve full tutorial content, search lessons, and extract metadata across thousands of coding guides.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/bf324a74-606a-4bf2-9a08-01dcb9e3caf5/list_homepage_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Scrapes the homepage to return all top-level tutorial categories with their identifiers.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of category objects with name and category_id",
"status": "string indicating success"
},
"sample": {
"data": [
{
"name": "Python / 数据科学",
"category_id": "python_data"
},
{
"name": "AI / 智能开发",
"category_id": "ai"
},
{
"name": "前端开发",
"category_id": "frontend"
}
],
"status": "success"
}
}About the runoob.com API
The Runoob.com API exposes 7 endpoints for extracting structured data from one of the largest Chinese-language programming tutorial sites. Use list_homepage_categories to enumerate all top-level tutorial categories, get_tutorial_page_content to retrieve full lesson text and navigation links, or search_tutorials to query across thousands of coding topics including HTML, CSS, Python, and more.
Browse and Navigate Tutorial Content
list_homepage_categories returns an array of category objects, each with a name and category_id, covering every top-level subject area on the Runoob.com homepage. list_tutorials_by_category builds on this by returning the full list of tutorials nested under each category; pass a category_name string (e.g. 'Python' or 'HTML') to filter results case-insensitively, or omit it to retrieve all tutorials across all categories at once. Each result in the tutorials array is scoped to its parent category name.
Retrieve Tutorial Structure and Page Content
get_tutorial_directory accepts a url parameter — either a full URL or a relative path like 'html/html-tutorial.html' — and returns the sidebar navigation for that tutorial as a structured directory array of topic links. This gives you the complete table of contents for any tutorial section without loading individual pages. get_tutorial_page_content fetches the main content area of any tutorial page, returning title, content text, and a navigation_links array containing previous and next page links for sequential traversal.
Search and Metadata
search_tutorials takes a query string and returns an array of matching results, each with title, url, and description fields. This is useful for building search interfaces or cross-referencing topics across the site's catalog. get_tutorial_metadata returns page-level SEO fields — title, description, keywords, and canonical_url — for any tutorial URL, which can be used to index or classify content programmatically. get_top_navbar_links retrieves the top navigation bar as an array of name/url pairs.
Coverage Notes
All endpoints operate against Runoob.com's publicly accessible tutorial pages. Content is primarily in Chinese (Simplified), reflecting the site's audience. Interactive exercises, quizzes, and user account data (login-required sections) are not exposed by these endpoints.
- Build a Chinese-language programming tutorial aggregator using
list_tutorials_by_categoryto organize content by subject. - Generate a full course index for any Runoob tutorial using
get_tutorial_directoryto extract the sidebar table of contents. - Automate content auditing by iterating pages with
get_tutorial_page_contentand collectingtitleandcontentfields. - Create a cross-topic search tool for developers using
search_tutorialswith keyword queries like 'CSS grid' or 'Django'. - Index tutorial SEO metadata at scale using
get_tutorial_metadatato capturekeywords,description, andcanonical_url. - Map the full Runoob site structure by combining
list_homepage_categorieswithget_top_navbar_linksoutput. - Build sequential lesson navigation by chaining
navigation_linksreturned fromget_tutorial_page_content.
| 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 Runoob.com have an official public developer API?+
What does `get_tutorial_page_content` return, and how is it different from `get_tutorial_directory`?+
get_tutorial_page_content returns the main lesson body — title, full content text, and a navigation_links array for previous/next pages. get_tutorial_directory returns only the sidebar navigation structure (a directory array of topic links) for the broader tutorial section, not the individual page text.Does `list_tutorials_by_category` support pagination or return all results at once?+
data array contains every tutorial listed under the requested category on the homepage.Does the API expose interactive exercises, code runners, or user quiz results from Runoob.com?+
Is the tutorial content returned in English or Chinese?+
content, title, description, and keywords fields are primarily in Simplified Chinese. Topic names like programming languages (Python, HTML, CSS) appear in their standard Latin forms within the content.