REST API References Welcome to the Anything World API!
You can use the Anything World's API in your application to request 3D models and other data based on different search criteria.
API reference
API key
After generating the API key in our Dashboard, the API key can be used to authorize requests to the Anything World's API.
Bear in mind that many endpoints require the API to generate results.
General Format
Copy https://api.anything.world/anything?key=<API_KEY>&name=<NAME>
Example
Copy https://api.anything.world/anything?key=<API_KEY>&name=bird
The API is currently experimental and is subject to change. For use in a critical production environment, please reach out to us at hello@anything.world.
​Get a specific model by name
GET
https://api.anything.world/anything?key=<API_KEY>&name=<NAME>
Retrieve a single model (JSON response) based on its name. If there is an exact match it will be returned, otherwise a similar result (if found), or no model otherwise.
Query Parameters
Whether to enable approximate matching (true by default)
200 A model was found and returned
Copy {
"_id": "5e958b911c9d440000f9771d",
"name": "dog",
"creature": "dog",
"group": "mammals",
"type": "quadruped",
"behaviour": "walk",
"pet": true,
"detail": "medium",
"model": {
"parts": {
"body": "https://assets.anything.world/dog/body.obj?Expires=1629890114&KeyName=models&Signature=phbXMpLsJBzNDTXQAdJW7phnvSg",
"head": "https://assets.anything.world/dog/head.obj?Expires=1629890114&KeyName=models&Signature=h6t0BWNXhCoB3DXP0-eNnKULCJQ",
"leg_front_left_bot": "https://assets.anything.world/dog/leg_front_left_bot.obj?Expires=1629890114&KeyName=models&Signature=K9W3wfPT9WhpCH6jZXRRnVMN7G4",
"leg_front_left_top": "https://assets.anything.world/dog/leg_front_left_top.obj?Expires=1629890114&KeyName=models&Signature=AfTkg0KIlEWw-CFtJM0yLcrVVCw",
"leg_front_right_bot": "https://assets.anything.world/dog/leg_front_right_bot.obj?Expires=1629890114&KeyName=models&Signature=TcYVhFISHsV1FWtu0OVdSe0rYQU",
"leg_front_right_top": "https://assets.anything.world/dog/leg_front_right_top.obj?Expires=1629890114&KeyName=models&Signature=GP8CokHpOUM93kbzv9rhWWWrAxY",
"leg_hind_left_bot": "https://assets.anything.world/dog/leg_hind_left_bot.obj?Expires=1629890114&KeyName=models&Signature=Xit_bZ8J7IiVY8EqO4cQLw-7twU",
"leg_hind_left_top": "https://assets.anything.world/dog/leg_hind_left_top.obj?Expires=1629890114&KeyName=models&Signature=2PASF7b7Tj-JPARj80hPAzuxohM",
"leg_hind_right_bot": "https://assets.anything.world/dog/leg_hind_right_bot.obj?Expires=1629890114&KeyName=models&Signature=OqWkuXy9sqiOcpqd9vGBb8PNAOo",
"leg_hind_right_top": "https://assets.anything.world/dog/leg_hind_right_top.obj?Expires=1629890114&KeyName=models&Signature=c7ZU1jQz-GyamcYyjVYlaPfjpcM",
"tail": "https://assets.anything.world/dog/tail.obj?Expires=1629890114&KeyName=models&Signature=CBsGk-k-zL096jbaCdip7Rr0tt8"
},
"other": {
"material": "https://assets.anything.world/dog/dog.mtl?Expires=1629890114&KeyName=models&Signature=y7vPL9ZbY0QJwLZuVGkThNBu8x0",
"model": "https://assets.anything.world/dog/dog.obj?Expires=1629890114&KeyName=models&Signature=qnIGLYo3mXN2NnVMhuWOBMxxKOU",
"texture": [
"https://assets.anything.world/dog/basecolor.png?Expires=1629890114&KeyName=models&Signature=oNIXgYIHMletKl009yrow_zkAHk"
],
"reference": "https://assets.anything.world/dog/reference.png?Expires=1629890114&KeyName=models&Signature=EF1MrK08ZLGpguI_8r-kCwysWcM"
}
},
"author": "Poly by Google",
"source": "AW-API",
"forest": false,
"beach": false,
"city": true,
"desert": false,
"farm": false,
"sea": false,
"icescape": false,
"jungle": false,
"lake": false,
"pond": false,
"river": false,
"swamp": false,
"grass": false,
"rural": true,
"urban": false,
"garden": true,
"scale": {
"height": "1.2m"
},
"source_endpoint": "aw_api"
}
400: Bad Request Incorrect format
403: Forbidden Missing API key
Get all models matching the query
GET
https://api.anything.world/anything?key=<API_KEY>&search=<QUERY>
Get a JSON array representing all models that matched the query string, which can be anything, such as a name (e.g. "cat"), a tag (e.g. "Christmas"), a habitat (e.g. "jungle" or "desert") or a taxonomical category (e.g. "animal" or "object").
Query Parameters
Whether approximate matches are returned (default is true)
200: OK Models are found and returned
400: Bad Request Incorrect format
403: Forbidden Invalid or missing API key
404: Not Found No model found