How can I see which fields are available in the Product Hunt GraphQL API?

[alexcloudstar]

Hi,

I’m using the Product Hunt GraphQL API for a personal, non-commercial project and I’m having trouble discovering which fields and connections are actually available in the schema.

When testing in Postman, many fields are not obvious until they error out (for example User.comments, root comments, etc.).

Is there:

An official way to inspect the GraphQL schema (introspection, schema reference, playground)?

A recommended way to explore available fields without trial-and-error queries?

I’ve checked the docs but still feel like I’m guessing in the dark.

Thanks in advance.

Alex

[mmc102]

https://graph-api-explorer-gh53.vercel.app/

can you let us know if this works? it should have the schema explorer on the left under the docs icon.

edit to add: we may not support the page linked in the long term, but i believe the graphql schema for the public api should allow introspection, so you can generated the docs programmatically with various tools available online.

[maciesielka]

When testing in Postman, many fields are not obvious until they error out (for example User.comments, root comments, etc.).

@alexcloudstar Postman should have pretty rich support for this out-of-the-box too since our API does support introspection. Check out the Postman docs for working with GraphQL in their interface and make sure to authenticate your request as described in our docs for it to work appropriately.

That should enable Postman to provide you both inline documentation and autocomplete as you build your queries.

[alexcloudstar]

When testing in Postman, many fields are not obvious until they error out (for example User.comments, root comments, etc.).

@alexcloudstar Postman should have pretty rich support for this out-of-the-box too since our API does support introspection. Check out the Postman docs for working with GraphQL in their interface and make sure to authenticate your request as described in our docs for it to work appropriately.

That should enable Postman to provide you both inline documentation and autocomplete as you build your queries.

Thank you!

I'll give it a try!

[alexcloudstar]

Yes everything is working.

However, I opened another issue. Don't know if it was the right thing to do or follow-up here