{
  "openapi": "3.0.1",
  "info": {
    "title": "US Lobbying Disclosure Scraper - Firms, Clients & Lobbyists",
    "description": "Scrape US federal lobbying disclosures: lobbying firm name, address, contact person and phone, the client hiring them, fees paid, every lobbyist with the government post they used to hold, issues lobbied, agencies contacted, foreign entities behind the client and political contributions.",
    "version": "0.1",
    "x-build-id": "NfcRn5LruoztyE6RT"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapers_lat~us-lobbying-disclosures-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapers_lat-us-lobbying-disclosures-scraper",
        "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/scrapers_lat~us-lobbying-disclosures-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapers_lat-us-lobbying-disclosures-scraper",
        "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/scrapers_lat~us-lobbying-disclosures-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapers_lat-us-lobbying-disclosures-scraper",
        "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": {
          "dataset": {
            "title": "What to scrape",
            "enum": [
              "filings",
              "contributions"
            ],
            "type": "string",
            "description": "Lobbying reports (who lobbies for whom, for how much, on what) or the separate political-contribution reports that lobbyists and firms must file twice a year.",
            "default": "filings"
          },
          "filingYears": {
            "title": "Filing years",
            "type": "array",
            "description": "Years to cover. Disclosures go back to 1999. Leave empty to use the current year.",
            "default": [
              "2026"
            ],
            "items": {
              "type": "string"
            }
          },
          "filingPeriod": {
            "title": "Reporting period",
            "enum": [
              "",
              "first_quarter",
              "second_quarter",
              "third_quarter",
              "fourth_quarter",
              "mid_year",
              "year_end"
            ],
            "type": "string",
            "description": "Restrict to one quarter (lobbying reports) or half-year (contribution reports).",
            "default": ""
          },
          "filingType": {
            "title": "Report type",
            "type": "string",
            "description": "Optional report-type code, e.g. RR (new registration), Q1/Q2/Q3/Q4 (quarterly report), Q1A (amended quarterly), RT (termination), MM / YY (contribution reports)."
          },
          "clientName": {
            "title": "Client name contains",
            "type": "string",
            "description": "The organisation that hired the lobbyists, e.g. \"Boeing\", \"Pfizer\", \"OpenAI\"."
          },
          "registrantName": {
            "title": "Lobbying firm name contains",
            "type": "string",
            "description": "The registered lobbying firm or in-house filer, e.g. \"Akin Gump\", \"Brownstein\"."
          },
          "lobbyistName": {
            "title": "Lobbyist name contains",
            "type": "string",
            "description": "Find every report naming a particular lobbyist."
          },
          "coveredPosition": {
            "title": "Former government position contains",
            "type": "string",
            "description": "Revolving-door search: match the government job a lobbyist previously held, e.g. \"Senator\", \"Chief of Staff\", \"Department of Defense\"."
          },
          "issueText": {
            "title": "Lobbying issue text contains",
            "type": "string",
            "description": "Free-text search across the specific issues described in the reports, e.g. \"artificial intelligence\", \"tariffs\", \"Medicare reimbursement\"."
          },
          "clientState": {
            "title": "Client state",
            "type": "string",
            "description": "Two-letter US state code of the client, e.g. CA."
          },
          "clientCountry": {
            "title": "Client country",
            "type": "string",
            "description": "Two-letter country code of the client, e.g. JP - useful to surface foreign-backed lobbying."
          },
          "registrantCountry": {
            "title": "Lobbying firm country",
            "type": "string",
            "description": "Two-letter country code of the registered filer, e.g. US."
          },
          "minAmount": {
            "title": "Minimum reported amount (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only reports with income or expenses at or above this figure - a fast way to isolate the big-money engagements."
          },
          "postedAfter": {
            "title": "Posted on or after",
            "type": "string",
            "description": "Only reports posted on or after this date (YYYY-MM-DD)."
          },
          "postedBefore": {
            "title": "Posted on or before",
            "type": "string",
            "description": "Only reports posted on or before this date (YYYY-MM-DD)."
          },
          "onlyRevolvingDoor": {
            "title": "Only reports with ex-government lobbyists",
            "type": "boolean",
            "description": "Keep only reports where at least one named lobbyist previously held a covered government position.",
            "default": false
          },
          "onlyWithForeignEntities": {
            "title": "Only reports naming foreign entities",
            "type": "boolean",
            "description": "Keep only reports that disclose a foreign government, company or interest behind the client.",
            "default": false
          },
          "onlyWithContactPhone": {
            "title": "Only reports with a contact phone",
            "type": "boolean",
            "description": "Keep only reports where the filer published a contact person's telephone number.",
            "default": false
          },
          "excludeInHouse": {
            "title": "Exclude in-house lobbying",
            "type": "boolean",
            "description": "Drop reports where a company lobbies for itself, keeping only outside lobbying firms and their clients.",
            "default": false
          },
          "onlyWithContributions": {
            "title": "Only contribution reports with donations",
            "type": "boolean",
            "description": "Contribution reports only: skip the many \"no contributions to report\" filings.",
            "default": false
          },
          "maxResults": {
            "title": "Maximum results",
            "minimum": 1,
            "maximum": 200000,
            "type": "integer",
            "description": "How many records to return. Free Apify plans are capped at 10 per run.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}