lookup_brand
Look up a brand
Look up one brand, store or company by name: its cited parent company, ownership type, source links and,
for scored brands, a Shoptegrity composite score (an opinion). Use it for a single known name. Fields without a
cited source come back null and are listed as withheld. A name Shoptegrity does not have returns an error that
is not a negative finding about the company.
輸入參數name必填
find_alternatives
Find approved alternatives
List alternatives for one brand that a Shoptegrity editor approved and that have a cited basis. Returns
an empty list, with a note, when none are approved yet; browse_alternatives lists cited employee-owned,
cooperative and independent options by category instead. Alternatives are not ranked by commission.
輸入參數brand_name必填
browse_alternatives
Browse cited alternatives
Alternatives to mainstream shopping that have a cited basis: employee-owned, cooperative, credit union,
B Corp or family-owned sellers. structure filters by kind (for example 'employee-owned', 'cooperative',
'credit union', 'b corp'); query filters by words in the name or the category it substitutes for
(for example 'grocery' or 'hardware'). Each result carries the source that backs it. Not ranked by commission.
輸入參數limitquerystructure
find_local_businesses
Find local businesses
Local businesses near a US ZIP code or a town and state, such as '55401' or 'Duluth, MN': Shoptegrity's
directory (co-ops, markets, credit unions; pilot areas) plus independent shops anywhere in the US (books,
gifts, toys, food, markets, grocery, hardware, clothing, secondhand, outdoors, home, music), for Small
Business Saturday or any local shopping. category narrows either list; radius_km is 0.1 to 500 (default 25;
shops are searched within 15). Chains and franchises are left out. Not ranked by commission.
輸入參數categorylocation必填radius_km
search_top_brands
Search brand integrity database
Search the scored-brand table by name, category and minimum grade, and return a short summary per brand
(parent company, shareholder payout, grade and ratings where published). Use it to browse; use lookup_brand
for one known name. An empty result means no match, not a negative finding.
輸入參數limitquerycategorymin_grade
lookup_brand_integrity
Brand integrity details
In-depth cited metrics for one brand: the split of revenue among workers, executives and shareholders,
labor records, and waste, plus SEC filing figures where they exist. Every field without a cited source is
null and listed under withheld_claims. Grades and ratings are Shoptegrity opinions.
輸入參數brand_name必填
rate_major_retailers
Rate major retailers
Scorecards for the major retailers Shoptegrity covers (Walmart, Target, Costco, Amazon, Kroger, Dollar General,
The Home Depot, WinCo Foods, Ace Hardware): parent company, revenue, net income and shareholder payouts from SEC
filings, and ratings or swaps only where an editor approved them. Takes no arguments. Missing values are null (withheld).
無需輸入參數。
get_retailer_swaps
Retailer swaps
One major retailer's cited financial figures and any editor-approved swap. Takes a retailer name such as
Walmart or The Home Depot. The swap fields are null until a swap has been approved and cited; the error lists
the retailers available.
輸入參數retailer_name必填
check_seller
Check a seller
Shoptegrity's cited ownership signals for a seller or brand name, or a plain statement that it has none
(not a negative finding). Same data as lookup_brand, phrased for a seller you are about to buy from.
輸入參數name必填
responsible_alternatives
Find independent sellers and gifts
Search independent sellers for a product or gift idea, with today's price, a check against recorded
price history, and any Shoptegrity standing, for gift ideas and holiday shopping. max_price is in USD.
輸入參數limitproduct必填max_price
check_deal
Check a deal against price history
Judge a sale price against Shoptegrity's recorded daily price history for a Shopify catalog product.
Flags 'raised_then_lowered' when a price was pushed up before a sale. Works for Black Friday and
Cyber Monday deals. product_id comes from responsible_alternatives.
輸入參數product_id必填current_price
holiday_shopping_guide
Holiday shopping guide
A plan for shopping with integrity on Black Friday, Small Business Saturday, Cyber Monday,
Giving Tuesday or for holiday gifts: the date, days left, and which Shoptegrity tools to use at each step.
occasion is black_friday, small_business_saturday, cyber_monday, giving_tuesday, christmas, or 'next'
for the next one coming up. today is an ISO date and defaults to the server's date. For Black Friday,
Cyber Monday and holiday gifts it also returns links to large retailers' own weekly-ad and deals pages.
輸入參數todayoccasion
check_cart
Check a shopping list
Check a shopping or gift list: for each item, which scored company it belongs to (if any), the cited
facts Shoptegrity holds (parent, filings, shareholder payouts) and what is withheld. Items can be products,
brands or stores, such as 'AirPods', 'Tide pods' or 'Walmart'. Up to 50 items.
輸入參數items必填
verified_deals
Verified price drops
Products from independent Shopify sellers whose price Shoptegrity recorded dropping below its usual level.
Shows real drops rather than headline discounts, for Black Friday and Cyber Monday. A drop counts only
with at least 7 earlier days of recorded prices; prices raised before a sale never qualify. min_percent_off
is 1-90. query filters by words in the title or seller. max_per_seller (default 3) keeps one seller's sale
from filling the list. Largest drop first, never ordered by commission.
輸入參數limitquerymax_per_sellermin_percent_off