{"openapi":"3.1.0","info":{"title":"One Piece API","version":"1.0.0","description":"The world of One Piece as an API — the characters, pirate crews and Devil Fruits of Eiichiro Oda's saga. Look up a character by id or name (e.g. Monkey D. Luffy → 3,000,000,000 berry bounty, captain of the Straw Hat Pirates, user of the Hito Hito no Mi, Model: Nika), browse the pirate crews with their total bounty, member count and Yonko status, and search the Devil Fruits by name for their type (Paramecia, Zoan, Logia) and powers. Backed by the open api-onepiece.com dataset. Ideal for fan sites, trivia and quiz games, bounty and crew trackers, Discord bots and any One Piece app.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/onepiece-api","description":"oanor gateway"}],"tags":[{"name":"One Piece"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/character":{"get":{"operationId":"get_v1_character","tags":["One Piece"],"summary":"A character by id or name","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Character id, e.g. 1 (Luffy)","schema":{"type":"string"},"example":"1"},{"name":"name","in":"query","required":false,"description":"Name search, e.g. luffy","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"character":{"id":1,"age":"19 ans","job":"Captain","crew":"The Chapeau de Paille crew","name":"Monkey D Luffy","size":"174cm","fruit":"Hito Hito no Mi, Nika model","bounty":"3.000.000.000","status":"vivant"}},"meta":{"timestamp":"2026-06-01T00:04:24.708Z","request_id":"48ac69df-ec67-4b69-a3c8-5bb3a5e49bf0"},"status":"ok","message":"Character retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/crew":{"get":{"operationId":"get_v1_crew","tags":["One Piece"],"summary":"A pirate crew by id or name","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Crew id, e.g. 1","schema":{"type":"string"},"example":"1"},{"name":"name","in":"query","required":false,"description":"Name search, e.g. straw","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"crew":{"id":1,"name":"The Chapeau de Paille crew","status":"assets","is_yonko":true,"roman_name":"Mugiwara no Ichimi","member_count":"10","total_bounty":"3.161.000.100"}},"meta":{"timestamp":"2026-06-01T00:04:24.895Z","request_id":"6e69d37e-83ff-47c6-864d-5e7ac4d3e1e9"},"status":"ok","message":"Crew retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/fruit":{"get":{"operationId":"get_v1_fruit","tags":["One Piece"],"summary":"A Devil Fruit by id or name","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Fruit id, e.g. 1","schema":{"type":"string"},"example":"1"},{"name":"name","in":"query","required":false,"description":"Name search, e.g. gum","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"fruit":{"id":1,"name":"Gum-Gum Fruit","type":"Paramecia","roman_name":"Gomu Gomu no Mi","description":"Gomu Gomu no Mi, also known as the Fruit of Gum-Gum in French, is a Paramecia-type Demon Fruit that imparts the same properties as rubber to its user's body, making the eater an Elastic Man (ゴム人間, Gomu Ningen). This was once a treasure that Shanks and his crew had taken from a World Government convoy, protected by CP9, but which was accidentally eaten by Monkey D. Luffy"}},"meta":{"timestamp":"2026-06-01T00:04:25.149Z","request_id":"6d07050b-8ca8-405a-aa97-fb5225f13283"},"status":"ok","message":"Fruit retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The world of One Piece. /v1/character = a character by id or name search (e.g. id=1 → Monkey D. Luffy, bounty, crew, Devil Fruit, job, status); /v1/crew = a pirate crew by id or name (description, total bounty, Yonko status); /v1/fruit = a Devil Fruit by id or name (type, description). Pass id= for an exact record or name= to search.","source":"api-onepiece.com","endpoints":["/v1/character","/v1/crew","/v1/fruit","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:04:25.218Z","request_id":"132f3891-df61-4c00-8139-b27ee65d1427"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10400,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":290,"monthly_call_quota":150000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1020,"monthly_call_quota":680000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3180,"monthly_call_quota":2790000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/onepiece-api"}