POST /normalize_list • Credits: 0.5 credits per call

Normalize List takes one string, splits it into items, trims the whitespace around each item and removes the duplicates. The endpoint accepts a comma-separated string or a JSON array. It returns the original item count, the deduplicated count, the clean array and the clean joined string. Each call costs 0.5 credits.

A list that comes from a spreadsheet column, a form field or a CRM export carries stray spaces, blank cells and repeated values. Normalize List cleans that string in one call. The endpoint splits the string on the comma, trims every item, drops the empty items and keeps the first occurrence of each value. Normalize List runs inside RichAPI and calls no external provider, so the response is immediate. Use Normalize List before a bulk enrichment call, to cut the duplicate rows that you pay for twice.

The parameter names in the request body match the names in the RichAPI dashboard, the MCP tool normalize_list and the n8n operation normalize_list.

Normalize List runs a fixed sequence of operations on the input string.

Normalize List changes no letter case, and it sorts nothing. Acme.com and acme.com are two different values, and both stay in the result. The output order is the input order.

CAUTION: The comma is the only separator. A newline-separated list or a pipe-separated list returns as one item and still costs 0.5 credits. Replace the separator with a comma before you send the request.

The following worked example uses a domain column from a CRM export. The column carries stray spaces, two blank cells, one repeated domain and one domain in a different case.

Normalize List processes that request body in seven steps.

The result holds both acme.com and Acme.com, because the match in step 7 is case-sensitive. The result keeps the input order, because Normalize List sorts nothing. The messy domain list returns as this response.

Five paid enrichment calls drop to four. The deduped_string value is ready for the next endpoint that takes a comma-separated list.

Normalize List returns a synchronous JSON response with four fields. The following block is an example response for the request body {"input": "apple, Banana, apple, , cherry", "remove_empty_values": true}.

If remove_empty_values is false, Normalize List keeps the empty items and deduplicates them into a single empty string. The request body {"input": " acme.com, Acme.com ,, globex.io ,acme.com, initech.dev, ", "remove_empty_values": false} returns this response.

The empty item leaves a gap in deduped_string. For a value that you pass to another endpoint, keep remove_empty_values at the default true.

If the input string parses as a JSON array, Normalize List uses the array elements as the items and runs no comma split. A comma inside an element is then safe. Every element converts to a string, so the number 42 becomes "42". The request body {"input": "[\" Sales \", \"Sales\", \"\", 42]"} returns original_count4, deduplicated_count2 and the deduped_list value ["Sales", "42"].

CAUTION: Send input as a string, and not as a real JSON array. A real array returns 400 with the message Invalid value for input: expected string, and RichAPI charges no credit.

Normalize List costs 0.5 credits per call. At $0.02 a credit, the rate on the 1,000 and 5,000 credit packs, one call costs $0.01. Larger packs cost less per credit. The credit count does not change with the length of the list. A 2-item list and a 20,000-item list both cost 0.5 credits.

To clean 4,000 exported columns, send 4,000 calls. That costs 2,000 credits, or $40.00.

An error response holds one error field with the reason. RichAPI charges credits only for a 200 response. Every error status in the table above costs no credit.

Yes. Normalize List compares the exact string, so Acme.com and acme.com stay as two separate items in deduped_list. To merge two items that differ only in case, convert the list to one case before you send the request.

No. The comma is the only separator that Normalize List splits on. A newline-separated list or a pipe-separated list returns as a single item, so replace the separator with a comma first. A JSON array is the other accepted form of the input string.

No. Normalize List keeps the input order and returns the first occurrence of each value in that position. To sort the result, sort the deduped_list array in your own code.

The input string holds up to 1 MB. An input string above 1 MB returns a 400 response with the message about the maximum size. For a larger list, split the list into blocks and send one call per block.

Yes. Normalize List costs 0.5 credits for every 200 response, and the price does not change with the result. A call that removes 500 duplicates and a call that removes none both cost 0.5 credits.

The original_count field holds the item count after the split and before the empty removal. The count includes the empty items and the duplicates. Subtract deduplicated_count from original_count to get the number of items that Normalize List removed.