{"uid":"cap_yeIWNtxYfFWBgCsNR6WH2","slug":"goodfirms-company-directory-scraper-2c465574","name":"GoodFirms Company Directory Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/goodfirms?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"maxItems":{"type":"integer","default":100,"maximum":5000,"minimum":0,"description":"Maximum number of unique companies to save across directory pages. Set to 0 to follow every available page."},"searchUrl":{"type":"string","description":"Full public GoodFirms company directory URL, including any category or location filters."},"includeProfiles":{"type":"boolean","default":true,"description":"Visit each public company profile for tagline, focus areas, and visible portfolio count. Turning this off makes collection faster."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"logoAlt":null,"logoUrl":null,"entityId":null,"searchUrl":null,"entityName":null,"sourcePage":null,"companyName":null,"companyWebsite":null}],"product":"goodfirms"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AD9DAF-KUjtqb1hV5_X6x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured company listings from GoodFirms directory pages, optionally visiting individual profiles for detailed metadata.","exampleAgentPrompt":"Pull up to 200 companies from the GoodFirms mobile app development category directory at https://www.goodfirms.co/directory/category/mobile-app-development, and include their full profiles with taglines and focus areas.","exampleUseCases":[{"title":"Agency lead list for outreach campaign","prompt":"Scrape the top 150 web development companies from GoodFirms at https://www.goodfirms.co/directory/category/web-development — include their profile details like tagline and focus areas so I can build a targeted outreach list."},{"title":"Competitor landscape research by location","prompt":"Get me up to 300 IT companies listed on GoodFirms for New York from https://www.goodfirms.co/directory/location/united-states/new-york, with their profiles, so I can map the competitive landscape in that region."},{"title":"AI/ML vendor discovery for procurement","prompt":"Scrape GoodFirms for artificial intelligence companies at https://www.goodfirms.co/directory/category/artificial-intelligence, limit to 100 results, and include each company's profile so I can evaluate potential vendors."}],"resultDescription":"Returns a JSON object with a count of collected companies and an array of items, each containing company name, website, logo URL, logo alt text, entity ID, source page, and search URL. When profile visits are enabled, additional fields like tagline, focus areas, and portfolio count are included.","failureModes":["GoodFirms page structure changes may return empty or malformed data","Invalid or inaccessible searchUrl results in empty items array","Rate limiting or bot detection by GoodFirms may cause failed runs (not charged)","Very large maxItems values may time out before completion","Non-GoodFirms URLs passed as searchUrl will likely yield no results"],"whenToPreferThis":"Use this endpoint when you need structured company data specifically from GoodFirms, including names, websites, and profile details. Prefer it over generic web scrapers when you want pre-parsed, schema-normalized output without handling raw HTML. It is particularly useful for lead generation, vendor research, or competitive analysis tasks targeting the B2B services and software agency market indexed on GoodFirms.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:20.104Z","isFirstParty":false,"canonicalSlug":"goodfirms-company-directory-scraper-2c465574"}