{ "openapi": "3.1.0", "info": { "title": "Gouda Studios Agent Tools (via Apify)", "version": "1.0.0", "description": "Pay per event, with no platform usage fee added. AI agents can pay per run through Apify agentic payments (x402, Skyfire) with no Apify account, or call the tools with an Apify API token, or through the Apify MCP server at https://mcp.apify.com. One-URL MCP endpoint for all tools: https://gouda-studios-agent-tools.vercel.app/mcp (Streamable HTTP, Apify OAuth or Bearer Apify token).", "contact": { "email": "m0f@mail.grokbot.com", "url": "https://gouda-studios-agent-tools.vercel.app" } }, "servers": [ { "url": "https://api.apify.com/v2" } ], "security": [ { "bearer": [] } ], "components": { "securitySchemes": { "bearer": { "type": "http", "scheme": "bearer", "description": "Apify API token" } } }, "paths": { "/acts/gouda_studios~sam-gov-opportunities-feed/run-sync-get-dataset-items": { "post": { "operationId": "run_sam_gov_opportunities_feed", "summary": "Run SAM.gov Contract Opportunities and return dataset items", "description": "Get new federal contract opportunities from SAM.gov as clean JSON, no API key needed. Filter by keyword, NAICS, set-aside, notice type, agency and state. Includes deadlines, days left and contracting officer contacts. Monitor mode returns only new notices. Pricing: $0.001 per run + $0.002 per opportunity.", "externalDocs": { "url": "https://apify.com/gouda_studios/sam-gov-opportunities-feed" }, "parameters": [ { "name": "timeout", "in": "query", "schema": { "type": "integer" }, "description": "Run timeout in seconds" }, { "name": "format", "in": "query", "schema": { "type": "string", "default": "json" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "string", "description": "Optional free-text search over SAM.gov notice titles and text, e.g. \"cybersecurity\" or \"janitorial services\". Leave empty to return all notices that match the other filters." }, "naicsCodes": { "type": "array", "description": "Optional list of 6-digit NAICS industry codes (strings), e.g. [\"541511\",\"541512\"]. A notice matches if it has any of them. Empty = all industries.", "default": [] }, "noticeTypes": { "type": "array", "description": "Optional list of notice type codes: o=Solicitation, k=Combined Synopsis/Solicitation, p=Presolicitation, r=Sources Sought, s=Special Notice, a=Award Notice, u=Justification, i=Intent to Bundle, g=Surplus sale. Empty = all types.", "default": [] }, "setAsides": { "type": "array", "description": "Optional small-business set-aside codes, e.g. [\"SBA\",\"8A\",\"SDVOSBC\",\"WOSB\",\"HZC\"]. Empty = any set-aside or none.", "default": [] }, "states": { "type": "array", "description": "Optional 2-letter US state codes for the place of performance, e.g. [\"VA\",\"MD\"]. Requires includeDetails=true. Empty = all locations.", "default": [] }, "agencyContains": { "type": "string", "description": "Optional case-insensitive text the agency path must contain, e.g. \"Navy\" or \"Veterans Affairs\"." }, "postedWithinDays": { "type": "integer", "description": "Only notices posted or updated in the last N days. 0 = no date limit. Use 1-7 for daily/weekly monitoring.", "default": 0 }, "minDaysUntilResponse": { "type": "integer", "description": "Optional. Skip notices whose response deadline is fewer than N days away, so you only get ones you can still bid on." }, "activeOnly": { "type": "boolean", "description": "true (default) = skip archived/inactive notices.", "default": true }, "includeDetails": { "type": "boolean", "description": "true (default) = fetch each notice for NAICS, PSC, set-aside, place of performance, full description and contacts. false = faster, fewer fields.", "default": true }, "includeContacts": { "type": "boolean", "description": "true (default) = include the contracting officer work name, email and phone published on the notice.", "default": true }, "onlyNew": { "type": "boolean", "description": "true = return only notices not delivered in an earlier run with the same filters (state is kept between runs). Use with a schedule for an alert feed.", "default": false }, "maxResults": { "type": "integer", "description": "Maximum rows to return (1-10000). You are charged per row returned, so this caps the cost: 100 rows = $0.20 at $0.002/row.", "default": 100 }, "apiKey": { "type": "string", "description": "Optional. Your own free api.sam.gov public API key; when set, the Actor reads the official SAM.gov Opportunities API instead of the public search feed." } } }, "example": { "keywords": "cybersecurity", "naicsCodes": [ "541512" ], "setAsides": [ "SBA" ], "postedWithinDays": 7, "maxResults": 25 } } } }, "responses": { "201": { "description": "Dataset items", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "noticeId": { "description": "" }, "title": { "description": "" }, "solicitationNumber": { "description": "" }, "noticeType": { "description": "" }, "noticeTypeCode": { "description": "" }, "department": { "description": "" }, "subTier": { "description": "" }, "office": { "description": "" }, "agencyPath": { "description": "" }, "postedDate": { "description": "" }, "modifiedDate": { "description": "" }, "responseDeadline": { "description": "" }, "daysUntilResponse": { "description": "" }, "naicsCodes": { "description": "" }, "pscCode": { "description": "" }, "setAside": { "description": "" }, "placeOfPerformanceCity": { "description": "" }, "placeOfPerformanceState": { "description": "" }, "placeOfPerformanceCountry": { "description": "" }, "awardee": { "description": "" }, "awardAmount": { "description": "" }, "awardDate": { "description": "" }, "isActive": { "description": "" }, "isCanceled": { "description": "" }, "description": { "description": "" }, "contacts": { "description": "" }, "url": { "description": "" }, "detailFetched": { "description": "" }, "source": { "description": "" }, "scrapedAt": { "description": "" } } } } } } } } } }, "/acts/gouda_studios~sec-edgar-filings-feed/run-sync-get-dataset-items": { "post": { "operationId": "run_sec_edgar_filings_feed", "summary": "Run SEC EDGAR Filings and return dataset items", "description": "Monitor SEC EDGAR filings by ticker or CIK, including 8-K, 10-Q, 10-K, Form 4 insider trades, Form D and S-1. Each result has the company, form type, filing date and document links. Only-new mode turns it into an alert feed for investors, research and AI agents. Pricing: $0.001 per run + $0.002 per filing.", "externalDocs": { "url": "https://apify.com/gouda_studios/sec-edgar-filings-feed" }, "parameters": [ { "name": "timeout", "in": "query", "schema": { "type": "integer" }, "description": "Run timeout in seconds" }, { "name": "format", "in": "query", "schema": { "type": "string", "default": "json" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "tickers": { "type": "array", "description": "Optional stock tickers, e.g. [\"AAPL\",\"NVDA\"]. Resolved to CIKs with the SEC ticker file.", "default": [] }, "ciks": { "type": "array", "description": "Optional SEC Central Index Keys, e.g. [\"320193\"]. Leave tickers and CIKs empty to get latest filings across all companies.", "default": [] }, "formTypes": { "type": "array", "description": "Form types to include, e.g. [\"8-K\",\"10-K\",\"10-Q\",\"4\",\"D\",\"S-1\",\"13F-HR\",\"SC 13D\"]. Empty = all forms (company mode only; market-wide mode needs at least one).", "default": [] }, "filedWithinDays": { "type": "integer", "description": "Only filings from the last N days. 0 = no limit (company mode returns the ~1000 most recent).", "default": 7 }, "onlyNew": { "type": "boolean", "description": "true = skip filings delivered by an earlier run with the same tickers/CIKs/forms. Use with a schedule for an alert feed.", "default": false }, "maxResults": { "type": "integer", "description": "Maximum rows (1-5000). You pay per row, so this caps cost: 100 rows = $0.20.", "default": 100 }, "contactEmail": { "type": "string", "description": "Optional. SEC asks automated clients to identify themselves; this email is sent in the User-Agent header to sec.gov only." } } }, "example": { "tickers": [ "AAPL", "TSLA" ], "formTypes": [ "8-K", "10-Q" ], "filedWithinDays": 30, "maxResults": 50 } } } }, "responses": { "201": { "description": "Dataset items", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "companyName": { "description": "" }, "cik": { "description": "" }, "filerRole": { "description": "" }, "form": { "description": "" }, "filingDate": { "description": "" }, "acceptedAt": { "description": "" }, "accessionNumber": { "description": "" }, "items": { "description": "" }, "indexUrl": { "description": "" }, "documentUrl": { "description": "" } } } } } } } } } }, "/acts/gouda_studios~usaspending-awards-search/run-sync-get-dataset-items": { "post": { "operationId": "run_usaspending_awards_search", "summary": "Run USAspending Federal Awards and return dataset items", "description": "Search USAspending.gov federal awards by keyword, recipient, agency, NAICS, state, date and amount. Get contracts and grants with amounts, recipients, awarding agency and performance dates as JSON. Track competitors, find who won contracts and build sales prospect lists. Pricing: $0.001 per run + $0.0015 per award.", "externalDocs": { "url": "https://apify.com/gouda_studios/usaspending-awards-search" }, "parameters": [ { "name": "timeout", "in": "query", "schema": { "type": "integer" }, "description": "Run timeout in seconds" }, { "name": "format", "in": "query", "schema": { "type": "string", "default": "json" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "keywords": { "type": "array", "description": "Optional words to match in award descriptions, e.g. [\"cybersecurity\"].", "default": [] }, "recipientNames": { "type": "array", "description": "Optional company or organization names (or UEIs), e.g. [\"Booz Allen Hamilton\"]. Find a competitor's federal wins.", "default": [] }, "awardingAgencies": { "type": "array", "description": "Optional top-tier agency names exactly as USAspending lists them, e.g. [\"Department of Defense\",\"Department of Veterans Affairs\"].", "default": [] }, "naicsCodes": { "type": "array", "description": "Optional NAICS codes (contracts only), e.g. [\"541512\"].", "default": [] }, "states": { "type": "array", "description": "Optional 2-letter state codes, e.g. [\"VA\",\"TX\"].", "default": [] }, "awardType": { "type": "string", "description": "contracts (default), idvs, grants, loans, direct_payments or other.", "default": "contracts", "enum": [ "contracts", "idvs", "grants", "loans", "direct_payments", "other" ] }, "startDate": { "type": "string", "description": "YYYY-MM-DD. Defaults to 90 days ago. USAspending data starts 2007-10-01." }, "endDate": { "type": "string", "description": "YYYY-MM-DD. Defaults to today." }, "minAmount": { "type": "integer", "description": "Optional lower bound on award amount." }, "maxAmount": { "type": "integer", "description": "Optional upper bound on award amount." }, "onlyNew": { "type": "boolean", "description": "true = skip awards delivered by an earlier run with the same filters.", "default": false }, "maxResults": { "type": "integer", "description": "Maximum rows (1-10000). You pay per row: 100 rows = $0.15.", "default": 100 } } }, "example": { "keywords": [ "cybersecurity" ], "awardType": "contracts", "startDate": "2026-01-01", "maxResults": 50 } } } }, "responses": { "201": { "description": "Dataset items", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "awardId": { "description": "" }, "recipientName": { "description": "" }, "recipientUei": { "description": "" }, "awardAmount": { "description": "" }, "totalOutlays": { "description": "" }, "description": { "description": "" }, "startDate": { "description": "" }, "endDate": { "description": "" }, "awardingAgency": { "description": "" }, "awardingSubAgency": { "description": "" }, "fundingAgency": { "description": "" }, "awardType": { "description": "" }, "naics": { "description": "" }, "psc": { "description": "" }, "assistanceListings": { "description": "" }, "placeOfPerformanceState": { "description": "" }, "lastModified": { "description": "" }, "internalId": { "description": "" }, "url": { "description": "" } } } } } } } } } }, "/acts/gouda_studios~gleif-company-lei-lookup/run-sync-get-dataset-items": { "post": { "operationId": "run_gleif_company_lei_lookup", "summary": "Run GLEIF Company LEI Lookup and return dataset items", "description": "Find any company LEI number by name, or look up an LEI, in the official GLEIF global registry. Get the legal name, status, jurisdiction, registration number, legal and HQ address, and direct and ultimate parent companies. For KYC, KYB, vendor checks and data enrichment. Pricing: $0.001 per run + $0.003 per company.", "externalDocs": { "url": "https://apify.com/gouda_studios/gleif-company-lei-lookup" }, "parameters": [ { "name": "timeout", "in": "query", "schema": { "type": "integer" }, "description": "Run timeout in seconds" }, { "name": "format", "in": "query", "schema": { "type": "string", "default": "json" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "companyNames": { "type": "array", "description": "Legal names to look up, e.g. [\"Apple Inc.\",\"Siemens AG\"]. Exact legal name match first, then fuzzy full-text.", "default": [] }, "leis": { "type": "array", "description": "Optional 20-character LEIs to fetch directly.", "default": [] }, "registrationNumbers": { "type": "array", "description": "Optional company-registry numbers as reported to GLEIF (registeredAs), e.g. a UK Companies House number.", "default": [] }, "country": { "type": "string", "description": "Optional ISO 2-letter country of the legal address, e.g. US, GB, DE. Improves name matching." }, "activeOnly": { "type": "boolean", "description": "true (default) = skip lapsed/inactive entities for name and registration searches.", "default": true }, "maxMatchesPerName": { "type": "integer", "description": "How many candidate entities to return per name or registration number (1-50).", "default": 3 }, "includeParents": { "type": "boolean", "description": "true (default) = add direct and ultimate parent (LEI, name, country) where reported.", "default": true }, "maxResults": { "type": "integer", "description": "Maximum rows overall (1-5000). You pay per row: 100 rows = $0.30.", "default": 100 } } }, "example": { "companyNames": [ "Apple Inc." ], "country": "US", "maxResults": 10 } } } }, "responses": { "201": { "description": "Dataset items", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "query": { "description": "" }, "lei": { "description": "" }, "legalName": { "description": "" }, "otherNames": { "description": "" }, "status": { "description": "" }, "registrationStatus": { "description": "" }, "category": { "description": "" }, "legalFormId": { "description": "" }, "jurisdiction": { "description": "" }, "registeredAs": { "description": "" }, "registrationAuthorityId": { "description": "" }, "legalAddress": { "description": "" }, "headquartersAddress": { "description": "" }, "entityCreatedAt": { "description": "" }, "initialRegistrationDate": { "description": "" }, "lastUpdateDate": { "description": "" }, "nextRenewalDate": { "description": "" }, "bic": { "description": "" }, "successorLei": { "description": "" }, "url": { "description": "" }, "directParent": { "description": "" }, "ultimateParent": { "description": "" } } } } } } } } } }, "/acts/gouda_studios~website-contact-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run_website_contact_extractor", "summary": "Run Website Contact Extractor and return dataset items", "description": "Extract emails, phone numbers, social media links and addresses from any list of websites. One clean deduplicated row per site, Cloudflare-protected emails decoded, phones validated, MX checked. Pay only for sites where an email or phone is found. Pricing: $0.0005 per run + $0.0025 per website with contacts.", "externalDocs": { "url": "https://apify.com/gouda_studios/website-contact-extractor" }, "parameters": [ { "name": "timeout", "in": "query", "schema": { "type": "integer" }, "description": "Run timeout in seconds" }, { "name": "format", "in": "query", "schema": { "type": "string", "default": "json" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "startUrls": { "type": "array", "description": "Websites or domains to extract contacts from, one per line. Examples: https://www.example.com or example.com. Each site becomes exactly one output row." }, "maxPagesPerSite": { "type": "integer", "description": "How many pages to read on each site, starting with the homepage and then the most likely contact pages (Contact, About, Team, Impressum, Support). You pay per site, not per page, so higher values only cost more time.", "default": 8 }, "defaultCountry": { "type": "string", "description": "Two-letter country code used to read local phone numbers that have no +country prefix, e.g. US, GB, DE, AU.", "default": "US" }, "checkMx": { "type": "boolean", "description": "Adds a free DNS check that each email domain can receive mail. Flags typos and dead domains.", "default": true }, "respectRobotsTxt": { "type": "boolean", "description": "Skip pages that a site's robots.txt asks crawlers not to visit.", "default": true }, "proxyConfiguration": { "type": "object", "description": "Optional. Most business sites work without a proxy. Turn on Apify Proxy if many sites time out or block requests.", "default": { "useApifyProxy": false } } } }, "example": { "startUrls": [ "https://apify.com", "python.org" ], "maxPagesPerSite": 8, "defaultCountry": "US" } } } }, "responses": { "201": { "description": "Dataset items", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "inputUrl": { "type": "string", "description": "" }, "domain": { "type": "string", "description": "" }, "finalUrl": { "description": "" }, "siteName": { "description": "" }, "status": { "type": "string", "description": "" }, "primaryEmail": { "description": "" }, "primaryPhone": { "description": "" }, "emails": { "type": "array", "description": "" }, "phones": { "type": "array", "description": "" }, "linkedin": { "type": "array", "description": "" }, "facebook": { "type": "array", "description": "" }, "instagram": { "type": "array", "description": "" }, "x": { "type": "array", "description": "" }, "youtube": { "type": "array", "description": "" }, "tiktok": { "type": "array", "description": "" }, "otherSocials": { "type": "object", "description": "" }, "addresses": { "type": "array", "description": "" }, "contactPageUrls": { "type": "array", "description": "" }, "emailDetails": { "type": "array", "description": "" }, "phoneDetails": { "type": "array", "description": "" }, "pagesScanned": { "type": "integer", "description": "" }, "scannedUrls": { "type": "array", "description": "" }, "charged": { "type": "boolean", "description": "" }, "error": { "description": "" }, "scrapedAt": { "type": "string", "description": "" } } } } } } } } } }, "/acts/gouda_studios~youtube-transcript-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run_youtube_transcript_extractor", "summary": "Run YouTube Transcript Extractor and return dataset items", "description": "Get the transcript of any YouTube video or Short as clean text, timestamped text, segments and SRT. Bulk URLs, any language, auto-translate. Pay only for transcripts you get; failed videos are free. Pricing: $0.0005 per run + $0.004 per transcript.", "externalDocs": { "url": "https://apify.com/gouda_studios/youtube-transcript-extractor" }, "parameters": [ { "name": "timeout", "in": "query", "schema": { "type": "integer" }, "description": "Run timeout in seconds" }, { "name": "format", "in": "query", "schema": { "type": "string", "default": "json" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "videos": { "type": "array", "description": "Watch URLs, youtu.be links, Shorts, live or embed URLs, or bare 11-character video IDs." }, "languages": { "type": "array", "description": "Language codes in priority order, e.g. en, es, de. If none match, the first available transcript is returned.", "default": [ "en" ] }, "translateTo": { "type": "string", "description": "Language code to auto-translate the transcript into using YouTube's translation, e.g. en." }, "preferManual": { "type": "boolean", "description": "Use manually created captions over auto-generated ones when both exist.", "default": true }, "includeSegments": { "type": "boolean", "description": "Add an array of segments with start time and duration.", "default": true }, "includeSrt": { "type": "boolean", "description": "Add an SRT subtitle file as a string.", "default": false }, "maxVideos": { "type": "integer", "description": "Stop after this many videos.", "default": 1000 }, "proxyConfiguration": { "type": "object", "description": "Optional. Leave off to use our built-in residential proxy, included in the price. Set your own only if you want to.", "default": { "useApifyProxy": false } } } }, "example": { "videos": [ "https://www.youtube.com/watch?v=UF8uR6Z6KLc" ], "languages": [ "en" ], "includeSrt": false } } } }, "responses": { "201": { "description": "Dataset items", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "properties": { "videoId": { "type": "string", "description": "YouTube video ID" }, "url": { "type": "string", "description": "Watch URL" }, "title": { "description": "Video title" }, "channel": { "description": "Channel name" }, "channelUrl": { "description": "Channel URL" }, "status": { "type": "string", "description": "ok or error" }, "languageCode": { "type": "string", "description": "Transcript language code" }, "language": { "type": "string", "description": "Transcript language name" }, "isGenerated": { "type": "boolean", "description": "True for auto-generated captions" }, "translatedTo": { "description": "Translation target if requested" }, "wordCount": { "type": "integer", "description": "Words in transcript" }, "durationSeconds": { "type": "number", "description": "End time of last caption" }, "text": { "type": "string", "description": "Full transcript as one string" }, "timestampedText": { "type": "string", "description": "Transcript lines prefixed with [m:ss]" }, "segments": { "type": "array", "description": "Timed caption segments {start, duration, text}" }, "srt": { "type": "string", "description": "SRT subtitles (if requested)" }, "availableLanguages": { "type": "array", "description": "All caption tracks on the video" }, "error": { "type": "string", "description": "Why the video failed (not charged)" } } } } } } } } } } } }