{"id":1015,"date":"2023-11-02T17:23:59","date_gmt":"2023-11-02T17:23:59","guid":{"rendered":"https:\/\/blog.fusionmetrics.io\/?p=1015"},"modified":"2024-07-09T19:16:22","modified_gmt":"2024-07-09T19:16:22","slug":"how-to-use-the-shopify-partner-api","status":"publish","type":"post","link":"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/","title":{"rendered":"How to use the Shopify Partner API"},"content":{"rendered":"\n

The Shopify Partner API<\/a> allows you to extract app performance data from Shopify itself. Like all new Shopify API it uses GraphQL. Currently, there the API can only be with a manually generated token.<\/p>\n\n\n\n

The process of token creation is straight forward and only requires access to the Shopify partners admin section. You can find the option under Settings -> Partner API clients -> Manage Partner API Clients.<\/p>\n\n\n\n

Then you have the option to give your new token a name so you can remember what it was used for.<\/p>\n\n\n\n

Generally it is always recommended to generate a new token for each use.<\/p>\n\n\n\n

Permissions<\/h2>\n\n\n\n

To have complete access to the financial transactions and to be able to see app events we should use the following permissions:<\/p>\n\n\n\n

View financials: This permission gives access all Transaction resources.<\/p>\n\n\n\n

Manage apps: This permission allows to access App resources, including all app-related events such as installs, uninstalls, and charges.<\/p>\n\n\n\n

All permissions apply to the complete partner account and not to a specific app.<\/p>\n\n\n\n

Besides the token, we also need to know our partner ID, which is the number in the URL after you log in to your partners account.<\/p>\n\n\n\n

If the URL is for example https:\/\/partners.shopify.com\/1491901<\/code> – 1491901<\/strong> is your Partner ID<\/p>\n\n\n\n

Sending your first API Query<\/h2>\n\n\n\n

Now with the token and the partner ID we are ready to use the Shopify Partner API. I recommend using a API client like Insomnia to to do this. Here we need to set up a few things:<\/p>\n\n\n\n

URL: https:\/\/partners.shopify.com\/partner_id<\/strong>\/api\/2023-07\/graphql.json<\/code> with partner_id<\/strong> as your ID from before<\/p>\n\n\n\n

Request Type: POST<\/p>\n\n\n\n

Content: GraphQL<\/p>\n\n\n\n

Now under authentication, create a new header field called X-Shopify-Access-Token. Set the token you have generated as a value for the field. Now that we are ready to make our first GraphQL request:<\/p>\n\n\n\n

<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
query<\/span>  <\/span>{<\/span><\/span>\n  transactions(<\/span><\/span>\n    <\/span>first<\/span>:<\/span> <\/span>3<\/span><\/span>\n  ) <\/span>{<\/span><\/span>\n    edges <\/span>{<\/span><\/span>\n      node <\/span>{<\/span><\/span>\n        __typename<\/span><\/span>\n        id<\/span><\/span>\n        createdAt<\/span><\/span>\n        <\/span>...<\/span> <\/span>on<\/span> <\/span>AppSubscriptionSale<\/span> <\/span>{<\/span><\/span>\n            chargeId<\/span><\/span>\n            app <\/span>{<\/span><\/span>\n                id<\/span><\/span>\n                name<\/span><\/span>\n            <\/span>}<\/span><\/span>\n            shop <\/span>{<\/span><\/span>\n                myshopifyDomain<\/span><\/span>\n                id<\/span><\/span>\n            <\/span>}<\/span><\/span>\n            netAmount <\/span>{<\/span><\/span>\n                amount<\/span><\/span>\n                currencyCode<\/span><\/span>\n            <\/span>}<\/span><\/span>\n        <\/span>}<\/span><\/span>\n        <\/span>...<\/span> <\/span>on<\/span> <\/span>AppUsageSale<\/span> <\/span>{<\/span><\/span>\n            chargeId<\/span><\/span>\n            app <\/span>{<\/span><\/span>\n              id<\/span><\/span>\n              name<\/span><\/span>\n            <\/span>}<\/span><\/span>\n            shop <\/span>{<\/span><\/span>\n              myshopifyDomain<\/span><\/span>\n              id<\/span><\/span>\n            <\/span>}<\/span><\/span>\n            netAmount <\/span>{<\/span><\/span>\n                amount<\/span><\/span>\n                currencyCode<\/span><\/span>\n            <\/span>}<\/span><\/span>\n        <\/span>}<\/span><\/span>\n      <\/span>}<\/span><\/span>\n      cursor<\/span><\/span>\n    <\/span>}<\/span><\/span>\n    pageInfo <\/span>{<\/span><\/span>\n      hasNextPage  <\/span><\/span>\n    <\/span>}<\/span><\/span>\n  <\/span>}<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
This request give the newest 3 financial transaction that were created by merchants with our apps in JSON format as is standard with GraphQL.<\/p>\n\n\n\n
Towards the end of the response you can see that pageInfo.hasNextPage is true, which means the API is ready of offer us more records.<\/p>\n\n\n\n
They can be fetched by passing the last cursor as the before argument in the GraphQL query. If you are curious if the cursors contain more information, go ahead an try to decode them using base64. For the sake of using the Shopify Partner API, it is enough to use them the way they are.<\/p>\n\n\n\n
Next Steps<\/h2>\n\n\n\n
In this brief introduction to the Shopify Partner API I’m only going into the financial transaction. We can however also get app events like installs, uninstalls and plan names from the partner API. For businesses seeking comprehensive solutions and advanced Shopify integrations, partnering with a professional Shopify Plus development agency<\/a><\/strong> can provide the expertise and resources needed to fully leverage the Shopify Partner API, ensuring seamless functionality and enhanced performance.<\/p>\n\n\n\n
Alternatively you can also use Fusionmetrics to get this information in a visual form and ready to explore with a no-code setup.<\/p>\n","protected":false},"excerpt":{"rendered":"
The Shopify Partner API allows you to extract app performance data from Shopify itself. Like all new Shopify API it uses GraphQL. Currently, there the API can only be with a manually generated token. The process of token creation is straight forward and only requires access to the Shopify partners admin section. You can find …<\/p>\n
  How to use the Shopify Partner API<\/span> Read More »<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"default","ast-global-header-display":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","footnotes":""},"categories":[27],"tags":[],"class_list":["post-1015","post","type-post","status-publish","format-standard","hentry","category-general"],"yoast_head":"\nHow to use the Shopify Partner API - Fusionmetrics<\/title>\n<meta name=\"description\" content=\"Shows how to use the Shopify Partner API to see financial data and app events of your Shopify apps with code samples.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to use the Shopify Partner API - Fusionmetrics\" \/>\n<meta property=\"og:description\" content=\"Shows how to use the Shopify Partner API to see financial data and app events of your Shopify apps with code samples.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/\" \/>\n<meta property=\"og:site_name\" content=\"Fusionmetrics\" \/>\n<meta property=\"article:published_time\" content=\"2023-11-02T17:23:59+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2024-07-09T19:16:22+00:00\" \/>\n<meta name=\"author\" content=\"Alexander\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Alexander\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/\",\"url\":\"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/\",\"name\":\"How to use the Shopify Partner API - Fusionmetrics\",\"isPartOf\":{\"@id\":\"https:\/\/blog.fusionmetrics.io\/#website\"},\"datePublished\":\"2023-11-02T17:23:59+00:00\",\"dateModified\":\"2024-07-09T19:16:22+00:00\",\"author\":{\"@id\":\"https:\/\/blog.fusionmetrics.io\/#\/schema\/person\/ce1b2a80f2db4655316279ddce38945b\"},\"description\":\"Shows how to use the Shopify Partner API to see financial data and app events of your Shopify apps with code samples.\",\"breadcrumb\":{\"@id\":\"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/blog.fusionmetrics.io\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to use the Shopify Partner API\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/blog.fusionmetrics.io\/#website\",\"url\":\"https:\/\/blog.fusionmetrics.io\/\",\"name\":\"Fusionmetrics\",\"description\":\"Fusionmetrics Blog\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/blog.fusionmetrics.io\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/blog.fusionmetrics.io\/#\/schema\/person\/ce1b2a80f2db4655316279ddce38945b\",\"name\":\"Alexander\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/blog.fusionmetrics.io\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/5985505d9022ffee4dc31d2bfc431fe9ad660637e74685249217d8d282501d2b?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/5985505d9022ffee4dc31d2bfc431fe9ad660637e74685249217d8d282501d2b?s=96&d=mm&r=g\",\"caption\":\"Alexander\"},\"sameAs\":[\"http:\/\/34.72.163.57\"],\"url\":\"https:\/\/blog.fusionmetrics.io\/author\/admin\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"How to use the Shopify Partner API - Fusionmetrics","description":"Shows how to use the Shopify Partner API to see financial data and app events of your Shopify apps with code samples.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/","og_locale":"en_US","og_type":"article","og_title":"How to use the Shopify Partner API - Fusionmetrics","og_description":"Shows how to use the Shopify Partner API to see financial data and app events of your Shopify apps with code samples.","og_url":"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/","og_site_name":"Fusionmetrics","article_published_time":"2023-11-02T17:23:59+00:00","article_modified_time":"2024-07-09T19:16:22+00:00","author":"Alexander","twitter_card":"summary_large_image","twitter_misc":{"Written by":"Alexander","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/","url":"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/","name":"How to use the Shopify Partner API - Fusionmetrics","isPartOf":{"@id":"https:\/\/blog.fusionmetrics.io\/#website"},"datePublished":"2023-11-02T17:23:59+00:00","dateModified":"2024-07-09T19:16:22+00:00","author":{"@id":"https:\/\/blog.fusionmetrics.io\/#\/schema\/person\/ce1b2a80f2db4655316279ddce38945b"},"description":"Shows how to use the Shopify Partner API to see financial data and app events of your Shopify apps with code samples.","breadcrumb":{"@id":"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/blog.fusionmetrics.io\/how-to-use-the-shopify-partner-api\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/blog.fusionmetrics.io\/"},{"@type":"ListItem","position":2,"name":"How to use the Shopify Partner API"}]},{"@type":"WebSite","@id":"https:\/\/blog.fusionmetrics.io\/#website","url":"https:\/\/blog.fusionmetrics.io\/","name":"Fusionmetrics","description":"Fusionmetrics Blog","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/blog.fusionmetrics.io\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/blog.fusionmetrics.io\/#\/schema\/person\/ce1b2a80f2db4655316279ddce38945b","name":"Alexander","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/blog.fusionmetrics.io\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/5985505d9022ffee4dc31d2bfc431fe9ad660637e74685249217d8d282501d2b?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/5985505d9022ffee4dc31d2bfc431fe9ad660637e74685249217d8d282501d2b?s=96&d=mm&r=g","caption":"Alexander"},"sameAs":["http:\/\/34.72.163.57"],"url":"https:\/\/blog.fusionmetrics.io\/author\/admin\/"}]}},"_links":{"self":[{"href":"https:\/\/blog.fusionmetrics.io\/wp-json\/wp\/v2\/posts\/1015","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.fusionmetrics.io\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.fusionmetrics.io\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.fusionmetrics.io\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.fusionmetrics.io\/wp-json\/wp\/v2\/comments?post=1015"}],"version-history":[{"count":4,"href":"https:\/\/blog.fusionmetrics.io\/wp-json\/wp\/v2\/posts\/1015\/revisions"}],"predecessor-version":[{"id":1033,"href":"https:\/\/blog.fusionmetrics.io\/wp-json\/wp\/v2\/posts\/1015\/revisions\/1033"}],"wp:attachment":[{"href":"https:\/\/blog.fusionmetrics.io\/wp-json\/wp\/v2\/media?parent=1015"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.fusionmetrics.io\/wp-json\/wp\/v2\/categories?post=1015"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.fusionmetrics.io\/wp-json\/wp\/v2\/tags?post=1015"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
Also if you are looking to reproduce the figures from your Shopify Partner Dashboard I recommend checkout out my article about this<\/a>.<\/p>\n\n\n\n