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` indica éxito. |
errmsg | string | opcional | `ok` indica éxito, de lo contrario es una descripción de error. |
organicResults | array | opcional | Lista de resultados de búsqueda de patentes. |
searchParameters | object | opcional | Parámetros de consulta ecosados (`q`/`engine`/`num`/`patents`/`page`/`scholar`, etc.). |
searchInformation | object | opcional | Recuperar meta información, incluyendo `total_results` (número total de visitas), `total_pages` (número total de páginas), `page_number` (página actual). |
searchMetadata | object | opcional | Recuperar metadatos de procesamiento. |
pagination | object | opcional | Información de llamada (`next`, `current`). |
serpapiPagination | object | opcional | Arriba la información de búsqueda. |
summary | object | opcional | Resumen de los resultados (incluidos los resultados `cpc` la agregación de clasificación, etc., sólo una parte de ella se devuelve durante la agregación de clasificación). |
costToken | integer | opcional | Consumir token. |
message | string | opcional | Subir información rápida; exitosa pero puede aparecer bajo circunstancias especiales. La mayoría de las respuestas exitosas no contienen este campo. |
publicationNumber | string | opcional | Cuenta pública. |
patentId | string | opcional | Identificación de patente. |
title | string | opcional | Patentes o títulos de resultados académicos. |
snippet | string | opcional | Resumen de los resultados académicos o de patentes. |
inventor | string | opcional | Inventor. |
assignee | string | opcional | Asignado. |
filingDate | string | opcional | Fecha de aplicación. |
publicationDate | string | opcional | Fecha de publicación o publicación. |
grantDate | string | opcional | Fecha de autorización. |
priorityDate | string | opcional | Fecha de prioridad. |
language | string | opcional | Lenguaje de patente. |
cpc | string | opcional | Clasificación colaborativa de patentes (devuelta sólo cuando la clasificación se agrega). |
cpcDescription | string | opcional | Descripción de la clasificación de las patentes cooperativas. |
countryStatus | object | opcional | La condición jurídica de cada país. |
position | integer | opcional | Ubicación del resultado de la búsqueda. |
rank | integer | opcional | Clasificación de resultados (puede diferir de la `position` cuando se añadan). |
patentLink | string | opcional | Enlace de patente de Google Patents. |
pdf | string | opcional | Enlace PDF de patentes. |
thumbnail | string | opcional | La miniatura de la patente. |
figures | array | opcional | Lista de imágenes de patentes, elementos que contienen `thumbnail`, `full`. |
scholar | boolean | opcional | Si es un resultado de Google Scholar. |
scholarId | string | opcional | ID de resultados académicos. |
scholarLink | string | opcional | Enlace de resultados de Google Scholar. |
author | string | opcional | Autor de resultados académicos. |
authorEtal | boolean | opcional | Si el resultado académico contiene tres o más autores. |
publicationVenue | string | opcional | Lugar de publicación de resultados académicos. |
urlHostname | string | opcional | Nombre de dominio de origen de resultados académicos. |
serpapiLink | string | opcional | Detalles del resultado 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 la ausencia de una clave API (code 11209), 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.