https://api.nexscope.ai/patents/searchEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/patents/search |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
q | string | obligatorio | La búsqueda de búsqueda de patentes de Google soporta sintaxis oficial avanzada de la consulta (como `owner:"Company"`, `inventor:"Name"`, operador de fecha). Máximo 1000 caracteres. |
num | integer | opcional | Número de resultados por página, rango 10–100. Ejemplo: 10 |
page | integer | opcional | Número de página, a partir de la 1. Ejemplo: 1 |
country | string | opcional | Código de país, varios valores separados por comas, por ejemplo `US,CN,WO`. |
language | string | opcional | Idioma, varios valores separados por comas inglesas, utilizar el valor de idioma oficial de Google Patents. |
before | string | opcional | Fecha máxima, formato `priority\|filing\|publication:YYYYMMDD`. |
after | string | opcional | Fecha mínima, el formato es el mismo que `before`. |
sort | string | opcional | Método de clasificación: `new` (último) o `old` (más temprano); si no se transmite, se clasifica por relevancia. |
type | string | opcional | Tipo de resultado: `PATENT` o `DESIGN`. |
status | string | opcional | Situación de la patente: `GRANT` o `APPLICATION`. |
patents | boolean | opcional | Si se deben incluir los resultados de las patentes. Ejemplo: true |
scholar | boolean | opcional | Si se deben incluir los resultados académicos de Google. Ejemplo: false |
litigation | string | opcional | Situación del litigio: `YES` o `NO`. |
inventor | string | opcional | Inventor, los valores múltiples están separados por comas. |
assignee | string | opcional | Asignado, múltiples valores separados por comas. |
clustered | boolean | opcional | Si se debe agregar por categoría; actualmente sólo se puede agregar `true`. |
dups | string | opcional | Método de deduplicación; cuando no se carga, la deduplicación se basa en la familia de patentes, `language` significa que la deduplicación se basa en texto público. |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.
Campos de respuesta
Referencia de campos de respuesta (39 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
errcode | integer | opcional | `200` indicates success. |
errmsg | string | opcional | `ok` indicates success, otherwise it is an error description. |
organicResults | array | opcional | List of patent search results. |
searchParameters | object | opcional | Echoed query parameters (`q`/`engine`/`num`/`patents`/`page`/`scholar`, etc.). |
searchInformation | object | opcional | Retrieve meta information, including `total_results` (total number of hits), `total_pages` (total number of pages), `page_number` (current page). |
searchMetadata | object | opcional | Retrieve processing metadata. |
pagination | object | opcional | Paging information (`next`, `current`). |
serpapiPagination | object | opcional | Upstream paging information. |
summary | object | opcional | Result summary (including `cpc` classification aggregation, etc., only part of it is returned during classification aggregation). |
costToken | integer | opcional | Consume token. |
message | string | opcional | Upstream prompt information; successful but may appear under special circumstances. Most successful responses do not contain this field. |
publicationNumber | string | opcional | Public account. |
patentId | string | opcional | Patent ID. |
title | string | opcional | Patent or academic result titles. |
snippet | string | opcional | Abstracts of patent or academic results. |
inventor | string | opcional | Inventor. |
assignee | string | opcional | Assignee. |
filingDate | string | opcional | Application date. |
publicationDate | string | opcional | Publication or release date. |
grantDate | string | opcional | Authorization date. |
priorityDate | string | opcional | Priority date. |
language | string | opcional | Patent language. |
cpc | string | opcional | Collaborative patent classification (returned only when classification is aggregated). |
cpcDescription | string | opcional | Description of cooperative patent classification. |
countryStatus | object | opcional | The legal status of each country. |
position | integer | opcional | Search result location. |
rank | integer | opcional | Result ranking (may differ from `position` when aggregated). |
patentLink | string | opcional | Google Patents patent link. |
pdf | string | opcional | Patent PDF link. |
thumbnail | string | opcional | Patent thumbnail. |
figures | array | opcional | Patent image list, elements containing `thumbnail`, `full`. |
scholar | boolean | opcional | Whether it is a Google Scholar result. |
scholarId | string | opcional | Scholar result ID. |
scholarLink | string | opcional | Google Scholar results link. |
author | string | opcional | Scholar result author. |
authorEtal | boolean | opcional | Whether the Scholar result contains three or more authors. |
publicationVenue | string | opcional | Scholar results publication venue. |
urlHostname | string | opcional | Scholar result source domain name. |
serpapiLink | string | opcional | Result details API link. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.