Skip to main content

· One min read

New fields in Publications Endpoint

The following fields have been added to the publications endpoint:

  • "us-parties" sub-entity with sub-fields:
    • us_party_type
    • us_party_designation
    • location_id
    • us_party_name_first
    • us_party_name_last
    • us_party_organization
    • us_party_sequence
    • applicant_authority
  • cpc_at_issue.action_date
  • foreign_priority.priority_claim_sequence
  • granted_pregrant_crosswalk.current_patent_id_flag
  • granted_pregrant_crosswalk.current_pgpub_id_flag
  • ipcr.ipc_class_level
  • ipcr.ipc_class_status
  • pct_data.filed country
  • us_related_documents.related_doc_sequence
  • wipo.wipo_sector_title

Fields re-named

The following fields in the publications endpoint have had their names changed for consistency with other PatentsView Data:

  • pct_data.pct_371c124_date -> pct_data.pct_371_date
  • pct_data.pct_371c12_date -> pct_data.pct_102_date

Bug fixes

  • a bug preventing the correct functionality of the "Try it out" feature on the /api/v1/inventor/{inventor_id}/ and /api/v1/location/{location_id}/ endpoints has been fixed.

· One min read

Long text data notes

  • The Search API now contains four new endpoints for long text data: brf_sum_text, claims, draw_desc_text and detail_desc text.
  • These endpoints are currently in beta phase. i.e. please expect the structure and dataset included to change over the next few releases
    • Currently, only 2023 data is available. Over the next few release, we'd be backfilling older data few years at a time. You can track the status on this page
  • Please see endpoint reference

· 2 min read

Data update: 02/13/2024

The Search API is updated to contain data through 12/31/2023.

Publication Endpoints

Two new endpoints have been added.

  • /api/v1/publication : containting pregrant publication data
  • /api/v1/publication/rel_app_text: containing related application data for pregrant publications

See Search API Reference for field list reference

Documentation and User Resources

The API Development team has developed a few resources for better communicating changes and updates relating to the Search API to users:

  • Search API Reference contains the full Search API specification. This supersedes any information on the previous version
  • A "service" status page to keep users informed of the status of various tools
  • This page where updates to the Search API will be shared with users.

The users are, of course, always welcome to reach out via the PatentsView Help Center

Bug Fixes

_contains operator

Previously, the "_contains" operator

  • resulted in 500 server error if a list is supplied as the value.
  • produced incorrect results when the supplied value contained whitespaces.

This has been fixed and as a result of the fix the "contains" operator will now:

  • correctly account for spaces in the operator argument
  • permit lists as arguments (listed arguments will use "or" logic)

Other developer notes

  • What's with v2.0?

    • Internally, the PatentsView team referred to the release that included pre-grant publications as v2.0 and the name stuck.
  • Does that mean the url will change?

    • No. We intend to keep the /api/v1 part of the API endpoint URLs as it stands.
  • What is happening with text data?

    • Because of its size, the long text data posed some challenges when integrating with the Search API. We are working to resolve those issues, and expect that text data will be available via the Search API within the next few releases.

· One min read

Note: The below endpoints are made active without complete data. They are included in the documentation in the interest of providing complete list of data elements that will available soon. The status will be updated as when the data load for the endpoint becomes complete.

  • Brief Summary Text (Data Load in progress)
  • Claims (Data Load in progress)
  • Detail Description Text (Data Load in progress)
  • Drawing Description Text (Data Load in progress)