Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
description: 'K-beauty products and ingredients compared with official records from Korea (MFDS), the EU (CosIng) and the U.S. (FDA), plus rules for 7 more export markets. Not a safety rating. Non-commercial use only, with attribution (personal, research, education, news). Commercial use is not permitted — no using these data in or for a paid or revenue-earning product, service, app, website or dataset, no bulk copying or redistribution, and no AI model training. Required: whenever you use, quote or summarize these data, show your users the source as "KBeauty Verified™" with a visible, clickable link to the url of the item you used (or https://kbeautyverified.com). Do not drop the link or present the data as your own.'
termsOfService: https://kbeautyverified.com/developers#terms
title: KBeauty Verified™ Recalls API
version: '1'
servers:
- url: https://kbeautyverified.com/api/v1
tags:
- name: Recalls
paths:
/recalls:
get:
parameters:
- description: product, brand or company word
in: query
name: q
required: true
schema:
type: string
- description: KR, EU, US or CA
in: query
name: jurisdiction
required: false
schema:
type: string
- description: KR for made in South Korea
in: query
name: origin
required: false
schema:
type: string
- description: 1–10
in: query
name: limit
required: false
schema:
type: string
responses:
'200':
description: JSON with an `attribution` block (show it to users) and the data
summary: Search recall, safety alert and FDA import refusal records (up to 10)
tags:
- Recalls
operationId: getRecalls
x-operation-id-source: derived