{
  "openapi": "3.0.1",
  "info": {
    "title": "Crypto News Scraper API - Bitcoin & Altcoin News as JSON",
    "description": "Crypto and blockchain news as clean JSON. Follow any coin, exchange or protocol and get the real publisher URL for every article, optional full body text, and syndication dedupe so one story is one row. Historical archive included. Pay per article, failed runs are free.",
    "version": "1.0",
    "x-build-id": "SwHMLAWt0swIIb4zD"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/vonsensey~crypto-news-scraper-api/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-vonsensey-crypto-news-scraper-api",
        "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/vonsensey~crypto-news-scraper-api/runs": {
      "post": {
        "operationId": "runs-sync-vonsensey-crypto-news-scraper-api",
        "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/vonsensey~crypto-news-scraper-api/run-sync": {
      "post": {
        "operationId": "run-sync-vonsensey-crypto-news-scraper-api",
        "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",
        "properties": {
          "queries": {
            "title": "Search queries",
            "type": "array",
            "description": "Keywords to search Google News for. Supports Google operators: \"exact phrase\", tesla OR rivian, tesla -musk, intitle:tesla, site:reuters.com. One row is returned per article found.",
            "default": [
              "bitcoin OR ethereum",
              "crypto regulation"
            ],
            "items": {
              "type": "string"
            }
          },
          "archiveDays": {
            "title": "Archive depth (days)",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Go back this many days to break Google's 100-article-per-feed ceiling. The query is split into consecutive date windows and each is fetched separately, so 30 days can return thousands of articles instead of 100. Leave at 0 for a single latest-news pull. Applies to search and publisher inputs only.",
            "default": 0
          },
          "windowDays": {
            "title": "Days per archive window",
            "minimum": 1,
            "maximum": 90,
            "type": "integer",
            "description": "Size of each date window when Archive depth is set. 1 gives the deepest coverage (up to ~100 articles per day); raise it for broad topics with fewer daily articles to save requests.",
            "default": 1
          },
          "maxItems": {
            "title": "Maximum articles",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on billable article rows for this run. The run stops as soon as it is reached.",
            "default": 100
          },
          "maxCostUsd": {
            "title": "Maximum run cost (USD)",
            "type": "string",
            "description": "Optional spend ceiling for this run. The run stops cleanly before exceeding it. Leave empty for no ceiling."
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Google News interface language, e.g. en, de, fr, ja, sv, pt-BR. Controls which language the articles are returned in.",
            "default": "en"
          },
          "country": {
            "title": "Country edition",
            "type": "string",
            "description": "Two-letter country code for the Google News edition, e.g. US, GB, DE, IN, SE. Controls which regional outlets appear.",
            "default": "US"
          },
          "resolvePublisherUrls": {
            "title": "Resolve real publisher URLs",
            "type": "boolean",
            "description": "Turn Google's encoded news.google.com/rss/articles/CBMi... redirect into the real article URL on the publisher's own domain. On by default — this is what makes the output usable.",
            "default": true
          },
          "fetchArticleText": {
            "title": "Fetch full article text",
            "type": "boolean",
            "description": "Also fetch each publisher page and extract the full body text, author, image and canonical URL. Slower, and billed as a separate event — but only when text is actually returned. Paywalled and blocked pages cost nothing extra.",
            "default": false
          },
          "analyzeSentiment": {
            "title": "Sentiment analysis",
            "type": "boolean",
            "description": "Score each article positive / negative / neutral using VADER, the standard lexicon for short news text (it handles negation, so \"not doing badly\" reads positive). Free - no extra charge. English only: other languages return null rather than a score computed from an English word list.",
            "default": true
          },
          "dedupeSyndicated": {
            "title": "Collapse syndicated duplicates",
            "type": "boolean",
            "description": "One wire story often runs across dozens of outlets. Turn this on to return one row per story, with the other outlets listed in republishedBy — so you pay once for a story instead of forty times.",
            "default": true
          },
          "includeDuplicates": {
            "title": "Also return the collapsed copies",
            "type": "boolean",
            "description": "When collapsing syndicated duplicates, still emit the duplicate rows (tagged with duplicateOfId) instead of dropping them. Only applies when the option above is on.",
            "default": false
          },
          "topics": {
            "title": "Topics",
            "type": "array",
            "description": "Google News topic sections: WORLD, NATION, BUSINESS, TECHNOLOGY, ENTERTAINMENT, SPORTS, SCIENCE, HEALTH. Opaque topic IDs from a Google News URL (CAAqJggK...) also work.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Local news editions by place name, e.g. London, New York, Berlin. Returns the local headlines Google curates for that place.",
            "items": {
              "type": "string"
            }
          },
          "publishers": {
            "title": "Publisher domains",
            "type": "array",
            "description": "Restrict results to specific outlets. Accepts reuters.com, www.reuters.com or a full URL. Use this to monitor a defined media set.",
            "items": {
              "type": "string"
            }
          },
          "publisherQuery": {
            "title": "Keyword filter for publishers",
            "type": "string",
            "description": "Optional keyword applied to the publisher domains above, e.g. \"earnings\" to get only earnings coverage from those outlets."
          },
          "includeTopHeadlines": {
            "title": "Include top headlines",
            "type": "boolean",
            "description": "Add Google News' main front-page headlines for the selected language and country.",
            "default": false
          },
          "concurrency": {
            "title": "Concurrency",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many requests to run in parallel. The default is tuned for speed without tripping rate limits; lower it only if you see errors.",
            "default": 20
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. Google News is reachable without a proxy from Apify, so leaving this off is both faster and cheaper. Enable it only if you need requests to originate from a specific country.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}