{ "openapi": "3.0.1", "info": { "title": "CNIPA China Patent Search — IP & Innovation Tracker", "description": "Search CNIPA Chinese patents by keyword (EN/ZH), applicant, IPC, date, status. Returns invention/utility/design patents with bilingual title+abstract, applicants, inventors, IPC, dates, family size, citations. IP attorneys, R&D, China competitive intel. PatSnap alt.", "version": "0.0", "x-build-id": "AcFlYtXAEDdg6FzCe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~cnipa-china-patent-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-cnipa-china-patent-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nexgendata~cnipa-china-patent-search/runs": { "post": { "operationId": "runs-sync-nexgendata-cnipa-china-patent-search", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nexgendata~cnipa-china-patent-search/run-sync": { "post": { "operationId": "run-sync-nexgendata-cnipa-china-patent-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "query": { "title": "Keyword search (English or Chinese)", "type": "string", "description": "Free-text keyword search across patent title + abstract. Accepts English OR Chinese (mixed allowed). Examples: 'lithium battery', '锂电池', 'solid state drive', 'gene editing', '半导体'. Patents.google.com indexes CNIPA records in BOTH English machine-translated title/abstract and the original Chinese, so an English keyword still matches a Chinese patent. Leave blank to pull all patents in the date window narrowed by applicant / IPC / status.", "default": "" }, "applicant": { "title": "Applicant / assignee filter (optional)", "type": "string", "description": "Restrict results to a specific Chinese applicant (company, university, institute). Accepts partial English or Chinese name (case-insensitive). Examples: 'Huawei', 'BYD', 'CATL', '宁德时代', 'Tsinghua University', '清华大学', 'CAS' (Chinese Academy of Sciences). Especially useful for monitoring a single Chinese competitor's filing cadence or running a Chinese deep-tech portfolio inventory for M&A diligence.", "default": "" }, "inventor": { "title": "Inventor filter (optional)", "type": "string", "description": "Restrict results to patents naming a specific inventor. Accepts English or Chinese name. Examples: 'Robin Li', '李彦宏', 'Jack Ma'. Useful for following a known prolific researcher across employer changes (common in Chinese hardware / AI labs).", "default": "" }, "ipc_class": { "title": "IPC class filter (optional)", "type": "string", "description": "International Patent Classification (IPC) symbol — the global standard used by CNIPA, USPTO, EPO and WIPO. Use the section letter (e.g. 'H' = Electricity), the 4-character class (e.g. 'H01M' = batteries, 'G06N' = AI/ML, 'C12N' = micro-organisms / genetic engineering), or a full subgroup (e.g. 'H01M10/0525' = lithium secondary cells). See cpc-tooltip below. Leave blank for any class.", "default": "" }, "date_range": { "title": "Date range (filing-date window)", "enum": [ "month", "quarter", "year", "3year", "all" ], "type": "string", "description": "Filter by filing date at CNIPA. 'month' = trailing 30 days; 'quarter' = trailing 90 days; 'year' = trailing 365 days; '3year' = trailing 3 years (most common for competitive intel — long enough to catch quarterly cadence, short enough to filter noise); 'all' = no date filter (search the full CNIPA index back to 1985).", "default": "year" }, "status": { "title": "Patent status filter", "enum": [ "all", "pending", "granted", "expired", "abandoned" ], "type": "string", "description": "CNIPA patent lifecycle status. 'all' = no status filter (default). 'pending' = filed but not yet granted (the public application is published 18 months after filing). 'granted' = currently in force, fees paid. 'expired' = exclusive term ended (20 years for invention, 10 years for utility model and design from filing date). 'abandoned' = applicant let lapse before grant or before annuity payment. Note: the status field as exposed by Google Patents reflects the most recent legal-status event we can extract; for litigation-grade verification consult the CNIPA portal directly.", "default": "all" }, "patent_type": { "title": "Patent type filter", "enum": [ "all", "invention", "utility", "design" ], "type": "string", "description": "CNIPA recognises THREE distinct patent types: invention (highest bar, 20-year term, substantive examination), utility model (10-year term, only formal examination, lower bar but faster grant), and design (10-year term, covers shape / pattern / colour). Filter by type to focus your search. 'invention' filters to records with publication suffix A/B (e.g. CN101...A); 'utility' filters to U (CN20...U); 'design' filters to S (CN30...S); 'all' returns everything.", "default": "all" }, "translate_titles": { "title": "Translate Chinese-only titles to English", "type": "boolean", "description": "If true, when a patent has only a Chinese title (no machine-translated English title indexed by Google Patents), we'll fetch a best-effort English rendering via Google Translate's public web endpoint. Adds ~0.3s per untranslated record. Recommended for Anglophone IP teams, M&A diligence and competitive intelligence dashboards. Disable for raw Chinese-only output (cheaper and faster, useful for downstream native-Chinese tooling).", "default": true }, "maxResults": { "title": "Max patent records to return", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of CNIPA patent records to push to the dataset. Each result page returns up to 100 patents; we auto-paginate to satisfy your limit. Typical competitive-intel workflows pull 50-500 per refresh. For a full CN-portfolio inventory of a single applicant set to 1000+. Hard ceiling 5000.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }