Skip to content

What is GraphQL?

GraphQL is a type of JSON API that lets you decide what fields you would like to fetch.

Note that:

  • there is only one HTTP method: POST
  • there is only one endpoint URL: https://cults3d.com/graphql
  • you pass a query string that represents the data you would like to receive in the GraphQL format
  • you get JSON back matching each field of each type you asked for

Authorization

All calls are made using HTTP Basic Auth with the credentials you have been given.

Try it out

Use the graphical explorer to browse and test the API. The documentation on the right shows you all available data you can query.

Example call

Here is an example command line call using curl:

curl https://cults3d.com/graphql -u your_username:your_password -d'query={
  creations(limit: 1) {
    name
    url
    creator {
      nick
    }
  }
}'

The JSON data that comes out is in the same format as the query:

{
  "data": {
    "creations": [
      {
        "name": "frame wall hanger ",
        "url": "https://cults3d.com/en/3d-model/art/frame-wall-hanger-f745834a-4835-4db9-b28c-d1dff7bd4d64",
        "creator": {
          "nick": "3DPrinterFiles"
        }
      }
    ]
  }
}