{"api_name":"Shopify","docs_url":"https://shopify.dev/docs/api/admin-rest","domain":"shopify.dev","generated_at":"2026-05-06T17:13:22.594949+00:00","agent_readiness_score":75,"certification_level":"Yoofooz Ready","category_scores":{"documentation_clarity":10,"machine_readable_spec":5,"authentication_clarity":10,"error_handling":10,"rate_limit_clarity":10,"agent_safe_workflow_support":0,"sandbox_availability":5,"webhook_event_support":10,"commercial_trust":5,"developer_experience":10},"strengths":["Documentation clarity","Authentication model clarity","Error handling and status codes","Rate-limit / quota behavior","Webhook / event support","Developer experience (SDKs, quickstart, CLI)"],"risks":["Machine-readable specification (OpenAPI/Swagger) signal is partial; clearer documentation recommended.","Agent-safe workflow primitives (idempotency, retries) signal not detected in docs.","Sandbox / test-mode availability signal is partial; clearer documentation recommended.","Commercial trust (status, SLA, compliance) signal is partial; clearer documentation recommended."],"recommended_next_steps":["Strengthen: Add or expose an OpenAPI/Swagger specification or Postman collection.","Document idempotency keys, test mode, dry runs, and safe retry semantics for agents.","Strengthen: Provide a sandbox / test mode with test API keys for safe agent testing.","Strengthen: Publish status page, SLA, and security/compliance posture (SOC 2, GDPR, PCI as applicable)."],"scoring_signals":{"docs_fetched":true,"docs_chars_used":286067,"pages_fetched":2,"candidate_pages":8,"fetched_urls":["https://shopify.dev/docs/api/admin-rest","https://shopify.dev"]},"matched_signals":{"documentation_clarity":{"score":10,"matched_terms":["getting started","request","response","examples","docs","guide","reference","overview"]},"machine_readable_spec":{"score":5,"matched_terms":["api reference","endpoints"]},"authentication_clarity":{"score":10,"matched_terms":["oauth","access token","scopes","authentication"]},"error_handling":{"score":10,"matched_terms":["error codes","400","401","403","404","409","429","500"]},"rate_limit_clarity":{"score":10,"matched_terms":["rate limit","rate limits","429","limits"]},"agent_safe_workflow_support":{"score":0,"matched_terms":[]},"sandbox_availability":{"score":5,"matched_terms":["sandbox"]},"webhook_event_support":{"score":10,"matched_terms":["webhooks","webhook","events"]},"commercial_trust":{"score":5,"matched_terms":["sla","support","changelog"]},"developer_experience":{"score":10,"matched_terms":["client libraries","sdk","cli","tutorials","dashboard"]}},"evidence_signals":{"documentation_clarity":[{"source_url":"https://shopify.dev/docs/api/admin-rest","matched_terms":["getting started","request","response","examples","docs","guide","reference","overview"],"snippet":"...apps need to request specific access scopes during the install process. only request as much data access as your app needs to work. learn more about getting started with authentication and building apps . curl remix node.js ruby copy 9 1 2 3 curl - x get \\ https :// . myshopify . com / admin / api / 2026 - 01 /..."}],"machine_readable_spec":[{"source_url":"https://shopify.dev/docs/api/admin-rest","matched_terms":["api reference","endpoints"],"snippet":"...all new public apps must be built exclusively with the graphql admin api . for details and migration steps, visit our migration guide . rest admin api reference the admin api lets you build apps and integrations that extend and enhance the shopify admin. some newer platform features may only be available in..."}],"authentication_clarity":[{"source_url":"https://shopify.dev/docs/api/admin-rest","matched_terms":["oauth","access token","scopes","authentication"],"snippet":"...all rest admin api queries require a valid shopify access token. public and custom apps created in the dev dashboard generate tokens using oauth , and custom apps made in the shopify admin are authenticated in the shopify admin . to simplify the authentication process, use one of the..."}],"error_handling":[{"source_url":"https://shopify.dev/docs/api/admin-rest","matched_terms":["error codes","400","401","403","404","409","429","500"],"snippet":"...2026-01 latest 2025-10 2025-07 2025-04 2026-01 latest overview client libraries authentication endpoints and requests rate limits status and error codes access billing customers discounts events gift cards inventory marketing event metafield mobile support online store orders plus products sales..."}],"rate_limit_clarity":[{"source_url":"https://shopify.dev/docs/api/admin-rest","matched_terms":["rate limit","rate limits","429","limits"],"snippet":"...2026-04 release candidate 2026-01 latest 2025-10 2025-07 2025-04 2026-01 latest overview client libraries authentication endpoints and requests rate limits status and error codes access billing customers discounts events gift cards inventory marketing event metafield mobile support online store orders..."}],"sandbox_availability":[{"source_url":"https://shopify.dev/docs/api/admin-rest","matched_terms":["sandbox"],"snippet":"starting april 1, 2025, all new public apps must be built exclusively with the graphql admin api ."}],"webhook_event_support":[{"source_url":"https://shopify.dev/docs/api/admin-rest","matched_terms":["webhooks","webhook","events"],"snippet":"...mobile support online store orders plus products sales channels shipping and fulfillment shopify payments store properties tender transaction webhooks deprecated api calls full index the rest admin api is a legacy api as of october 1, 2024. starting april 1, 2025, all new public apps must be built..."}],"commercial_trust":[{"source_url":"https://shopify.dev/docs/api/admin-rest","matched_terms":["sla","support"],"snippet":"...and requests rate limits status and error codes access billing customers discounts events gift cards inventory marketing event metafield mobile support online store orders plus products sales channels shipping and fulfillment shopify payments store properties tender transaction webhooks deprecated..."}],"developer_experience":[{"source_url":"https://shopify.dev/docs/api/admin-rest","matched_terms":["client libraries","cli","tutorials","dashboard"],"snippet":"...collapse sidebar rest admin api choose a version: unstable 2026-04 release candidate 2026-01 latest 2025-10 2025-07 2025-04 2026-01 latest overview client libraries authentication endpoints and requests rate limits status and error codes access billing customers discounts events gift cards inventory marketing..."}]},"ai_analysis":{"provider":"nvidia","enabled":true,"model":"meta/llama-4-maverick-17b-128e-instruct","summary":"Shopify API is Yoofooz Ready with a score of 75, excelling in documentation clarity and error handling but needing improvements in machine-readable specs and sandbox availability.","credibility_notes":["Partial OpenAPI/Swagger signal","No agent-safe workflow primitives detected","Partial sandbox/test-mode availability"],"next_actions":["Expose OpenAPI/Swagger spec or Postman collection","Document idempotency and safe retry semantics","Provide sandbox/test mode with test API keys"],"error":null}}