Get Profile Patents by URL

GEThttps://api.envoapi.com/v1/profiles/patents/by-url

Retrieve one page of patents listed on a profile by URL, including available titles, descriptions, application numbers and patent URLs. Use start and count to select a page, then meta.paging.nextStart to continue. Unavailable fields are null.

Authorization headerReturns application/json

GET/v1/profiles/patents/by-url

curl "https://api.envoapi.com/v1/profiles/patents/by-url?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fadamcheyer%2F" \--header "Authorization: Bearer $ENVO_API_KEY" \--header "Accept: application/json"

const response = await fetch("https://api.envoapi.com/v1/profiles/patents/by-url?url=https%3A%2F%2Fwww.linkedin.com%2Fin%2Fadamcheyer%2F",{headers: {Authorization: `Bearer ${process.env.ENVO_API_KEY}`,Accept: "application/json",},},);const body = await response.json();

import osimport requestsresponse = requests.get("https://api.envoapi.com/v1/profiles/patents/by-url",params={"url": "https://www.linkedin.com/in/adamcheyer/"},headers={"Authorization": f"Bearer {os.environ['ENVO_API_KEY']}","Accept": "application/json",},)body = response.json()

application/json · 2.7 KB

One page of the profile's patents, with paging metadata. Missing source values remain null.

{"data": {1 field},"patents": [3 items]{10 fields},"title": "Software-based Architecture For Communication and Cooperation Among Distributed Electronic Agents","patentNumber": "6,851,115","applicationNumber": null,"description": "A highly flexible, software-based architecture is disclosed for constructing distributed systems. The architecture supports cooperative task completion by flexible and autonomous electronic agents. One or more facilitators are used to broker communication and cooperation among the agents. The architecture provides for the construction of arbitrarily complex goals by users and service-requesting agents. Additional features include agent-based provision of multi modal interfaces, including natural language.","url": "http://www.google.com/patents/US6851115","issuer": "US","pending": false,"filedOn": null,"issuedOn": {3 fields},"year": 2005,"month": 2,"day": 1},"inventors": null},{10 fields},"title": "Mobile navigation of network-based electronic information using spoken input","patentNumber": "6,757,718","applicationNumber": null,"description": "A system, method, and article of manufacture are provided for navigating an electronic data source by means of spoken language where a portion of the data link between a mobile information appliance of the user and the data source utilizes wireless communication. When a spoken input request is received from a user who is using the mobile information appliance, it is interpreted. The resulting interpretation of the request is thereupon used to automatically construct an operational navigation query to retrieve the desired information from one or more electronic network data sources, which is transmitted to the mobile information appliance.","url": "http://www.google.com/patents/US6757718","issuer": "US","pending": false,"filedOn": null,"issuedOn": {3 fields},"year": 2004,"month": 6,"day": 29},"inventors": null},{10 fields}"title": "Intelligent Automated Assistant","patentNumber": null,"applicationNumber": "US2012/0016678","description": "An intelligent automated assistant system engages with the user in an integrated conversational manner using natural language dialog and invokes external services when appropriate to obtain information or perform various actions The system can be implemented using any of a number of different platforms such as the web email smartphone and the like or any combination thereof In one embodiment the system is based on sets of interrelated domains and tasks and employs additional functionally powered by external services with which the system can interact.","url": "http://www.google.com/patents/US20120016678","issuer": "US","pending": true,"filedOn": {3 fields},"year": 2012,"month": 1,"day": 19},"issuedOn": null,"inventors": null}]},"meta": {2 fields}"creditCost": 1,"paging": {6 fields}"start": 0,"count": 20,"returned": 3,"total": 3,"hasMore": false,"nextStart": null}}}

invalid_requestA parameter is missing or has a value we cannot use. Read error.details, fix the value and try again. Errors guide →

{"error": {4 fields},"code": "invalid_request","message": "A request parameter is missing or invalid.","retryable": false,"details": []},"meta": {1 field}"requestId": "example"}}

invalid_api_keyYour API key is missing, wrong or switched off. Check it in your dashboard. Errors guide →

{"error": {4 fields},"code": "invalid_api_key","message": "Your API key is invalid or inactive.","retryable": false,"details": []},"meta": {1 field}"requestId": "example"}}

insufficient_creditsYour account has no credits left. Top up, then send a new call. Errors guide →

{"error": {4 fields},"code": "insufficient_credits","message": "Your account does not have enough credits.","retryable": false,"details": []},"meta": {1 field}"requestId": "example"}}

resource_not_foundNothing matched what you sent. Check it for typos. Errors guide →

{"error": {4 fields},"code": "resource_not_found","message": "The requested resource was not found.","retryable": false,"details": []},"meta": {1 field}"requestId": "example"}}

rate_limit_exceededToo many calls in a short time. Honor Retry-After; use bounded retries with backoff and jitter. Errors guide →

{"error": {4 fields},"code": "rate_limit_exceeded","message": "Your account has sent too many requests.","retryable": true,"details": []},"meta": {1 field}"requestId": "example"}}

GET

/v1/profiles/patents/by-url

Authorizations

BearerApiKey

Parameters

Query Parameters

url

required

string format: uri

>= 1 characters <= 2048 characters

The full profile URL. The username in its /in/ path selects the profile.

Example

https://www.linkedin.com/in/adamcheyer/

start

Zero-based patent offset. Use meta.paging.nextStart for the next page.

integer

0 <= 9007199254740891

Example

count

Patents per page (1–100). Defaults to 20. Each page is a separate lookup.

integer

default: 20 >= 1 <= 100

Example

Responses

200

One page of the profile's patents, with paging metadata. Missing source values remain null.

application/json

object

data

required

object

patents

required

Array<object>

object

title

required

Any of:

string
null

string

0 <= 1024 characters

patentNumber

required

Any of:

string
null

string

0 <= 256 characters

applicationNumber

required

Any of:

string
null

string

0 <= 256 characters

description

required

Any of:

string
null

string

0 <= 16384 characters

url

required

Any of:

string
null

string

0 <= 8192 characters

issuer

required

Any of:

string
null

string

0 <= 1024 characters

pending

required

Any of:

boolean
null

boolean

filedOn

required

Any of:

object
null

Any of:

object
object

object

year

required

integer

>= 1 <= 9999

month

required

Any of:

integer
null

integer

>= 1 <= 12

day

required

null

issuedOn

required

Any of:

object
null

Any of:

object
object

object

year

required

integer

>= 1 <= 9999

month

required

Any of:

integer
null

integer

>= 1 <= 12

day

required

null

inventors

required

Any of:

Array<object>
null

Array<object>

object

name

required

Any of:

string
null

string

0 <= 1024 characters

meta

required

object

creditCost

required

integer

<= 9007199254740991

paging

Page details. May be absent from results created before pagination was introduced.

object

start

required

integer

<= 9007199254740891

count

required

integer

>= 1 <= 100

returned

required

integer

<= 100

total

required

integer

<= 9007199254740991

hasMore

required

boolean

nextStart

required

Any of:

integer
null

integer

> 0 <= 9007199254740991

Headers

Date

string

/^(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun), (?:0[1-9]|[12][0-9]|3[01]) (?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) [0-9]{4} (?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9] GMT$/

Required response header.

Cache-Control

string

Allowed value: private, no-store

Required response header.

X-Request-Id

string

>= 1 characters <= 64 characters /^[\x21-\x7e](?:[\x20-\x7e]*[\x21-\x7e])?$/

Required response header.

X-Credits-Remaining

integer

<= 9007199254740991

Required response header.

X-RateLimit-Limit

integer

<= 9007199254740991

Required response header.

X-RateLimit-Remaining

integer

<= 9007199254740991

Required response header.

X-RateLimit-Reset

integer

<= 9007199254740991

Required response header.

Errors

Every error returns the same body. The status and error.code tell you what went wrong. The Errors guide covers handling and retries.

Body

application/json

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_api_key insufficient_credits insufficient_scope account_suspended resource_not_found method_not_allowed not_acceptable unsupported_media_type rate_limit_exceeded internal_error response_too_large upstream_error service_unavailable upstream_timeout

message

required

string

>= 1 characters <= 512 characters

retryable

required

boolean

details

required

Array<object>

<= 16 items

object

field

required

string

>= 1 characters <= 128 characters /^[\x21-\x7e](?:[\x20-\x7e]*[\x21-\x7e])?$/

code

required

string

Allowed values: identifier_count unknown_parameter repeated_parameter invalid_format invalid_value too_long

message

required

string

>= 1 characters <= 512 characters

meta

required

object

requestId

required

string

>= 1 characters <= 64 characters /^[\x21-\x7e](?:[\x20-\x7e]*[\x21-\x7e])?$/

Headers

Date

string

/^(?:Mon|Tue|Wed|Thu|Fri|Sat|Sun), (?:0[1-9]|[12][0-9]|3[01]) (?:Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) [0-9]{4} (?:[01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9] GMT$/

Required response header.

Cache-Control

string

Allowed value: private, no-store

Required response header.

X-Request-Id

string

>= 1 characters <= 64 characters /^[\x21-\x7e](?:[\x20-\x7e]*[\x21-\x7e])?$/

Required response header.

Status	`error.code`	Meaning
400	`invalid_request`	A parameter is missing or has a value we cannot use. Read error.details, fix the value and try again.
401	`invalid_api_key`	Your API key is missing, wrong or switched off. Check it in your dashboard.
402	`insufficient_credits`	Your account has no credits left. Top up, then send a new call. Also sends `X-Credits-Remaining`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.
403	`insufficient_scope`, `account_suspended`	Your account is suspended or cannot use this endpoint. Resolve the account or its access first.
404	`resource_not_found`	Nothing matched what you sent. Check it for typos. Also sends `X-Credits-Remaining`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.
405	`method_not_allowed`	The route exists, but the request used a method other than GET. Use the method shown at the top of this page. Also sends `Allow`.
406	`not_acceptable`	The Accept header asks for a format we do not send. Ask for JSON with a supported Accept value.
415	`unsupported_media_type`	The request declared a media type we do not accept. Remove the body or use the documented media type.
429	`rate_limit_exceeded`	Too many calls in a short time. Honor Retry-After; use bounded retries with backoff and jitter. Also sends `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`, `Retry-After`.
500	`internal_error`, `response_too_large`	Something failed on our side. Retry only when error.retryable is true. Also sends `X-Credits-Remaining`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.
502	`upstream_error`	A data source sent back something we could not use. Retry with bounded backoff. Also sends `X-Credits-Remaining`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.
503	`service_unavailable`	Lookups are unavailable for a moment. Follow error.retryable, and Retry-After when it is present. Also sends `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`, `X-Credits-Remaining`.
504	`upstream_timeout`	The lookup ran out of time. Retry with bounded backoff. Also sends `X-Credits-Remaining`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`.