USPTO TTAB Oppositions & Cancellations Scraper (TTABVUE)

Here is one real result, with every field the actor returns:

{
  "source": "USPTO TTABVUE",
  "board": "USPTO TTAB",
  "country": "US",
  "proceedingNumber": "91234567",
  "proceedingType": "Opposition",
  "proceedingTypeCode": "OPP",
  "filingDate": "2017-05-16",
  "status": "Terminated",
  "statusDate": "2017-09-07",
  "interlocutoryAttorney": "ELIZABETH WINTER",
  "paralegalName": "MONIQUE HILL_TYSON",
  "plaintiffName": "Novecento Intellectual Property, LLC",
  "plaintiffCounselName": "JESUS SANCHELIMA",
  "plaintiffCounselFirm": "SANCHELIMA & ASSOCIATES P A",
  "plaintiffCounselEmail": "jesus@sanchelima.com",
  "plaintiffCounselPhone": "305-447-1617",
  "defendantName": "Plan Do See America, Inc.",
  "defendantCounselName": "PAUL A BOST",
  "defendantCounselFirm": "SHEPPARD MULLIN RICHTER & HAMPTON LLP",
  "defendantCounselEmail": "trademarkscc@sheppardmullin.com",
  "defendantCounselPhone": null,
  "plaintiffs": [
    {
      "role": "Plaintiff",
      "name": "Novecento Intellectual Property, LLC",
      "counselName": "JESUS SANCHELIMA",
      "firm": "SANCHELIMA & ASSOCIATES P A",
      "address": "235 SW LE JEUNE RD, MIAMI, FL 33134, UNITED STATES",
      "emails": ["jesus@sanchelima.com", "legal@sanchelima.com"],
      "primaryEmail": "jesus@sanchelima.com",
      "phone": "305-447-1617",
      "marks": [
        { "serialNumber": "76675600", "registrationNumber": "4177395", "status": "REGISTERED AND RENEWED", "mark": "NOVECENTO" }
      ]
    }
  ],
  "defendants": [
    {
      "role": "Defendant",
      "name": "Plan Do See America, Inc.",
      "counselName": "PAUL A BOST",
      "firm": "SHEPPARD MULLIN RICHTER & HAMPTON LLP",
      "address": "1901 AVENUE OF THE STARS, SUITE 1600, LOS ANGELES, CA 90067, UNITED STATES",
      "emails": ["trademarkscc@sheppardmullin.com", "PBost@sheppardmullin.com", "RWalsh@sheppardmullin.com", "MDanner@sheppardmullin.com"],
      "primaryEmail": "trademarkscc@sheppardmullin.com",
      "phone": null,
      "marks": [
        { "serialNumber": "87306702", "registrationNumber": null, "status": "ABANDONED - AFTER INTER-PARTES DECISION", "mark": "900" }
      ]
    }
  ],
  "marks": [
    { "serialNumber": "87306702", "registrationNumber": null, "status": "ABANDONED - AFTER INTER-PARTES DECISION", "mark": "900" },
    { "serialNumber": "76675600", "registrationNumber": "4177395", "status": "REGISTERED AND RENEWED", "mark": "NOVECENTO" }
  ],
  "markSerialNumbers": ["87306702", "76675600"],
  "markRegistrationNumbers": ["4177395"],
  "counselOfRecord": ["PAUL A BOST", "JESUS SANCHELIMA"],
  "contactEmails": ["trademarkscc@sheppardmullin.com", "PBost@sheppardmullin.com", "RWalsh@sheppardmullin.com", "MDanner@sheppardmullin.com", "jesus@sanchelima.com", "legal@sanchelima.com"],
  "hasCounselContact": true,
  "prosecutionHistory": [
    { "entryNumber": 13, "date": "2017-09-08", "historyText": "BD DECISION: DISMISSED W/O PREJ", "dueDate": null },
    { "entryNumber": 12, "date": "2017-09-06", "historyText": "TERMINATED", "dueDate": null },
    { "entryNumber": 3, "date": "2017-05-16", "historyText": "PENDING, INSTITUTED", "dueDate": null },
    { "entryNumber": 2, "date": "2017-05-16", "historyText": "NOTICE AND TRIAL DATES SENT; ANSWER DUE:", "dueDate": "2017-06-25" },
    { "entryNumber": 1, "date": "2017-05-16", "historyText": "FILED AND FEE", "dueDate": null }
  ],
  "prosecutionHistoryCount": 13,
  "firstFilingEntryDate": "2017-05-16",
  "lastActivityDate": "2017-09-08",
  "answerDueDate": "2017-06-25",
  "deadlines": [
    { "event": "NOTICE AND TRIAL DATES SENT; ANSWER DUE:", "dueDate": "2017-06-25" }
  ],
  "aiSummary": null,
  "aiExtract": null,
  "url": "https://ttabvue.uspto.gov/ttabvue/v?pno=91234567",
  "observedAt": "2026-08-15T03:29:26.814Z"
}

The most complete USPTO TTAB proceedings scraper available. It returns every field TTABVUE exposes for an opposition, cancellation, concurrent-use, interference or ex parte appeal, plus derived fields (counsel contacts as leads, both parties' marks with serial and registration, the full prosecution-history docket and computed deadlines), and gives you nine filters and six lookup modes to target exactly the proceedings you need.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches USPTO TTABVUE (the Trademark Trial and Appeal Board inquiry system), opens each matching proceeding page, and writes one normalized record per proceeding to the run's dataset. For every proceeding it captures both sides of the case: the plaintiff and defendant, each party's counsel of record (attorney name, firm, email and phone), and every pleaded or involved mark with its serial number, registration number, status and mark text. It also parses the full prosecution-history docket timeline, computes deadlines (including the answer due date), and normalizes all dates to YYYY-MM-DD.

You can pull specific cases by proceeding number, or search by mark keyword, party name, mark owner, a trademark serial or registration number, or the correspondent (counsel) name. Client-side filters then narrow results by proceeding type, status text and filing-date range.

Coverage is US TTAB inter-partes and ex parte proceedings only. For trademark registrations themselves (not disputes), use the USPTO Trademarks Scraper.

Quickstart

Open the actor, paste this into the input, and press Run. It returns Nike oppositions and cancellations with counsel and docket.

{
  "partyName": ["Nike, Inc."],
  "proceedingTypes": ["Opposition", "Cancellation"],
  "procStatus": "All",
  "withDetails": true,
  "maxProceedings": 10
}

To pull one exact case, use proceedingNumbers, for example { "proceedingNumbers": ["91234567"] }. Every input field is optional except that you must provide at least one lookup value (a proceeding number or one of the search fields).

Input reference

Name	Type	Required	Description	Example
proceedingNumbers	array	one lookup required	TTAB proceeding numbers to fetch directly (fastest, most exact).	["91234567"]
searchQueries	array	one lookup required	Free-text terms searched across TTABVUE (mark text and case content).	["nike"]
partyName	array	one lookup required	Search by plaintiff or defendant party name.	["Nike, Inc."]
propertyOwnerName	array	one lookup required	Search by the owner of a pleaded or involved mark.	["Apple Inc."]
serialOrRegistrationNumber	array	one lookup required	Find all proceedings involving a mark serial or registration number.	["87306702"]
correspondent	array	one lookup required	Search by correspondent (counsel of record) name or firm.	["Sheppard Mullin"]
procStatus	string	no	Search scope: All, Pending or Terminated.	"All"
proceedingTypes	array	no	Keep only these types: Opposition, Cancellation, Concurrent Use, Interference, Ex Parte Appeal.	["Opposition"]
status	array	no	Keep only proceedings whose status contains one of these terms.	["Pending"]
filingDateFrom	string	no	Keep proceedings filed on or after this date.	"2020-01-01"
filingDateTo	string	no	Keep proceedings filed on or before this date.	"2024-12-31"
withDetails	boolean	no	Attach the full prosecution-history docket timeline (default true).	true
withSummary	boolean	no	Add an AI plain-English summary of the dispute and docket (paid plans).	false
withExtract	boolean	no	Add AI structured claims, key events, motions and outcome (paid plans).	false
maxProceedings	integer	no	Max proceedings returned across all searches (free plans capped at 10).	50

Output reference

Name	Type	Description
proceedingNumber	string	TTAB proceeding number.
proceedingType	string	Opposition, Cancellation, Concurrent Use, Interference or Ex Parte Appeal.
proceedingTypeCode	string	Type code: OPP, CAN, CUP, INT, EXA.
filingDate	string	Filing date, YYYY-MM-DD.
status	string	Current status, e.g. Pending, Terminated.
statusDate	string	Date of the current status.
interlocutoryAttorney	string	Assigned Board interlocutory attorney.
paralegalName	string	Assigned Board paralegal.
plaintiffName	string	Plaintiff (opposer / petitioner) party name.
plaintiffCounselName	string	Plaintiff counsel of record name.
plaintiffCounselFirm	string	Plaintiff counsel firm.
plaintiffCounselEmail	string	Plaintiff counsel primary email.
plaintiffCounselPhone	string	Plaintiff counsel phone, when listed.
defendantName	string	Defendant (applicant / registrant) party name.
defendantCounselName	string	Defendant counsel of record name.
defendantCounselFirm	string	Defendant counsel firm.
defendantCounselEmail	string	Defendant counsel primary email.
defendantCounselPhone	string	Defendant counsel phone, when listed.
plaintiffs	array	Full plaintiff objects: name, counsel, firm, address, emails, phone, marks.
defendants	array	Full defendant objects: name, counsel, firm, address, emails, phone, marks.
marks	array	Every involved mark: serialNumber, registrationNumber, status, mark.
markSerialNumbers	array	All involved mark serial numbers.
markRegistrationNumbers	array	All involved mark registration numbers.
counselOfRecord	array	All counsel of record names across both parties.
contactEmails	array	All correspondence emails across both parties.
hasCounselContact	boolean	True when counsel contact was captured (billed as result_lead).
prosecutionHistory	array	Full docket timeline: entryNumber, date, historyText, dueDate.
prosecutionHistoryCount	integer	Number of docket entries.
firstFilingEntryDate	string	Date of the first docket entry.
lastActivityDate	string	Date of the most recent docket entry.
answerDueDate	string	Computed answer due date, when set.
deadlines	array	Docket entries that carry a due date, as { event, dueDate }.
aiSummary	string	AI summary of the proceeding (when withSummary is on).
aiExtract	object	AI structured claims, key events, motions, outcome (when withExtract is on).
url	string	Canonical TTABVUE proceeding URL.
observedAt	string	ISO timestamp when the record was captured.

Example output record

See the JSON block at the top of this page for a complete real record (Opposition No. 91234567), including both parties, counsel of record for each side, both marks with serial and registration numbers, and the prosecution-history docket.

Run via API and CLI

Start a run with the Apify API:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~uspto-ttab-proceedings-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "partyName": ["Nike, Inc."], "proceedingTypes": ["Opposition","Cancellation"], "maxProceedings": 10 }'

Or with the Apify CLI:

apify call scrapers_lat/uspto-ttab-proceedings-scraper \
  --input '{ "proceedingNumbers": ["91234567"], "withDetails": true }'

Fetch results

Read the run's dataset items:

$curl "https://api.apify.com/v2/datasets/DATASET_ID/items?clean=true&format=json&token=YOUR_TOKEN"

Use format=csv or format=xlsx for spreadsheet exports. The DATASET_ID is returned in the run response as defaultDatasetId.

Billing and limits

This actor is pay per result. Events:

Event	Price (USD)	When charged
result	0.015	Each proceeding record without a captured counsel contact.
result_lead	0.020	Each proceeding record that includes counsel contact (name, firm, email, phone).
details	0.008	When the full prosecution-history docket is attached.
ai_summary	0.012	When an AI summary is produced (paid plans, opt-in).
ai_extract	0.012	When AI structured extraction is produced (paid plans, opt-in).

Every proceeding is billed as exactly one of result or result_lead, never both. Free Apify users are capped at 10 results per run, and the paid AI add-ons are disabled for free users. The actor never charges on a failed request: if a proceeding cannot be fetched or parsed, no billable event is emitted. A spend guard stops emitting and charging once your configured maxTotalChargeUsd is reached.

FAQ and troubleshooting

Which proceedings are covered? All TTAB proceeding types on TTABVUE: oppositions (91), cancellations (92), interferences (93), concurrent-use (94) and ex parte appeals.

Do I get counsel contact details? Yes. When TTABVUE lists a correspondent, the actor captures the attorney name, firm, mailing address, emails and phone for each party. Some parties are self-represented, in which case the correspondent is the party itself.

How do I find every case involving a mark? Put the trademark serial or registration number in serialOrRegistrationNumber. The actor returns every proceeding where that mark is pleaded or involved.

Nothing came back. Confirm you provided at least one lookup value, and that your proceedingTypes, status or filing-date filters are not excluding all matches. Terminated cases require procStatus set to All or Terminated.

More scrapers at scrapers.lat

• USPTO Trademarks Scraper
• Canada CIPO Trademarks Scraper
• EUIPO Trademarks Scraper