patentgrepDocs

PatentsView-compatible

Publications

Query published patent applications, from 2001 on, with the same syntax as granted patents. Documents are identified by document_number.

POST/api/v1/publication/

Send q, f, s and o as one JSON body with POST, or as JSON-encoded query parameters with GET.

101 of 102 PatentsView fields are served; inventors.inventor_gender_code is not, because PatentsView infers gender from first names. Entity IDs such as inventor_id are our own. All differences

Try itDemo key
POST /api/v1/publication/
Response200Recorded 11 Oct 2026
{
  "error": false,
  "count": 2,
  "total_hits": 2108,
  "publications": [
    {
      "document_number": "20260312183",
      "publication_title": "A SOLID ELECTROLYTE BATTERY AND A MANUFACTURING METHOD THEREOF",
      "publication_date": "2026-10-08"
    },
    {
      "document_number": "20260312128",
      "publication_title": "SOLID ELECTROLYTE, SOLID ELECTROLYTE LAYER, AND SOLID ELECTROLYTE BATT…",
      "publication_date": "2026-10-08"
    }
  ]
}

Request body

qobjectRequired

The query. A field and value matches exactly; combine clauses with _and, _or and _not. Dates use YYYY-MM-DD.

farray of stringsDefault: the endpoint's default fields

Fields to return. Name a group such as assignees to get all of its fields, or one field such as assignees.assignee_organization.

sarray of objects

Sort order, for example [{"patent_date": "desc"}]. Only sortable fields are allowed; end with a unique field to keep paging stable.

oobject
sizeRows per page. Default 100, up to 1,000. 0 returns only the count.afterCursor: the last row's sort values, in sort order.offsetSkip rows. Don't combine with after.

Operators and cursor paging work as on Patents.

curl https://api.patentgrep.com/api/v1/publication/ \
  -H "X-Api-Key: $PATENTGREP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": {
      "_text_phrase": {"publication_title": "solid electrolyte"}
    },
    "f": [
      "document_number",
      "publication_title",
      "publication_date"
    ],
    "s": [
      {"publication_date": "desc"},
      {"document_number": "desc"}
    ],
    "o": {"size": 2}
  }'

/api/v1/publication/

POST/api/v1/publication/

Rows come back in publications. Without f you get document_number, publication_title, publication_date. One record by id: GET /api/v1/publication/{document_number}/.

102 fields
FieldTypeSortDescription
document_numberstringYesUnique identifier for the pre-grant publication.
publication_titlestringNoTitle of the publication.
publication_abstractstringNoAbstract text of the publication.
publication_datedateYesDate when the publication was made available.
publication_yearintegerYesYear when the publication was made available.
publication_typestringNoType or category of the publication (e.g., journal, conference).
series_codeintegerNoApplication series; "D" for some designs; (http://www.uspto.gov/web/offices/ac/ido/oeip/taf/filingyr.htm)
rule_47_flagbooleanNoFlag for the inventor who was unable to be contacted at the time of filing.
assignees.assignee_idstringNoUnique identifier for the assignee.
assignees.assignee_organizationstringNoOrganization name if assignee is an organization.
assignees.assignee_individual_name_firststringNoFirst name, if assignee is an individual.
assignees.assignee_individual_name_laststringNoLast name, if assignee is an individual.
curl https://api.patentgrep.com/api/v1/publication/ \
  -H "X-Api-Key: $PATENTGREP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": {"document_number": "20180123164"},
    "f": [
      "document_number",
      "publication_title",
      "publication_date"
    ],
    "s": [{"document_number": "asc"}],
    "o": {"size": 25}
  }'