Choose a version:

article

query

Returns a Article resource by ID.

Anchor to Arguments

Arguments

Anchor to idid •ID! required: The ID of the Article to return.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to ArticleArticle •Article: An article in the blogging system.

Was this section helpful?

Examples

Receive a single Article

Query

query ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } }

Variables

{ "id": "gid://shopify/Article/959752435" }

cURL

curl -X POST \ https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } }", "variables": { "id": "gid://shopify/Article/959752435" } }'

React Router

import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } }`, { variables: { "id": "gid://shopify/Article/959752435" }, }, ); const json = await response.json(); return json.data; }

Ruby

session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } } QUERY variables = { "id": "gid://shopify/Article/959752435" } response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `query ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } }`, "variables": { "id": "gid://shopify/Article/959752435" }, }, });

Response

{ "article": { "id": "gid://shopify/Article/959752435", "author": { "name": "dennis" }, "createdAt": "2012-01-01T00:00:00Z", "handle": "you-should-buy-this" } }

Receive a single Article

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

query ArticleShow($id: ID!) {

article(id: $id) {

author {

name

}

createdAt

handle

}

}`,

{

variables: {

"id": "gid://shopify/Article/959752435"

);

const json = await response.json();

return json.data;

}

GQL

query ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } }

cURL

curl -X POST \ https://your-development-store.myshopify.com/admin/api/unstable/graphql.json \ -H 'Content-Type: application/json' \ -H 'X-Shopify-Access-Token: {access_token}' \ -d '{ "query": "query ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } }", "variables": { "id": "gid://shopify/Article/959752435" } }'

React Router

import { authenticate } from "../shopify.server"; export const loader = async ({request}) => { const { admin } = await authenticate.admin(request); const response = await admin.graphql( `#graphql query ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } }`, { variables: { "id": "gid://shopify/Article/959752435" }, }, ); const json = await response.json(); return json.data; }

Node.js

const client = new shopify.clients.Graphql({session}); const data = await client.query({ data: { "query": `query ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } }`, "variables": { "id": "gid://shopify/Article/959752435" }, }, });

Ruby

session = ShopifyAPI::Auth::Session.new( shop: "your-development-store.myshopify.com", access_token: access_token ) client = ShopifyAPI::Clients::Graphql::Admin.new( session: session ) query = <<~QUERY query ArticleShow($id: ID!) { article(id: $id) { id author { name } createdAt handle } } QUERY variables = { "id": "gid://shopify/Article/959752435" } response = client.query(query: query, variables: variables)

Input variables

JSON

{

"id": "gid://shopify/Article/959752435"

}

Response

JSON

{

"article": {

"id": "gid://shopify/Article/959752435",

"author": {

"name": "dennis"

"createdAt": "2012-01-01T00:00:00Z",

"handle": "you-should-buy-this"

}