{ "openapi": "3.0.1", "info": { "title": "GraphQL Endpoint Extractor", "description": "Point at ANY GraphQL endpoint: send a raw query (+ optional variables & headers) and flatten the chosen data path into dataset rows plus a lossless raw object — or introspect the schema to discover its types. Works with public or token-gated GraphQL APIs. Pay per record.", "version": "0.1", "x-build-id": "tDaRewurOyx8dltLl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datamule~graphql-endpoint-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datamule-graphql-endpoint-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/datamule~graphql-endpoint-extractor/runs": { "post": { "operationId": "runs-sync-datamule-graphql-endpoint-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/datamule~graphql-endpoint-extractor/run-sync": { "post": { "operationId": "run-sync-datamule-graphql-endpoint-extractor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "endpoint" ], "properties": { "endpoint": { "title": "GraphQL endpoint URL", "type": "string", "description": "The URL of ANY GraphQL endpoint (the single POST URL, usually ending in /graphql). Examples: https://rickandmortyapi.com/graphql , https://countries.trevorblades.com/graphql , or your own API's GraphQL endpoint. For token-gated APIs, add the Authorization header in \"Request headers\" below." }, "query": { "title": "GraphQL query", "type": "string", "description": "The raw GraphQL query (or mutation) string to send, e.g. { characters { results { id name status species } } }. Required unless \"Introspect schema\" is enabled below. Use \"Query variables\" for parameterized queries. This is a single-query runner — put any pagination arguments (first/after/offset/page) directly in the query + variables." }, "variables": { "title": "Query variables", "type": "object", "description": "Optional GraphQL variables as a JSON object, e.g. {\"page\": 2, \"filter\": {\"status\": \"Alive\"}}. Reference them in the query with $page etc. Leave empty if your query takes no variables." }, "dataPath": { "title": "Data path (row selector)", "type": "string", "description": "Dot-path from the response root to the array (or object) to turn into rows, e.g. data.characters.results or data.countries. Leave EMPTY to auto-detect the first array under data (and if there is none, the whole data object becomes one row). Numeric segments index into arrays, e.g. data.search.edges.0.node." }, "introspect": { "title": "Introspect schema (discovery)", "type": "boolean", "description": "When on, ignore the query and run the standard GraphQL introspection query instead, emitting one row per schema type (name, kind, description, field count) so you can discover what an endpoint exposes. Some servers disable introspection — then this returns 0 rows.", "default": false }, "maxRecords": { "title": "Max records", "minimum": 1, "type": "integer", "description": "Optional cap on the number of rows emitted from the response. Each emitted row is one billable record. Leave empty to emit every row the single query returns (GraphQL has no built-in pagination, so the server response already bounds this)." }, "headers": { "title": "Request headers", "type": "object", "description": "Optional extra HTTP headers to send with the request, as a JSON object, e.g. {\"Authorization\": \"Bearer \", \"X-API-Key\": \"...\"} for gated endpoints. Not required for public APIs. Header values are never logged." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }