USDA Organic Integrity Scraper

Scrape the official USDA Organic INTEGRITY Database — the authoritative registry of certified organic operations worldwide. Search by operation name, certifier, product scope (Crops / Livestock / Handling / Wild Crops), certification status, state/province, or country, or look up a specific operation directly by its NOP Operation ID. Covers USDA-NOP and every recognized international equivalency program (EU, Canada, Japan, Switzerland, South Korea, Taiwan, UK). No login, no API key required.

What this actor does

• Two modes: search (filter/browse) and byOperationId (exact lookup)
• Global coverage: 35 accreditation programs — USDA-NOP plus 26 EU member states and 8 other national equivalency programs
• Rich filters: operation name, certifier, certifier client ID, contact last name, product scope, per-scope status, overall certification status, business type, state/province, country, county, ZIP/postal code, certificate number, certified-product keyword, exact product name, status effective-date range
• Full certification detail — per-scope status, effective dates, and the exact certified product listing for each of Crops, Livestock, Wild Crops, and Handling
• Certificate document link — direct link to the operation's official PDF organic certificate when the certifier publishes one
• Empty fields are omitted — an operation with no Handling certification simply has no Handling scope entry, never a placeholder

Output per operation

• program, certifierName, certifierWebsite, certifierEmail
• operationId — unique NOP Operation ID
• operationName, otherFormerNames
• clientId, contactFirstName, contactLastName
• operationStatus, statusEffectiveDate, nopAnniversaryDate
• scopes[] — one entry per certified scope: scope, status, effectiveDate, certifiedProducts, additionalCertifiedProducts, certificateNumbers
• certifiedScopes[] — convenience list of currently-certified scope names
• physicalAddress / mailingAddress — street1, street2, city, state, country, zip, county, countyCode
• physicalAddressCity, physicalAddressState, physicalAddressCountry, physicalAddressCounty — flattened for quick filtering
• phone, email, websiteUrl
• additionalInformation
• totalCertifiedAcres
• businessTypes[] — e.g. Broker, Distributor, Retail Food Establishment, Grower Group
• dataAsOfDate — when the certifier last updated this record
• certificateUrl — direct link to the operation's official PDF organic certificate (when published)
• sourceUrl — link to the operation's public record on organic.ams.usda.gov
• recordType: "operation", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search (filter/browse) or byOperationId (exact lookup)
operationName	string	Organic Valley	Free-text operation name search (mode=search)
structuredNameSearch	boolean	true	Use USDA's word-aware name matching instead of raw substring
operationIds	array	–	NOP Operation IDs to look up (mode=byOperationId, max 20)
certifierName	string	–	Filter by certifying agent name
certifierClientId	string	–	Filter by the exact Client ID the certifier assigned to the operation
contactLastName	string	–	Filter by the operation's primary contact's last name
program	string	USDA-NOP	Accreditation program (35 options — USDA, EU member states, Canada, Japan, etc.)
city / state / country / county	string	–	Physical-address location filters
zipcode	string	–	ZIP/postal code filter
certificateNumber	string	–	Exact certificate number
certifiedProductsKeyword	string	–	Keyword (substring) search across certified product listings
exactProductName	string	–	Exact certified product name match (not a substring)
scope	array	any	Crops / Handling / Livestock / Wild Crops
scopeStatus	array	any	Per-scope status (Certified / Surrendered / Suspended / Not Certified/Specified) — a finer-grained dimension than operationStatus
operationStatus	array	["Certified"]	OVERALL operation status: Certified / Surrendered / Suspended / Revoked
businessType	array	any	15 service/business-type options
statusEffectiveDateFrom / statusEffectiveDateTo	string	–	MM/DD/YYYY date range
maxItems	int	50	Hard cap on emitted records (1–20000)

Example: certified coffee handlers in Colombia

{
  "mode": "search",
  "certifiedProductsKeyword": "coffee",
  "scope": ["Handling"],
  "country": "Colombia",
  "maxItems": 100
}

Example: exact operation lookup by NOP ID

{
  "mode": "byOperationId",
  "operationIds": ["5561000796", "4920007838"]
}

Example: all certified dairies in Wisconsin

{
  "mode": "search",
  "state": "Wisconsin",
  "businessType": ["Dairy"],
  "scope": ["Livestock"]
}

Example: look up an operation by its certifier's client ID

{
  "mode": "search",
  "certifierClientId": "OT-007554"
}

Example: EU-accredited operations in France

{
  "mode": "search",
  "program": "EU France",
  "operationStatus": ["Certified"],
  "maxItems": 200
}

Use cases

• Supply chain verification — confirm a supplier's organic certification status and scope before onboarding
• Import/export compliance — check international equivalency-program coverage for cross-border organic trade
• Market research — map certified organic operations by region, product category, or certifier
• Due diligence — verify certificate validity and certifier accreditation for a specific operation
• Journalism / academic research — analyze trends in organic certification, surrenders, and revocations

FAQ

What is the data source? The USDA Organic INTEGRITY Database (organic.ams.usda.gov/integrity), the official public registry of every operation certified under the USDA National Organic Program and its recognized international equivalency arrangements.

Is this affiliated with the USDA? No. This is an independent, third-party actor built on USDA's public search tool.

Why do some operations have no certificate URL? Not all certifiers use USDA's Certificate Module. When a certifier hasn't published a digital certificate, certificateUrl is simply omitted rather than showing a broken link.

Why does an operation sometimes show no address? USDA requires at least one of physical or mailing address, but some historical or international records only populate one — the other is omitted rather than fabricated.

Should I combine certifierName/state/country/county/scope/scopeStatus/businessType with another filter? Yes, for best results. Those filters are matched against each candidate record rather than the live site's own pickers, so pairing them with operationName, certifiedProductsKeyword, or operationStatus keeps the underlying search well-scoped and returns results faster. Using any of them completely alone still works, but scans a larger sample of certified operations to find matches.

Why do businessType: ["Farm"] or businessType: ["Livestock"] never return results? USDA's own export file doesn't include a column for those two specific business types (13 of the 15 types do have one), so they can't be verified in the output. Combine a different businessType value, or omit it and check the operation's additionalInformation/certified products for farm/livestock context instead.

Why does scopeStatus: ["Not Certified/Specified"] never return results? A scope the operation was never certified for (e.g. an operation with no Livestock certification at all) has no row for that scope in USDA's export -- there's nothing to check "not certified" against. Use a different scopeStatus value, or just omit scope/scopeStatus to see every scope the operation does hold.

What's the difference between operationStatus and scopeStatus? operationStatus is the operation's one overall certification status (Certified/Surrendered/Suspended/Revoked). scopeStatus is finer-grained: an operation can be overall "Certified" while one specific scope (e.g. its Livestock certification) was independently surrendered -- scopeStatus matches on that per-scope status instead.

What's the difference between certifiedProductsKeyword and exactProductName? certifiedProductsKeyword is a substring match anywhere in an operation's certified-product listings (e.g. coffee matches "Coffee, Roasted"). exactProductName requires the certified product name to match exactly.

What's the difference between program and scope? program is the accreditation regime (which government/standard certified the operation, e.g. USDA-NOP or EU France). scope is the product category the certification covers (Crops, Livestock, Handling, or Wild Crops).

How fresh is the data? The database is updated continuously by certifiers. Each record's dataAsOfDate shows when that certifier last submitted an update.

Are there rate limits or an API key? No. The Organic INTEGRITY Database is a fully public consumer tool with no authentication.