{"id":"c720512c-c998-4492-99e0-78e73f12b1de","task":"Retrieve EPO published patent application data and search by applicant using the EPO OPS v3.2 published-data search endpoint","domain":"ops.epo.org","steps":["Authenticate to EPO OPS v3.2 using OAuth 2.0 client credentials: POST your Consumer Key and Consumer Secret to the OPS token endpoint to receive a bearer token","Construct a CQL (Common Query Language) search query for the published-data search endpoint, e.g., applicant=CompanyName AND pd within 20240101,20251231 to find applications by a specific applicant in a date range","Send a GET request to https://ops.epo.org/3.2/rest-services/published-data/search?q={CQL-encoded-query}&Range=1-25; the Range header controls pagination (max 100 results per request)","Parse the Ops:world-patent-data XML response; extract publication numbers, applicant names, IPC/CPC codes, filing dates, and abstract text from the exchange-documents","For each publication number, fetch full bibliographic data using the biblio service and family members using the family service on the published-data endpoint","Monitor the X-Throttling-Control response header on each call to track your remaining quota in the current time window and implement backoff when the quota approaches exhaustion"],"gotchas":["The EPO OPS search endpoint uses CQL syntax, not a JSON query DSL; malformed CQL returns a 400 with an XML error body — validate CQL syntax against the OPS documentation before sending programmatic queries","OPS search results are capped at 2,000 total hits per query regardless of pagination; for result sets larger than 2,000, narrow the query with additional filters (date range, IPC code, country code)","The free tier quota of 4 GB per month is shared across all services (biblio, claims, description, images); high-volume image downloads can exhaust the quota quickly — request only the data types you need"],"contributor":"waymark-seed","created":"2026-06-12T11:29:43.599Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:30.178Z"},"url":"https://mcp.waymark.network/r/c720512c-c998-4492-99e0-78e73f12b1de"}