Org APIttbz.org.cn ↗
Access Chinese group standards, issuing organizations, and policy news from ttbz.org.cn. Retrieve standard details, CCS codes, org profiles, and homepage announcements.
What is the Org API?
This API exposes 7 endpoints covering the national group standards information platform at ttbz.org.cn, returning data on registered social organizations, their published standards, and homepage policy announcements. The get_standard_detail endpoint alone surfaces 10 response fields including CCS classification path, abstract, publication date, and English title. You can browse active standards across all organizations or scope results to a single issuer using get_standards_by_organization.
curl -X GET 'https://api.parse.bot/scraper/3799ca58-34f8-4d64-a696-2ed6cd74fcee/get_organizations?page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ttbz-org-cn-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Ttbz Group Standards SDK — browse standards, drill into details."""
from parse_apis.ttbz_group_standards_api import Ttbz, ResourceNotFound
client = Ttbz()
# List the latest published standards across all organizations.
for std in client.standardsummaries.list(limit=3):
print(std.standard_code, std.standard_name, std.organization_name)
# Drill into the first standard's full detail.
std_summary = client.standardsummaries.list(limit=1).first()
if std_summary:
detail = std_summary.details()
print(detail.title, detail.status, detail.issuing_org)
if detail.abstract:
print(detail.abstract[:120])
# Browse organizations and their standards via sub-resource navigation.
org_summary = client.organizationsummaries.list(limit=1).first()
if org_summary:
org = org_summary.details()
print(org.name, org.legal_representative, org.address)
for s in org.standards.list(limit=3):
print(s.standard_code, s.standard_name)
# Typed error handling on a direct fetch by ID.
try:
bad = client.standards.get(standard_id="nonexistent_id_000")
print(bad.title)
except ResourceNotFound as exc:
print(f"Standard not found: {exc}")
# Read homepage news and fetch article content.
news = client.newsitems.list(limit=1).first()
if news:
article = news.details()
print(article.title, article.publisher)
print("exercised: standardsummaries.list / details / organizationsummaries.list / org.standards.list / standards.get / newsitems.list / news.details")
Retrieve a paginated list of social organizations registered on the platform. Returns up to 10 organizations per page with details including legal representative, business scope, and unified social credit code. Total is capped at 100 visible organizations.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to retrieve. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"total": "integer, total number of organizations available",
"organizations": "array of organization objects"
},
"sample": {
"data": {
"page": 1,
"total": 100,
"organizations": [
{
"business_scope": "1、搭建黑土优品品牌专业化发展一站式服务平台",
"cert_unit_area": "黑龙江省",
"organization_id": "466ed6201b644f8fa057d06a56fdb20b",
"organization_code": "HTYPA",
"organization_name": "黑龙江省黑土优品农业品牌推广发展协会",
"legal_representative": "杨侠",
"unified_social_credit_code": "51230000MJ0C22306M"
}
]
},
"status": "success"
}
}About the Org API
Organizations and Standards Coverage
The API covers two primary entity types: social organizations and the group standards they issue. get_organizations returns a paginated list of up to 100 visible organizations — each record includes the legal representative name, unified social credit code, and business scope. Passing an organization_id to get_organization_detail yields additional fields: registered address, activity region, host organization, and the certificate issuing authority. The same organization_id value feeds directly into get_standards_by_organization to list that org's published standards with pagination via the page parameter.
Standards Data
get_standards returns the full cross-organization catalog of currently active group standards ordered by most recent publication date, paginated at 10 records per page with total_pages in the response. For a specific record, get_standard_detail returns the Chinese title, optional English title (title_en), standard_code, status, abstract, publication_date in YYYY-MM-DD format, and the ccs_classification path used in Chinese standards classification. The organization_id in the detail response links back to the issuing org.
News and Announcements
get_homepage_news returns the current list of news items from the platform homepage — typically policy documents and standardization activity notices — each with a news_id and url. Passing a news_id to get_news_detail retrieves the full article text, publisher, and publish_date. Note that publisher and content can be null for some records, and get_homepage_news takes no input parameters, so it always reflects the current homepage state.
The Org API is a managed, monitored endpoint for ttbz.org.cn — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ttbz.org.cn 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 ttbz.org.cn 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 searchable database of Chinese group standards indexed by CCS classification code.
- Monitor newly published active standards by polling
get_standardsand trackingpublication_date. - Enrich a compliance tool with issuing organization profiles including unified social credit code and activity region.
- Map org-to-standards relationships using
organization_idacrossget_organizationsandget_standards_by_organization. - Aggregate policy announcements from
get_homepage_newsandget_news_detailinto a regulatory news feed. - Cross-reference group standards with international equivalents using the
title_enfield fromget_standard_detail. - Track which host organizations and issuing authorities are most active in producing group standards.
| 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 | 100 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 ttbz.org.cn provide an official developer API?+
What does `get_standard_detail` return beyond what the catalog endpoints show?+
get_standard_detail adds several fields not present in the list endpoints: abstract (the standard's scope description, when available), title_en (English title, nullable), ccs_classification (the Chinese Classification of Standards path), and publication_date in YYYY-MM-DD format. The list endpoints return summary fields sufficient for browsing; get_standard_detail is needed for the full record.Are withdrawn or superseded standards accessible, or only active ones?+
get_standards returns only currently published (active) standards ordered by publication date. Withdrawn or superseded standards are not surfaced by that endpoint. get_standard_detail does include a status field, so if a standard's status changes after retrieval you will see the updated value. You can fork this API on Parse and revise it to add an endpoint that filters by other status values if that data becomes accessible.Is there a way to search standards by keyword or CCS classification code?+
get_standards and get_standards_by_organization both paginate results without filter parameters. You can fork this API on Parse and revise it to add a search or filter endpoint.Why is the organization list capped at 100 records?+
get_organizations endpoint reflects a platform-side cap: total will not exceed 100 visible organizations regardless of pagination. Each page returns up to 10 records, so the full visible set spans at most 10 pages. This is a limitation of what the platform exposes for the organization listing, not a pagination bug.