{"components":{"schemas":{"Error":{"properties":{"error":{"description":"Machine-readable code, e.g. invalid_input, sign_in_required, insufficient_credits, key_limit, rate_limited","type":"string"},"message":{"type":"string"}},"required":["error","message"],"type":"object"},"ToolResult":{"properties":{"data":{"additionalProperties":true,"description":"Structured answer (same fields as the MCP tool)","type":"object"},"summary":{"description":"One line a person can read","type":"string"},"tool":{"type":"string"}},"required":["tool","summary","data"],"type":"object"}},"securitySchemes":{"bearer":{"description":"A TradeGraph API key (tg_live_…)","scheme":"bearer","type":"http"}}},"info":{"description":"Export go-to-market data for consumer goods (where to sell, who replies, how to follow up, channels, compliance, pricing) and live data on prepaid credits. The same tools as the MCP server at https://tradegraph.rinda.ai/mcp. Free tools work without a key; get a key at https://tradegraph.rinda.ai/account/keys (free sign-up, $1.00 credit when you sign up with Google).","title":"TradeGraph API","version":"1.7.0"},"openapi":"3.1.0","paths":{"/api/v1/account":{"get":{"operationId":"get_account","responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Account summary"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing or invalid"}},"security":[{"bearer":[]}],"summary":"Credit balance and this month's spend","tags":["account"],"x-openai-isConsequential":false}},"/api/v1/tools/account":{"post":{"description":"Free; needs an API key. Shows the signed-in TradeGraph account: prepaid credit balance, this month's spend (whole account and this key), the key's monthly limit, and links to top up credits or manage keys. Free. Call it before a batch of live_call runs to check the budget.","operationId":"account","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{},"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{"bearer":[]}],"summary":"My TradeGraph account: credits and usage","tags":["account"],"x-openai-isConsequential":false}},"/api/v1/tools/add_buyers":{"post":{"description":"Free; needs an API key. Adds companies the user (or you) found outside the map searches to this account's saved buyer list for a plan: a trade-fair exhibitor list (gtm_plan buyer_sources), a trade directory, a BuyKOREA or KOTRA buyer inquiry, a distributor list from a partner.","operationId":"add_buyers","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country":{"description":"Market, ISO alpha-2 (e.g. 'DE').","type":"string"},"item":{"description":"Product name or HS code, as in gtm_plan.","type":"string"},"product":{"description":"Optional. The product name used in the emails (gtm_plan product).","type":"string"},"rows":{"description":"The companies, at most 500 per call.","items":{"additionalProperties":false,"properties":{"booth":{"description":"The stand or booth number on a trade-fair exhibitor list (shown next to the list name in the buyer tracker).","type":"string"},"city":{"description":"City.","type":"string"},"contact":{"description":"A person at the company, if the list names one.","type":"string"},"email":{"description":"An email the list gives (kept as given; not verified).","type":"string"},"name":{"description":"Company name.","type":"string"},"phone":{"description":"Phone.","type":"string"},"title":{"description":"That person's job title.","type":"string"},"website":{"description":"Company website (domain or URL).","type":"string"}},"required":["name"],"type":"object"},"maxItems":500,"type":"array"},"source":{"description":"Where the list comes from, e.g. 'MEDICA 2026 exhibitors' or 'BuyKOREA inquiry'.","type":"string"},"type":{"description":"The buyer type of these companies (default: this week's type).","enum":["distributor","wholesaler","importer","retailer"],"type":"string"}},"required":["item","country","rows"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{"bearer":[]}],"summary":"Add companies from another list to the buyer list (free)","tags":["account"],"x-openai-isConsequential":false}},"/api/v1/tools/blind_spots":{"post":{"description":"Free; an API key is optional (it records the call in your usage). What a Korean exporter of this product is likely to miss in a market — the unknown unknowns beyond the product category's usual compliance: rules that can stop the sale (e.g.","operationId":"blind_spots","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country":{"description":"Target country as ISO 3166-1 alpha-2 (e.g. 'US', 'JP') or an English/Korean name. Optional: omit to check the markets of the plan's table.","type":"string"},"description":{"description":"Optional: the product as the user describes it, any language (e.g. '비건 선크림 SPF50', 'Bluetooth speaker with a rechargeable battery', 'ramen with beef broth'). Used only to detect product traits that change the rules within one HS code (see traits).","type":"string"},"item":{"description":"Product as an HS4 code (e.g. '3304') or a name in English or Korean (e.g. 'sunscreen', '라면'). Names cover TradeGraph's 35 items; any other product works as a 4-digit HS code (e.g. '1905' biscuits, '2005' kimchi, '3305' shampoo) with live UN Comtrade imports.","type":"string"},"product":{"description":"Optional: the product's own name in English (e.g. 'vegan sunscreen').","type":"string"},"traits":{"description":"Optional: product traits, comma-separated, that change the rules within one HS code: sunscreen, whitening (also arbutin, kojic acid), vitamin_a (retinol), gel_nail (UV/LED gel, semi-cured strips), contact_lens (HS 9001: contact lenses, colour lenses), hair_dye, hair_loss, acne, antiperspirant, dandruff, fluoride (toothpaste), human_derived (human stem cell culture media, human placenta, cord blood: a ban in the EU, UK, China and ASEAN), stem_cell (stem cell culture media whose source is not named: check it), exosome, radio (Bluetooth, Wi-Fi, cellular), battery, meat, dairy, egg, aerosol, flammable, industrial or household (for HS codes that hold both, such as 8414 fans, compressors and vacuum pumps: picks machinery rules, trade fairs and buyer searches, or household-appliance ones). Also detected from item, product and description; the answer lists them in product_traits.","type":"string"}},"required":["item"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"What exporters miss: blockers, approvals, extra duties","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/buyer_targets":{"post":{"description":"Free; an API key is optional (it records the call in your usage). Reply rates of country × buyer type (importer, distributor, wholesaler, retailer, brand, manufacturer, clinic) from 2.2M real export emails, shrunk toward the average so small samples do not mislead, ranked by the low end of the 90%…","operationId":"buyer_targets","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"buyer_type":{"description":"Optional buyer type filter.","enum":["importer","distributor","wholesaler","retailer","brand","manufacturer","clinic"],"type":"string"},"country":{"description":"Target country as ISO 3166-1 alpha-2 (e.g. 'US', 'JP') or an English/Korean name. Optional.","type":"string"},"limit":{"default":8,"description":"Rows to return.","maximum":40,"minimum":1,"type":"integer"},"tier":{"description":"Which confidence tiers to return.","enum":["all","proven","promising"],"type":"string"}},"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Who replies: country × buyer type","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/channel_plan":{"post":{"description":"Free; an API key is optional (it records the call in your usage). GTM engineering plan for one country: creator platforms to seed on, marketplaces to research, buyer channels, local-language and disclosure rules, product compliance pointers (with an official source link), the official tariff lookup…","operationId":"channel_plan","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country":{"description":"Target country as ISO 3166-1 alpha-2 (e.g. 'US', 'JP') or an English/Korean name.","type":"string"},"description":{"description":"Optional: the product as the user describes it, any language (e.g. '비건 선크림 SPF50', 'Bluetooth speaker with a rechargeable battery', 'ramen with beef broth'). Used only to detect product traits that change the rules within one HS code (see traits).","type":"string"},"item":{"description":"Product as an HS4 code (e.g. '3304') or a name in English or Korean (e.g. 'sunscreen', '라면'). Names cover TradeGraph's 35 items; any other product works as a 4-digit HS code (e.g. '1905' biscuits, '2005' kimchi, '3305' shampoo) with live UN Comtrade imports. Optional; adds niche keywords and compliance pointers.","type":"string"},"motion":{"description":"Which part of the plan to return. 'all' adapts to the item: industrial goods get b2b, trade and search only.","enum":["all","seeding","marketplace","social","b2b","trade","ads","search","trends"],"type":"string"},"traits":{"description":"Optional: product traits, comma-separated, that change the rules within one HS code: sunscreen, whitening (also arbutin, kojic acid), vitamin_a (retinol), gel_nail (UV/LED gel, semi-cured strips), contact_lens (HS 9001: contact lenses, colour lenses), hair_dye, hair_loss, acne, antiperspirant, dandruff, fluoride (toothpaste), human_derived (human stem cell culture media, human placenta, cord blood: a ban in the EU, UK, China and ASEAN), stem_cell (stem cell culture media whose source is not named: check it), exosome, radio (Bluetooth, Wi-Fi, cellular), battery, meat, dairy, egg, aerosol, flammable, industrial or household (for HS codes that hold both, such as 8414 fans, compressors and vacuum pumps: picks machinery rules, trade fairs and buyer searches, or household-appliance ones). Also detected from item, product and description; the answer lists them in product_traits.","type":"string"}},"required":["country"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Channels, creators and live-data calls for a country","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/company_context":{"post":{"description":"Free; needs an API key. The signed-in company's own export context, saved in its TradeGraph account so every conversation (and every teammate's agent) starts from what the company already knows.","operationId":"company_context","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"action":{"description":"What to do (default get).","enum":["get","update","remember","forget","suppress","unsuppress","erase_contact","share"],"type":"string"},"base":{"description":"Optional, with action=update: updated_at from the last get; if someone changed the profile since, nothing is saved and you get the newer one to merge.","type":"string"},"id":{"description":"With action=forget: the memory id.","type":"string"},"note":{"additionalProperties":false,"description":"With action=remember.","properties":{"country":{"description":"Optional market (ISO alpha-2) it is about.","type":"string"},"item":{"description":"Optional product (name or HS code) it is about.","type":"string"},"kind":{"description":"What kind of memory.","enum":["decision","learning","preference","contact","note"],"type":"string"},"text":{"description":"The memory, one or two sentences.","type":"string"}},"type":"object"},"on":{"description":"With action=share: opt in (true) or out (false).","type":"boolean"},"profile":{"additionalProperties":false,"description":"With action=update: the fields to change.","properties":{"about":{"description":"One or two sentences about the company for first emails.","type":"string"},"address":{"description":"The company's postal address. Outreach drafts end with it: US CAN-SPAM, Canada's CASL and Japan's anti-spam law require the sender's physical address in commercial email.","type":"string"},"avoid":{"description":"Markets the company will not go to (ISO alpha-2); never recommended.","items":{"type":"string"},"type":"array"},"brand":{"description":"Brand name used with buyers.","type":"string"},"certs":{"items":{"additionalProperties":false,"properties":{"expires":{"description":"Expiry date YYYY-MM-DD, if any.","type":"string"},"market":{"description":"Where it applies: ISO alpha-2 or EU, GCC, ASEAN.","type":"string"},"name":{"description":"Certification or registration held, e.g. 'CPNP notification', 'FDA cosmetic facility registration (MoCRA)', 'Halal (MUI)'.","type":"string"},"ref":{"description":"Registration number, if any.","type":"string"}},"type":"object"},"maxItems":50,"type":"array"},"channels":{"description":"Where it already sells, e.g. 'Amazon US', 'Shopee SG'.","items":{"type":"string"},"type":"array"},"currency":{"description":"Quote currency, ISO 4217 (e.g. 'USD').","type":"string"},"langs":{"description":"Languages the team can answer buyers in (ISO 639-1).","items":{"type":"string"},"type":"array"},"name":{"description":"Company name.","type":"string"},"origin":{"description":"Country where the products are made, ISO alpha-2 (TradeGraph's reply data comes from Korean exporters; another origin changes what applies).","type":"string"},"port":{"description":"Port of loading for FOB quotes, e.g. 'Busan'.","type":"string"},"products":{"items":{"additionalProperties":false,"properties":{"description":{"description":"One line about it.","type":"string"},"fob":{"description":"FOB price per unit in the quote currency.","minimum":0,"type":"number"},"hs":{"description":"HS code, 4-10 digits.","type":"string"},"moq":{"description":"Minimum order, e.g. '3,000 units'.","type":"string"},"name":{"description":"Product name.","type":"string"},"unit":{"description":"Unit, e.g. 'tube 50 ml'.","type":"string"}},"type":"object"},"maxItems":20,"type":"array"},"sender":{"description":"The person who signs outreach emails.","type":"string"},"sender_title":{"description":"That person's job title.","type":"string"},"target":{"description":"Markets the company wants (ISO alpha-2).","items":{"type":"string"},"type":"array"},"tried":{"items":{"additionalProperties":false,"properties":{"at":{"description":"When, YYYY-MM-DD.","type":"string"},"iso":{"description":"Market, ISO alpha-2.","type":"string"},"note":{"description":"Why, in one line.","type":"string"},"result":{"description":"How it went.","enum":["active","paused","stopped","won"],"type":"string"}},"type":"object"},"maxItems":60,"type":"array"},"website":{"description":"Company website.","type":"string"}},"type":"object"},"values":{"description":"With suppress, unsuppress or erase_contact: emails or @domains.","items":{"type":"string"},"type":"array"}},"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{"bearer":[]}],"summary":"This company's export context (kept across conversations) — free","tags":["account"],"x-openai-isConsequential":true}},"/api/v1/tools/country_brief":{"post":{"description":"Free; an API key is optional (it records the call in your usage). Everything TradeGraph knows about one country: reply rate and best buyer types, the product's import size/growth/Korea share and supplier mix, why other Korean exporters chose it, reply rates by industry, top US states (for the US),…","operationId":"country_brief","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country":{"description":"Target country as ISO 3166-1 alpha-2 (e.g. 'US', 'JP') or an English/Korean name.","type":"string"},"description":{"description":"Optional: the product as the user describes it, any language (e.g. '비건 선크림 SPF50', 'Bluetooth speaker with a rechargeable battery', 'ramen with beef broth'). Used only to detect product traits that change the rules within one HS code (see traits).","type":"string"},"item":{"description":"Product as an HS4 code (e.g. '3304') or a name in English or Korean (e.g. 'sunscreen', '라면'). Names cover TradeGraph's 35 items; any other product works as a 4-digit HS code (e.g. '1905' biscuits, '2005' kimchi, '3305' shampoo) with live UN Comtrade imports. Optional.","type":"string"},"traits":{"description":"Optional: product traits, comma-separated, that change the rules within one HS code: sunscreen, whitening (also arbutin, kojic acid), vitamin_a (retinol), gel_nail (UV/LED gel, semi-cured strips), contact_lens (HS 9001: contact lenses, colour lenses), hair_dye, hair_loss, acne, antiperspirant, dandruff, fluoride (toothpaste), human_derived (human stem cell culture media, human placenta, cord blood: a ban in the EU, UK, China and ASEAN), stem_cell (stem cell culture media whose source is not named: check it), exosome, radio (Bluetooth, Wi-Fi, cellular), battery, meat, dairy, egg, aerosol, flammable, industrial or household (for HS codes that hold both, such as 8414 fans, compressors and vacuum pumps: picks machinery rules, trade fairs and buyer searches, or household-appliance ones). Also detected from item, product and description; the answer lists them in product_traits.","type":"string"}},"required":["country"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Market brief for one country","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/export_rank":{"post":{"description":"Free; an API key is optional (it records the call in your usage). World exporters of a product (UN Comtrade, latest year), Korea's rank and value, and where Korea already sells it most.","operationId":"export_rank","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"item":{"description":"Product as an HS4 code (e.g. '3304') or a name in English or Korean (e.g. 'sunscreen', '라면'). Names cover TradeGraph's 35 items; any other product works as a 4-digit HS code (e.g. '1905' biscuits, '2005' kimchi, '3305' shampoo) with live UN Comtrade imports.","type":"string"}},"required":["item"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"World export ranking for a product","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/export_workflow":{"post":{"description":"Free; an API key is optional (it records the call in your usage). 36 step-by-step expert workflows for the export jobs around the data — what exporters usually learn too late: export readiness check (blind spots, 90-day plan), certification and registration in each market (FDA, MoCRA, CPNP, NMPA, h…","operationId":"export_workflow","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"file":{"description":"Optional, with name: a reference file the workflow mentions, e.g. 'references/sources.md'.","type":"string"},"job":{"description":"What the user wants done, in their own words and any language (e.g. '이 바이어 믿어도 돼? 입금 계좌가 바뀌었대', 'the US buyer wants an FTA certificate of origin', 'first export, what are we missing?'). Returns the best-matching workflow.","type":"string"},"name":{"description":"A workflow name (from the list, or a name a TradeGraph answer mentions such as certification-check).","enum":["export-readiness","export-market-entry","hs-code-finder","buyer-prospecting","distributor-outreach","reply-triage","buyer-meeting-brief","sales-kit-builder","trade-show-planner","trade-show-followup","influencer-seeding","marketplace-launch","cross-border-ecommerce","video-ad-studio","product-photo-studio","localized-creative","trend-radar","social-listening","competitor-ad-intel","ai-search-visibility","certification-check","label-localization","regulation-watch","export-control-screening","export-pricing","trade-finance","export-support-finder","grant-application","duty-drawback","fta-origin","export-documents","export-logistics","buyer-due-diligence","trademark-protection","distribution-agreement","trade-dispute-response"],"type":"string"}},"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Step-by-step export workflows (certification, FTA origin, documents, payment, buyer checks …)","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/find_buyers":{"post":{"description":"Charges prepaid TradeGraph credits; needs an API key. Builds this account's buyer list for a plan, week by week: runs the local-language map searches from gtm_plan buyer_search (buyer type + product + cities, Korean or Asian specialists first) through Google Maps and adds the companies as rows: nam…","operationId":"find_buyers","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"contacts":{"description":"Also find a buyer and a verified work email for each new company (and, with limit 0, for saved companies without one).","type":"boolean"},"country":{"description":"Market, ISO alpha-2 (e.g. 'DE').","type":"string"},"estimate":{"description":"Return the cost estimate and the saved list's counts without spending anything.","type":"boolean"},"item":{"description":"Product name or HS code, as in gtm_plan.","type":"string"},"leads":{"description":"Look up the public-record buyer candidates (gtm_plan buyer_leads) on the map and add their website and phone.","type":"boolean"},"limit":{"description":"New companies wanted (default: this week's new buyers from reply_target, max 200). 0 with contacts=true only finds contacts for companies already on the list (new paid lookups; estimate first).","maximum":200,"minimum":0,"type":"integer"},"pending_only":{"description":"With contacts=true: only finish the contact lookups already started (contacts_pending, or stopped partway) and start no new ones; adds no companies. Use this to resume after 'the data provider is still working'.","type":"boolean"},"product":{"description":"Optional. The product name used in the emails (gtm_plan product).","type":"string"},"source":{"description":"Optional, with limit 0 and contacts=true: look up contacts only for the companies added from this list (the source given to add_buyers, e.g. 'MEDICA 2026 exhibitors').","type":"string"},"type":{"description":"The buyer type to search for: reply_pace or my_progress find_buyers_type (default: the plan's buyer type this week). It never switches on its own.","enum":["distributor","wholesaler","importer","retailer"],"type":"string"},"unlogged_ok":{"description":"Add new companies even though log_first says companies added since the last logged numbers may not be emailed yet. Only when the user says so; otherwise log the week with my_progress first.","type":"boolean"}},"required":["item","country"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not enough credits (top up at https://tradegraph.rinda.ai/account/credits)"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"This key's monthly limit is reached"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The call could cost more than max_cost_usd; nothing was charged"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Live data is temporarily unavailable; nothing was charged"}},"security":[{"bearer":[]}],"summary":"Find this week's new buyers, with contacts (charged to TradeGraph credits)","tags":["account"],"x-openai-isConsequential":true}},"/api/v1/tools/find_item":{"post":{"description":"Free; an API key is optional (it records the call in your usage). Resolve a product description (any of 10 languages, e.g. 'vegan sunscreen', '컵라면', 'kimchi', 'キムチ', '3304') to one of the 35 HS4 items TradeGraph covers, or to the usual HS4 code of ~60 other common consumer products (kimchi 2005, sh…","operationId":"find_item","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Product name, alias or HS digits.","type":"string"}},"required":["query"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Find a product's HS code","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/gtm_plan":{"post":{"description":"Free; an API key is optional (it records the call in your usage). START HERE. One call returns the export go-to-market plan for a product: which countries to sell to (UN Comtrade imports × reply rates from 2.2M real export emails, compared within the product's industry, plus the next-best markets t…","operationId":"gtm_plan","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country":{"description":"Target country as ISO 3166-1 alpha-2 (e.g. 'US', 'JP') or an English/Korean name. Optional: omit to let the data pick the market.","type":"string"},"description":{"description":"Optional: the product as the user describes it, any language (e.g. '비건 선크림 SPF50', 'Bluetooth speaker with a rechargeable battery', 'ramen with beef broth'). Used only to detect product traits that change the rules within one HS code (see traits).","type":"string"},"detail":{"description":"Optional: brief (about half the size, for chat clients with a result size limit) or full (default, every draft).","enum":["full","brief"],"type":"string"},"exclude":{"description":"Optional: markets already tried, comma-separated ISO codes or names (e.g. 'DE,PL'); next_markets skips them.","type":"string"},"item":{"description":"Product as an HS4 code (e.g. '3304') or a name in English or Korean (e.g. 'sunscreen', '라면'). Names cover TradeGraph's 35 items; any other product works as a 4-digit HS code (e.g. '1905' biscuits, '2005' kimchi, '3305' shampoo) with live UN Comtrade imports.","type":"string"},"origin":{"description":"Optional: where the product is made, ISO alpha-2 (default KR, or the signed-in company's origin). TradeGraph's reply data comes from Korean exporters: another origin is left out of the markets and origin_check says what applies.","type":"string"},"product":{"description":"Optional: the product's own name in English for the first-email draft (e.g. 'kimchi', 'sunscreen'), up to 60 characters. Defaults to the item name; for a live HS code without it the draft says 'products under HS 2005'. A name not in English is not put in the English drafts (product_note says what they use).","type":"string"},"product_local":{"description":"Optional, Japan: the product's name in Japanese for the Japanese drafts (local_emails), e.g. 'カシミヤ混ニット'. A product written in Japanese is used there too.","type":"string"},"strengths":{"description":"Optional: what your company actually offers partners, in English and your own words, up to 240 characters (e.g. 'CE and ISO 9001, 4-week lead time, MOQ 50 units, spare parts stocked in Germany'). The drafts state only this; without it, offers TradeGraph cannot know you make (demo units, training, stock, lead time) stay as [CONFIRM: ...] lines listed in first_email.claims_to_confirm.","type":"string"},"traits":{"description":"Optional: product traits, comma-separated, that change the rules within one HS code: sunscreen, whitening (also arbutin, kojic acid), vitamin_a (retinol), gel_nail (UV/LED gel, semi-cured strips), contact_lens (HS 9001: contact lenses, colour lenses), hair_dye, hair_loss, acne, antiperspirant, dandruff, fluoride (toothpaste), human_derived (human stem cell culture media, human placenta, cord blood: a ban in the EU, UK, China and ASEAN), stem_cell (stem cell culture media whose source is not named: check it), exosome, radio (Bluetooth, Wi-Fi, cellular), battery, meat, dairy, egg, aerosol, flammable, industrial or household (for HS codes that hold both, such as 8414 fans, compressors and vacuum pumps: picks machinery rules, trade fairs and buyer searches, or household-appliance ones). Also detected from item, product and description; the answer lists them in product_traits.","type":"string"}},"required":["item"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Export GTM plan for a product","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/image_studio":{"post":{"description":"Free; an API key is optional (it records the call in your usage). Plan the product image set for one market: the marketplace's main-image rules (Amazon, Rakuten, Tmall, Shopee, TikTok Shop…), a 7-image gallery (real main image, local lifestyle, texture, how-to, benefits infographic, scale, trust) w…","operationId":"image_studio","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country":{"description":"Target country as ISO 3166-1 alpha-2 (e.g. 'US', 'JP') or an English/Korean name.","type":"string"},"item":{"description":"Product as an HS4 code (e.g. '3304') or a name in English or Korean (e.g. 'sunscreen', '라면'). Names cover TradeGraph's 35 items; any other product works as a 4-digit HS code (e.g. '1905' biscuits, '2005' kimchi, '3305' shampoo) with live UN Comtrade imports. Optional; sets the product group.","type":"string"},"marketplace":{"description":"Optional marketplace, e.g. 'amazon', 'rakuten', 'shopee'; defaults to the market's main one.","type":"string"},"product":{"description":"The product in plain English as it looks.","type":"string"},"variants":{"default":2,"description":"Generated variants per frame.","maximum":4,"minimum":1,"type":"integer"}},"required":["country"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Marketplace and ad images for a market","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/live_call":{"post":{"description":"Charges prepaid TradeGraph credits; needs an API key. Run one treg.to catalog endpoint — creator search, marketplace listings, social posts, buyer contacts and email verification, image/video/voice generation — with this TradeGraph account's prepaid credits (no treg account needed).","operationId":"live_call","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"body":{"additionalProperties":true,"description":"JSON body (POST endpoints).","type":"object"},"endpoint":{"description":"treg catalog endpoint id, e.g. 'influencersclub.creators.search' (from live_tools / channel_plan / gtm_plan).","type":"string"},"idempotency_key":{"description":"Optional. Pass the idempotency_key of a pending or lost answer to get that call's result without paying twice; leave it out for a new call.","type":"string"},"max_cost_usd":{"description":"Hard ceiling for this call in USD (default 0.50).","minimum":0.001,"type":"number"},"method":{"description":"HTTP method. Default: POST when body is given, otherwise GET.","enum":["GET","POST","PUT","PATCH","DELETE"],"type":"string"},"params":{"additionalProperties":true,"description":"Query parameters (GET endpoints).","type":"object"}},"required":["endpoint"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Not enough credits (top up at https://tradegraph.rinda.ai/account/credits)"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"This key's monthly limit is reached"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The call could cost more than max_cost_usd; nothing was charged"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Live data is temporarily unavailable; nothing was charged"}},"security":[{"bearer":[]}],"summary":"Run a live-data endpoint (charged to TradeGraph credits)","tags":["account"],"x-openai-isConsequential":true}},"/api/v1/tools/live_tools":{"post":{"description":"Free; an API key is optional (it records the call in your usage). Search the treg.to catalog (3,800+ endpoints across 110 providers) for the endpoints that do a job, e.g. 'find TikTok beauty creators', 'Amazon best sellers', 'verify buyer emails', '샤오홍슈 KOL 단가'.","operationId":"live_tools","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"job":{"description":"What you want to do, in English or Korean.","type":"string"},"limit":{"default":6,"description":"Endpoints to return.","maximum":12,"minimum":1,"type":"integer"}},"required":["job"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Find live-data endpoints for a job","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/log_outcomes":{"post":{"description":"Free; needs an API key. Records outcomes for buyers this account emailed, from any sending tool or inbox: sent, replied, interested, not_interested, meeting, deal, bounced, unsubscribed.","operationId":"log_outcomes","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country":{"description":"Optional: default market (ISO alpha-2) for events without one.","type":"string"},"events":{"description":"Outcomes, at most 200 per call.","items":{"additionalProperties":false,"properties":{"at":{"description":"When it happened, RFC 3339 or YYYY-MM-DD (default now).","type":"string"},"buyer_type":{"description":"Optional: the buyer type, when the buyer is not on a saved list.","enum":["distributor","wholesaler","importer","retailer","brand","manufacturer","clinic"],"type":"string"},"company":{"description":"The buyer's company name, when there is no email or domain.","type":"string"},"country":{"description":"The buyer's market, ISO alpha-2 (default: the call's country, or the buyer list where the email is found).","type":"string"},"domain":{"description":"The buyer's company domain or website, when there is no email.","type":"string"},"email":{"description":"The buyer's email (best: matches the saved buyer list exactly).","type":"string"},"id":{"description":"Optional: the sending tool's event id, so a retried webhook is not counted twice.","type":"string"},"item":{"description":"Product name or HS code of the plan (default: the call's item, or the buyer list where the email is found).","type":"string"},"type":{"description":"What happened.","enum":["sent","bounced","unsubscribed","replied","not_interested","interested","meeting","deal"],"type":"string"}},"required":["type"],"type":"object"},"maxItems":200,"type":"array"},"item":{"description":"Optional: default product (name or HS code) for events without one.","type":"string"},"source":{"description":"Where the outcomes come from, e.g. 'rinda', 'gmail', 'outlook', 'hubspot', 'manual'.","type":"string"},"update_progress":{"description":"Also save today's totals to my_progress for each plan when the outcomes show more buyers emailed or replies than the last logged numbers (never lowers them).","type":"boolean"}},"required":["events"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{"bearer":[]}],"summary":"Log what happened to sent emails (replies, bounces, meetings) — free","tags":["account"],"x-openai-isConsequential":false}},"/api/v1/tools/market_picks":{"post":{"description":"Free; an API key is optional (it records the call in your usage). Import markets for a product ranked by size, with 3-year growth, Korea's share and the reply rate Korean exporters of that industry actually got there (reply_scope: industry = compared with the industry's average; none = no emails fr…","operationId":"market_picks","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"item":{"description":"Product as an HS4 code (e.g. '3304') or a name in English or Korean (e.g. 'sunscreen', '라면'). Names cover TradeGraph's 35 items; any other product works as a 4-digit HS code (e.g. '1905' biscuits, '2005' kimchi, '3305' shampoo) with live UN Comtrade imports.","type":"string"},"limit":{"default":10,"description":"Markets to return.","maximum":30,"minimum":1,"type":"integer"}},"required":["item"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Where to sell a product","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/market_scan":{"post":{"description":"Free; an API key is optional (it records the call in your usage). For products outside TradeGraph's 35 items: live UN Comtrade imports by country for any 4-digit HS code (latest complete year, 3-year growth, Korea's exports there), joined with TradeGraph reply rates for the product's industry, with…","operationId":"market_scan","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"hs":{"description":"4-digit HS code, e.g. '1905' (biscuits, snacks), '2005' (kimchi), '1904' (instant rice), '2206' (makgeolli), '3305' (shampoo), '3303' (perfume).","type":"string"},"limit":{"default":15,"description":"Markets to return.","maximum":30,"minimum":1,"type":"integer"}},"required":["hs"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Live import markets for any HS code","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/my_progress":{"post":{"description":"Free; needs an API key. Reads and saves this account's weekly numbers per plan (product × market): the same record the web plan's 'My progress' shows when the user is signed in, so the agent, the web and the team see the same numbers.","operationId":"my_progress","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"confirm":{"description":"Set true only after asking the user and getting a yes, for a total that jumps far past the plan (more than three weeks' worth, at least 500, over the last entry, or on the first entry over the first 200 buyers) or is lower than the last entry; without it such a total is refused so a typo can't end the market and this week's numbers aren't logged as the totals.","type":"boolean"},"country":{"description":"With item: the market, ISO alpha-2 (e.g. 'DE').","type":"string"},"date":{"description":"Optional: the day the numbers are for, YYYY-MM-DD (default today in Korea time; pass the user's own date when it differs, e.g. late evening in Europe or the Americas).","type":"string"},"exclude":{"description":"Optional: markets already tried, comma-separated ISO codes, skipped when the pace check names the next market.","type":"string"},"item":{"description":"Optional: product name or HS code, as in gtm_plan. Omit to list the saved plans.","type":"string"},"product":{"description":"Optional, with start or numbers: the product's own name as the user calls it (e.g. '김스낵', 'vegan sunscreen'); the dashboard's plan list and the web plan show it.","type":"string"},"replies":{"description":"Optional, with sent: buyers who replied so far (any reply, including a no).","maximum":1000000,"minimum":0,"type":"integer"},"sent":{"description":"Optional, with replies: buyers emailed so far in this market (count each buyer once; follow-ups don't add).","maximum":1000000,"minimum":0,"type":"integer"},"start":{"description":"Optional: the Monday of week 1 (the week of the first 200 emails), YYYY-MM-DD; any day moves to its Monday.","type":"string"},"warm":{"description":"Optional: of the replies, how many were interested (a question, a sample request or a meeting).","maximum":1000000,"minimum":0,"type":"integer"}},"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{"bearer":[]}],"summary":"My saved progress (the web plan's numbers)","tags":["account"],"x-openai-isConsequential":false}},"/api/v1/tools/outreach_playbook":{"post":{"description":"Free; an API key is optional (it records the call in your usage). Measured from 2.2M real export emails: replies per 10,000 emails at each follow-up step, the recommended number of emails, how many days to wait before the next one (follow_up_after_days), when replies arrive, what replies say (inter…","operationId":"outreach_playbook","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{},"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"How many emails, when, and what replies say","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/price_ladder":{"post":{"description":"Free; an API key is optional (it records the call in your usage). Turn a FOB unit price into the landed cost, importer/distributor price and shelf price (incl. VAT) in a country — or, from a target shelf price, the highest FOB that reaches it.","operationId":"price_ladder","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"channel":{"description":"Route to the consumer or, for goods sold to businesses, to the end user. Default: retail, or b2b when the item is sold to businesses. cross_border is for Japan only.","enum":["retail","distributor","marketplace","cross_border","b2b","b2b_dealer"],"type":"string"},"compare":{"description":"Optional: other markets to price the same FOB and channel in, each with its own duty and VAT defaults (your duty_pct and vat_pct stay with this country; margins, freight and import costs carry over). Comma-separated ISO codes (e.g. \"US,JP,MX\", up to 5) or \"auto\" for the item's largest import markets that have a VAT table, skipping sanctioned markets and re-export hubs. Returns compare (this market first, then the others: shelf_usd, local shelf, multiple, duty_pct with duty_source checked/fta/free_port/none/yours, vat_pct, shelf_tax) and compare_basis (given, imports, or default when TradeGraph has no import figures for the item). Not for cross_border.","type":"string"},"country":{"description":"Target country as ISO 3166-1 alpha-2 (e.g. 'US', 'JP') or an English/Korean name.","type":"string"},"dealer_margin_pct":{"description":"Dealer margin, % of its selling price (channel 'b2b_dealer', default 25).","type":"number"},"description":{"description":"Optional: the product's own name or a short description (e.g. '김스낵', 'seasoned seaweed snack'). Product traits in it pick the US duty line, e.g. seaweed snacks under HS 2008 are on the Section 301 exemption list.","type":"string"},"distributor_margin_pct":{"description":"Distributor margin, % of its selling price (channel 'distributor').","type":"number"},"duty_pct":{"description":"Import duty % of CIF for your tariff line (default 0, except the US: 12.5 — the combined duty on most Korean goods since 24 Jul 2026, KORUS included — or, when item is given, that HS code's US rate: 50% or 25% Section 232 on steel, aluminium and copper goods, 15% for Korean auto parts, 0% for electronics exempt from Section 301; check your line at the tariff_lookup link in the result).","type":"number"},"fob_krw":{"description":"FOB price per unit in Korean won (e.g. 6000 for ₩6,000) when the user quotes in won: converted to USD at the European Central Bank reference rate, and the answer says the rate (converted). Never put a won amount in fob_usd.","type":"number"},"fob_usd":{"description":"FOB price per unit in USD. Give this, fob_krw, target_shelf_usd or target_shelf_local.","type":"number"},"freight_pct":{"description":"Freight + insurance as % of FOB (default 8).","type":"number"},"fulfillment_usd":{"description":"Fulfilment per unit in USD for marketplace sales (default 4).","type":"number"},"import_costs_pct":{"description":"Broker, port, inland and labelling as % of CIF (default 4).","type":"number"},"importer_margin_pct":{"description":"Importer margin, % of its selling price (channel b2b: the importer-distributor selling to the end user, default 30, 35 for medical devices; b2b_dealer: 15, or 20 for medical devices).","type":"number"},"item":{"description":"Product as an HS4 code (e.g. '3304') or a name in English or Korean (e.g. 'sunscreen', '라면'). Names cover TradeGraph's 35 items; any other product works as a 4-digit HS code (e.g. '1905' biscuits, '2005' kimchi, '3305' shampoo) with live UN Comtrade imports. Optional; sets VAT (food rate), default margins and the default channel (b2b for equipment, parts and medical devices).","type":"string"},"marketplace_fee_pct":{"description":"Marketplace referral fee % (default 15).","type":"number"},"parcel_usd":{"description":"Channel cross_border: courier from Korea to the customer's door per unit in USD (default 5, an assumption; use your courier's quote).","type":"number"},"retail_margin_pct":{"description":"Retailer margin, % of its selling price.","type":"number"},"seller_margin_pct":{"description":"Your margin on marketplace sales, % of price (default 25).","type":"number"},"target_shelf_local":{"description":"The same target in the market's own currency (e.g. 2500 for ¥2,500 on Qoo10 Japan, 19.99 for €19.99 in Germany); converted at the ECB reference rate. Use it instead of target_shelf_usd.","type":"number"},"target_shelf_usd":{"description":"Shelf price you want per unit in USD (incl. VAT where VAT applies; for the b2b channels the end-user price before VAT); returns the highest FOB that reaches it.","type":"number"},"targets":{"description":"Optional: several shelf prices in USD to compare, comma-separated (e.g. \"19.99,24.99,29.99\", up to 6) — returns fob_at_targets, the highest FOB for each with the same assumptions. Use competitors' shelf prices to see what each allows.","type":"string"},"vat_pct":{"description":"Override the VAT/GST rate.","type":"number"}},"required":["country"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Export price ladder: FOB to shelf price","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/reply_pace":{"post":{"description":"Free; an API key is optional (it records the call in your usage). Weekly pace check for one market: pass the buyers emailed so far (each buyer once, first emails only), the buyers who replied (any reply, a no counts) and, if known, the week of the 13-week schedule and how many replies were interest…","operationId":"reply_pace","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"bounced":{"description":"Optional: buyers whose email bounced. Over 10% of sent holds a market switch until the list is verified (reach_check list_problem).","maximum":1000000,"minimum":0,"type":"integer"},"buyer_type":{"description":"Optional: the buyer type the user sent to last week (last week's find_buyers_type); after a switch to the next type the check keeps it.","type":"string"},"changed":{"description":"Optional: changes already made in earlier weeks, as last week's changed (comma-separated: next_type, new_subject, new_subject_2, offer, retry, retry_type). A change once made is kept: the same verdict again keeps it instead of flipping back, a retry uses a subject line not sent yet, and retry (a retry batch already started) keeps that subject line in the following weeks; retry_type (the retry switched to a buyer type not tried yet) keeps that type's email. my_progress does this from the saved log.","type":"string"},"country":{"description":"Target country as ISO 3166-1 alpha-2 (e.g. 'US', 'JP') or an English/Korean name.","type":"string"},"exclude":{"description":"Optional: markets already tried, comma-separated ISO codes or names (e.g. 'DE,PL'), skipped when naming the next market.","type":"string"},"item":{"description":"Product as an HS4 code (e.g. '3304') or a name in English or Korean (e.g. 'sunscreen', '라면'). Names cover TradeGraph's 35 items; any other product works as a 4-digit HS code (e.g. '1905' biscuits, '2005' kimchi, '3305' shampoo) with live UN Comtrade imports.","type":"string"},"last_replies":{"description":"Optional: last week's replies total (replies lower than last_replies is rejected).","maximum":1000000,"minimum":0,"type":"integer"},"last_sent":{"description":"Optional: last week's sent total, to catch this week's numbers passed instead of running totals (sent lower than last_sent is rejected).","maximum":1000000,"minimum":0,"type":"integer"},"meetings":{"description":"Optional: buyers who agreed to a meeting or a call.","maximum":1000000,"minimum":0,"type":"integer"},"opened":{"description":"Optional: of the buyers emailed, how many opened at least one email, as the user's email tool reports it (unique opens). Below the share of delivered emails people open in TradeGraph's data, the emails are probably not reaching inboxes: reach_check says so and holds a market switch (decision fix_reach_first).","maximum":1000000,"minimum":0,"type":"integer"},"orders":{"description":"Optional: buyers who placed an order (trial orders count). An order keeps the market even with few replies (pipeline).","maximum":1000000,"minimum":0,"type":"integer"},"quotes":{"description":"Optional: buyers who asked for prices or a quote.","maximum":1000000,"minimum":0,"type":"integer"},"replies":{"default":0,"description":"Buyers who replied so far (any reply, including a no).","maximum":1000000,"minimum":0,"type":"integer"},"samples":{"description":"Optional: buyers who asked for samples.","maximum":1000000,"minimum":0,"type":"integer"},"sent":{"default":200,"description":"Buyers emailed so far in this market (count each buyer once; follow-ups don't add).","maximum":1000000,"minimum":1,"type":"integer"},"warm":{"default":0,"description":"Optional: of the replies, how many were interested (a question, a sample request or a meeting; not a no). Compared with the usual interested share of replies; from 5 replies a low share adds warm_note.","maximum":1000000,"minimum":0,"type":"integer"},"week":{"default":0,"description":"Optional: the week of the 13-week schedule they are in (1 = the week of the first 200 emails), to flag sends behind schedule or a decision that moves past week 13.","maximum":60,"minimum":0,"type":"integer"}},"required":["item","country","sent","replies"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Are my replies on track?","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/tools/seeding_list":{"post":{"description":"Free; needs an API key. Keeps this account's influencer seeding list per plan (product × market) across waves, so the next wave starts from what happened in the last one: the creators picked, where each one is (shortlisted, contacted, agreed, shipped, posted, declined, no_reply), which wave, the po…","operationId":"seeding_list","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"add":{"description":"Creators to add (at most 100 per call), as shortlisted unless status says otherwise.","items":{"additionalProperties":false,"properties":{"engagement":{"description":"Engagement rate in percent (e.g. 3.2), as the endpoint returned it.","type":"number"},"followers":{"description":"Followers, as the endpoint returned them.","type":"number"},"handle":{"description":"The creator's handle (with or without @) or profile URL.","type":"string"},"note":{"description":"Why they fit, or a risk (at most 300 characters; no emails or phone numbers).","type":"string"},"platform":{"description":"The platform (taken from the URL when handle is a profile link).","enum":["instagram","tiktok","youtube","xiaohongshu","douyin","weibo","facebook","x","other"],"type":"string"},"source":{"description":"The endpoint id that returned this creator (e.g. 'influencersclub.creators.search'), or 'user' when the user named them.","type":"string"},"status":{"description":"Optional: where they are already (default shortlisted).","enum":["shortlisted","contacted","agreed","shipped","posted","declined","no_reply"],"type":"string"},"url":{"description":"Optional: the profile URL.","type":"string"},"wave":{"description":"Optional: the wave (default: the current wave, or the next one with new_wave).","type":"integer"}},"required":["handle"],"type":"object"},"maxItems":100,"type":"array"},"country":{"description":"With item: the market of the creators' audience, ISO alpha-2 (e.g. 'JP').","type":"string"},"item":{"description":"Optional: product name or HS code, as in gtm_plan. Omit to list the saved seeding lists.","type":"string"},"new_wave":{"description":"With add: start the next wave with these creators.","type":"boolean"},"remove":{"description":"Handles to take off the list (e.g. added by mistake).","items":{"type":"string"},"type":"array"},"update":{"description":"Changes to creators on the list, matched by handle (and platform when the same handle is on two platforms).","items":{"additionalProperties":false,"properties":{"engagement":{"description":"Updated engagement rate in percent.","type":"number"},"followers":{"description":"Updated followers.","type":"number"},"handle":{"description":"The creator's handle or profile URL.","type":"string"},"note":{"description":"Replaces the note (empty clears it).","type":"string"},"platform":{"description":"Only when the same handle is on two platforms.","enum":["instagram","tiktok","youtube","xiaohongshu","douyin","weibo","facebook","x","other"],"type":"string"},"post_url":{"description":"The post's link (sets status posted).","type":"string"},"reuse":{"description":"The creator's answer on reusing the post in ads and buyer emails: true if they agreed, false if they said no (either answer ends the results step for that post). Leave it out until you have asked.","type":"boolean"},"status":{"description":"The new status (dated today).","enum":["shortlisted","contacted","agreed","shipped","posted","declined","no_reply"],"type":"string"},"views":{"description":"Views of the post, as the creator or an endpoint reported.","type":"number"},"wave":{"description":"A later wave number sends this creator again in that wave (the earlier result is kept).","type":"integer"}},"required":["handle"],"type":"object"},"type":"array"}},"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{"bearer":[]}],"summary":"My creator seeding list (saved to the account, free)","tags":["account"],"x-openai-isConsequential":true}},"/api/v1/tools/video_studio":{"post":{"description":"Free; an API key is optional (it records the call in your usage). Plan AI product videos for one market and platform, Higgsfield-style: preset formats (hero orbit, texture macro, unboxing POV, 3-step routine, local lifestyle, AI presenter) with camera moves, a shot list, keyframe and image-to-video…","operationId":"video_studio","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"country":{"description":"Target country as ISO 3166-1 alpha-2 (e.g. 'US', 'JP') or an English/Korean name.","type":"string"},"has_packshot":{"description":"Whether a real product photo exists (default true). Without one the plan asks for it first.","type":"boolean"},"item":{"description":"Product as an HS4 code (e.g. '3304') or a name in English or Korean (e.g. 'sunscreen', '라면'). Names cover TradeGraph's 35 items; any other product works as a 4-digit HS code (e.g. '1905' biscuits, '2005' kimchi, '3305' shampoo) with live UN Comtrade imports. Optional; sets the product group for scenes and claims rules.","type":"string"},"platform":{"description":"Where the video runs; auto = the market's first creator platform.","enum":["auto","tiktok","reels","shorts","xiaohongshu","douyin","amazon","meta-feed"],"type":"string"},"preset":{"description":"Video format; auto = three presets that suit the product group.","enum":["auto","hero-orbit","texture-macro","unboxing-pov","routine-steps","lifestyle-local","ai-presenter"],"type":"string"},"product":{"description":"The product in plain English as it looks, e.g. 'vegan sunscreen SPF50, 50 ml white tube with green cap'. Used in every prompt.","type":"string"},"tier":{"description":"Model tier: draft (cheap 480p tests), standard (Hailuo 2.3 768P), premium (Veo 3.1 Fast 1080p).","enum":["draft","standard","premium"],"type":"string"},"variants":{"default":2,"description":"Hook variants per preset (A/B test the first 2 seconds).","maximum":5,"minimum":1,"type":"integer"}},"required":["country"],"type":"object"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResult"}}},"description":"Tool answer: a one-line summary and structured data"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Invalid arguments (the message says how to fix them)"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing, invalid or revoked"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limited"}},"security":[{},{"bearer":[]}],"summary":"Short-form video ads for a market (Higgsfield-style presets)","tags":["tools"],"x-openai-isConsequential":false}},"/api/v1/usage":{"get":{"operationId":"get_usage","parameters":[{"in":"query","name":"days","schema":{"default":30,"enum":[7,30,90],"type":"integer"}},{"description":"Only this key (id from the dashboard)","in":"query","name":"key","schema":{"format":"uuid","type":"string"}},{"description":"Next page: the `next` value of the previous answer","in":"query","name":"before","schema":{"format":"date-time","type":"string"}},{"in":"query","name":"limit","schema":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},{"description":"Minutes east of UTC for day boundaries (e.g. 540 for Korea)","in":"query","name":"tz","schema":{"default":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"Usage report"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"API key missing or invalid"}},"security":[{"bearer":[]}],"summary":"Usage history: calls and credits spent by day","tags":["account"],"x-openai-isConsequential":false}}},"servers":[{"url":"https://tradegraph.rinda.ai"}]}