ParseForge
US Customs CROSS Rulings Scraper
parseforge/us-customs-cross-rulings-scraper
OtherLead generation
Scrapes US Customs CROSS rulings by keyword search and returns each ruling as a flat row with full text, tariff codes, dates, and reference numbers.
- Total users
- 1
- Monthly active
- 0
- Total runs
- 97
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 9 days ago
Overview
US Customs CROSS Rulings Scraper
Scrape US Customs CROSS rulings by keyword, up to a million per run. Every ruling comes with its full text, tariff codes, dates, and reference numbers. No API key or registration. Export to CSV, JSON, Excel, or XML.
US Customs CROSS rulings determine how goods are classified and taxed at the border, but the official search tool limits how many you can view and offers no bulk export. This Actor reads the public CROSS database directly, runs your keyword search, and returns each matching ruling in a clean, flat row. Trade compliance teams, customs brokers, and import analysts use it to build their own research datasets without manual copying.
| Who uses it | What they scrape US Customs CROSS Rulings for |
|---|---|
| Customs brokers | Research past rulings on a product to support a client's entry filing. |
| Trade compliance managers | Build a private database of rulings for a specific HTS code or material. |
| Import analysts | Monitor new rulings for a competitor's product category. |
| Law firms | Gather precedent rulings for a tariff classification dispute. |
What it does
This Actor collects US Customs CROSS rulings by keyword search and returns each one as a flat row with full ruling text, tariff numbers, and metadata.
- 🔍 Keyword search: enter any term, phrase, or tariff number to find matching rulings.
- 📄 Full ruling text: the complete decision text is included in every row.
- 📊 Structured output: each ruling is a flat row with reference number, date, tariff codes, and more.
- ⚙️ Volume control: set a maximum number of rulings to collect, from one to one million.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with US Customs CROSS Rulings data
📋 Build a compliance library.
A customs broker searches for a client's product material and scrapes every matching ruling to document consistent treatment at the border.
🔎 Research a tariff code.
An import analyst enters an HTS number, collects all rulings that cite it, and identifies how Customs has interpreted the classification over time.
📈 Monitor new rulings.
A trade compliance manager runs the Actor weekly with a competitor's brand name to catch new rulings that might signal a shift in enforcement.
⚖️ Support a legal case.
A law firm scrapes rulings by product description to find precedent decisions that strengthen a client's protest or prior disclosure.
Why choose this scraper
| What you get | |
|---|---|
| No API needed | Reads the public CROSS website directly, no registration or key. |
| Bulk export | Save thousands of rulings to CSV, JSON, Excel, or XML in one run. |
| Full text | Every ruling includes its complete decision text, not a summary. |
| Tariff codes | Extracted HTS numbers let you filter and sort by classification. |
How it compares
No other Store actor targets US Customs CROSS Rulings the same way, so the honest comparison is with the alternatives teams actually weigh.
| US Customs CROSS Rulings Scraper | Build it in-house | By hand | |
|---|---|---|---|
| Setup | Run it now, zero config | Days of engineering | None, but hours per pull |
| When US Customs CROSS Rulings changes | Maintained for you | You fix it | You re-learn the page |
| Proxies, retries, anti-bot | Built in | Your problem | Browser only |
| Output | Fixed JSON schema, CSV/Excel export | Whatever you build | Copy-paste |
| Cost | Pay per result | Engineering time | Analyst hours |
Configure the run
Drive the Actor with a single keyword or tariff code, and set a cap on the total rulings collected per run. The Input tab lists every parameter.
A first run with the defaults:
{
"maxItems": 10
}
A larger pull:
{
"maxItems": 200
}
Pricing
Pay-per-result: $0.021 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $2.10 |
| 1,000 results | $21.00 |
| 10,000 results | $210.00 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the US Customs CROSS Rulings Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to US Customs CROSS Rulings through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/us-customs-cross-rulings-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results?
Your search term may be too narrow or contain special characters that the CROSS search does not handle. Try a simpler keyword, a single word, or a tariff number without punctuation.
The run stopped before reaching my maxItems limit.
The CROSS database only returns results that match your query. If fewer rulings exist for that keyword, the Actor will finish early with whatever it found. Try a broader search term.
Some rulings are missing tariff codes in the output.
Not every CROSS ruling cites an HTS number. If the original ruling text does not reference a tariff code, that field will be empty in your dataset.
The run is taking a long time.
Large maxItems values mean the Actor must paginate through many search results. Reduce the limit or narrow your keyword to speed things up.
FAQ
| Question | Answer |
|---|---|
| What is the CROSS rulings database? | CROSS is the official online repository of U.S. Customs and Border Protection rulings, containing decisions on tariff classification, valuation, origin, and other trade matters. It is publicly searchable but offers no bulk download. |
| Can I search by tariff code? | Yes. Enter an HTS number as your search query and the Actor will return rulings that reference that code. The extracted tariff fields in the output make it easy to filter further. |
| How many rulings can I scrape in one run? | You set the limit with the maxItems input. The Actor can collect up to one million rulings per run, though very large searches will take longer to complete. |
| Does this include the full ruling text? | Yes. Every row includes the complete decision text as published by CBP, along with the ruling number, date, and other metadata. |
| Do I need a CBP account or API key? | No. The Actor reads the public CROSS website directly. You do not need to register, log in, or obtain any credentials. |
| What export formats are supported? | You can export your dataset to CSV, JSON, Excel, or XML directly from Apify. The flat row structure works well with spreadsheets and databases. |
| Can I schedule this to run automatically? | Yes. Use Apify's scheduler to run the Actor daily, weekly, or on any custom interval. This is useful for monitoring new rulings as they are published. |
| What happens if my search returns no results? | The run will complete with an empty dataset. Try a broader keyword, check for typos, or remove any special characters from your query. |
Related actors
Browse the full ParseForge collection for more scrapers.
🆘 Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by U.S. Customs and Border Protection. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| maxItems | integer | Maximum number of rulings to collect per run. | 10 |
| searchQuery | string | Keyword to search CROSS rulings. | tariff |
Pricing
from $19.00 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| result | Single result in the default dataset. | $0.019 to $0.021 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~us-customs-cross-rulings-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.