{"openapi":"3.1.0","info":{"title":"Scout API","version":"1","summary":"Newly noticed early-stage startups on X, as JSON.","description":"Scout lists small companies the day they start drawing attention on X. This read-only API returns the same public data as the site.\n\n**Authentication:** none. The API is open; send no key or token.\n**Rate limits:** about 120 requests per minute per client IP (best effort). Every response carries `RateLimit` and `RateLimit-Policy` headers; a 429 carries `Retry-After`.\n**Pagination:** cursor-based. List responses include `nextCursor` (and a `Link: rel=\"next\"` header); pass it as `cursor` until it is null.\n**Errors:** RFC 9457 `application/problem+json` with a stable `code` and a `hint`.\n**Versioning:** the major version is in the path (`/v1`) and in the `API-Version` response header. Additive changes (new fields, endpoints, enum values) ship within v1; breaking changes ship as `/v2`. A retiring version announces itself at least 90 days ahead with `Deprecation` and `Sunset` headers (RFC 9745 / RFC 8594) and a note on the docs page.\n**Freshness:** data refreshes once a day; `updatedAt` says when.\n\nA listing is a discovery signal, not an endorsement or investment advice.","contact":{"name":"Emre Colakoglu","url":"https://x.com/emrecolakoglu"}},"externalDocs":{"description":"Developer docs","url":"https://scout.emre.computer/developers"},"servers":[{"url":"https://scout.emre.computer","description":"Production"}],"security":[],"tags":[{"name":"Companies","description":"Listed companies."},{"name":"Reference","description":"Sectors and discovery statistics."}],"paths":{"/v1/companies":{"get":{"operationId":"listCompanies","tags":["Companies"],"summary":"List and search companies","description":"Companies Scout has listed, newest first or by 7-day follower growth, 100 per page. Filter by search text, sector and when they were found. Use this to answer \"what new startups appeared this week\" or \"find new AI startups\".","parameters":[{"name":"q","in":"query","required":false,"description":"Search company names and websites (e.g. \"robot\"). Omit to list all.","schema":{"type":"string","maxLength":60}},{"name":"sector","in":"query","required":false,"description":"Only companies in this sector.","schema":{"type":"string","enum":["ai","quantum","hardware","robotics","biotech_health","space_defense","climate_energy","crypto","fintech","dev_tools_infra","consumer","other"]}},{"name":"range","in":"query","required":false,"description":"When Scout found them: 24h (today), 3d, 7d, or all (default).","schema":{"type":"string","enum":["24h","3d","7d","all"]}},{"name":"sort","in":"query","required":false,"description":"newest (default) or growth (most X followers gained over 7 days).","schema":{"type":"string","enum":["newest","growth"]}},{"name":"cursor","in":"query","required":false,"description":"nextCursor from a previous page; omit for the first page.","schema":{"type":"string"}}],"responses":{"200":{"description":"A page of companies.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyList"}}}},"400":{"description":"The request is invalid: a bad parameter value, unknown parameter or cursor. `hint` says how to fix it.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such company or endpoint.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited. Wait `Retry-After` seconds.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Scout's data source is temporarily unavailable. Retry.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/companies/{handle}":{"get":{"operationId":"getCompany","tags":["Companies"],"summary":"Get one company","description":"One listed company by its X handle: bio, website, followers and growth, latest post and funding. Returns 404 `company_not_found` if Scout has not listed it.","parameters":[{"name":"handle","in":"path","required":true,"description":"The company's X handle, with or without @ (e.g. \"openai\").","schema":{"type":"string","pattern":"^@?[A-Za-z0-9_]{1,15}$"}}],"responses":{"200":{"description":"The company.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Company"}}}},"400":{"description":"The request is invalid: a bad parameter value, unknown parameter or cursor. `hint` says how to fix it.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such company or endpoint.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited. Wait `Retry-After` seconds.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Scout's data source is temporarily unavailable. Retry.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/sectors":{"get":{"operationId":"listSectors","tags":["Reference"],"summary":"List sectors","description":"The sector slugs accepted by the `sector` filter, with display names.","responses":{"200":{"description":"All sectors.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SectorList"}}}},"400":{"description":"The request is invalid: a bad parameter value, unknown parameter or cursor. `hint` says how to fix it.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such company or endpoint.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited. Wait `Retry-After` seconds.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Scout's data source is temporarily unavailable. Retry.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/stats":{"get":{"operationId":"getDiscoveryStats","tags":["Reference"],"summary":"Companies found per day","description":"How many companies Scout found on each of the last 7 days, and the total listed, optionally for one sector.","parameters":[{"name":"sector","in":"query","required":false,"description":"Only companies in this sector.","schema":{"type":"string","enum":["ai","quantum","hardware","robotics","biotech_health","space_defense","climate_energy","crypto","fintech","dev_tools_infra","consumer","other"]}}],"responses":{"200":{"description":"Counts for the last week.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DiscoveryStats"}}}},"400":{"description":"The request is invalid: a bad parameter value, unknown parameter or cursor. `hint` says how to fix it.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No such company or endpoint.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited. Wait `Retry-After` seconds.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait.","schema":{"type":"integer"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Scout's data source is temporarily unavailable. Retry.","headers":{"RateLimit":{"description":"IETF RateLimit header: limit, remaining and reset (seconds).","schema":{"type":"string"}},"RateLimit-Policy":{"description":"Quota policy, 120 requests per 60 seconds.","schema":{"type":"string"}},"API-Version":{"description":"The API version that served the request.","schema":{"type":"string"}}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Company":{"type":"object","description":"A company Scout has listed: public X profile details, website metadata and funding when known.","required":["handle","name","sector","followers","foundDaysAgo","xUrl","scoutUrl"],"properties":{"handle":{"type":"string","description":"The company's X handle, without @."},"name":{"type":["string","null"],"description":"Display name on X."},"sector":{"type":["string","null"],"description":"Sector slug (see /v1/sectors); null before classification."},"sectorLabel":{"type":["string","null"],"description":"Human-readable sector name."},"bio":{"type":["string","null"],"description":"The company's X bio."},"websiteUrl":{"type":["string","null"],"format":"uri","description":"Company website."},"avatarUrl":{"type":["string","null"],"format":"uri","description":"X profile image (pbs.twimg.com)."},"followers":{"type":["integer","null"],"description":"Public X followers at the last scan."},"followerGrowth7d":{"type":["integer","null"],"description":"Net followers gained over the last 7 days; null until two readings a week apart exist."},"followerTrend":{"type":["array","null"],"items":{"type":"integer"},"description":"Up to 8 daily follower counts, oldest first."},"joinedXOn":{"type":["string","null"],"format":"date","description":"Calendar day, YYYY-MM-DD (UTC)."},"foundDaysAgo":{"type":["integer","null"],"minimum":0,"maximum":6,"description":"UTC days since Scout first noticed the company (0 = today); null for a week or more."},"latestPost":{"type":["object","null"],"description":"The account's latest public X post.","required":["url","postedOn"],"properties":{"url":{"type":"string","format":"uri"},"text":{"type":["string","null"]},"postedOn":{"type":"string","format":"date","description":"Calendar day, YYYY-MM-DD (UTC)."}}},"website":{"type":["object","null"],"description":"The website's own title and meta description.","properties":{"title":{"type":["string","null"]},"description":{"type":["string","null"]}}},"funding":{"type":["object","null"],"description":"Latest funding round when known. Amounts are whole USD.","properties":{"round":{"type":["string","null"],"description":"e.g. Seed, Series A."},"amountUsd":{"type":["integer","null"]},"date":{"type":["string","null"],"format":"date","description":"Calendar day, YYYY-MM-DD (UTC)."},"totalRaisedUsd":{"type":["integer","null"]}}},"xUrl":{"type":"string","format":"uri","description":"The company's X profile."},"scoutUrl":{"type":"string","format":"uri","description":"Shareable Scout link for the company."}}},"CompanyList":{"type":"object","description":"One page of companies (up to 100) and how to fetch the next one.","required":["companies","hasMore","nextCursor","filters"],"properties":{"companies":{"type":"array","items":{"type":"object","description":"A company Scout has listed: public X profile details, website metadata and funding when known.","required":["handle","name","sector","followers","foundDaysAgo","xUrl","scoutUrl"],"properties":{"handle":{"type":"string","description":"The company's X handle, without @."},"name":{"type":["string","null"],"description":"Display name on X."},"sector":{"type":["string","null"],"description":"Sector slug (see /v1/sectors); null before classification."},"sectorLabel":{"type":["string","null"],"description":"Human-readable sector name."},"bio":{"type":["string","null"],"description":"The company's X bio."},"websiteUrl":{"type":["string","null"],"format":"uri","description":"Company website."},"avatarUrl":{"type":["string","null"],"format":"uri","description":"X profile image (pbs.twimg.com)."},"followers":{"type":["integer","null"],"description":"Public X followers at the last scan."},"followerGrowth7d":{"type":["integer","null"],"description":"Net followers gained over the last 7 days; null until two readings a week apart exist."},"followerTrend":{"type":["array","null"],"items":{"type":"integer"},"description":"Up to 8 daily follower counts, oldest first."},"joinedXOn":{"type":["string","null"],"format":"date","description":"Calendar day, YYYY-MM-DD (UTC)."},"foundDaysAgo":{"type":["integer","null"],"minimum":0,"maximum":6,"description":"UTC days since Scout first noticed the company (0 = today); null for a week or more."},"latestPost":{"type":["object","null"],"description":"The account's latest public X post.","required":["url","postedOn"],"properties":{"url":{"type":"string","format":"uri"},"text":{"type":["string","null"]},"postedOn":{"type":"string","format":"date","description":"Calendar day, YYYY-MM-DD (UTC)."}}},"website":{"type":["object","null"],"description":"The website's own title and meta description.","properties":{"title":{"type":["string","null"]},"description":{"type":["string","null"]}}},"funding":{"type":["object","null"],"description":"Latest funding round when known. Amounts are whole USD.","properties":{"round":{"type":["string","null"],"description":"e.g. Seed, Series A."},"amountUsd":{"type":["integer","null"]},"date":{"type":["string","null"],"format":"date","description":"Calendar day, YYYY-MM-DD (UTC)."},"totalRaisedUsd":{"type":["integer","null"]}}},"xUrl":{"type":"string","format":"uri","description":"The company's X profile."},"scoutUrl":{"type":"string","format":"uri","description":"Shareable Scout link for the company."}}}},"total":{"type":["integer","null"],"description":"Companies matching the filters across all pages."},"hasMore":{"type":"boolean","description":"True when another page exists."},"nextCursor":{"type":["string","null"],"description":"Pass as `cursor` to get the next page; null on the last page."},"updatedAt":{"type":["string","null"],"format":"date-time","description":"When the list last took in new data."},"today":{"type":["string","null"],"format":"date","description":"Calendar day, YYYY-MM-DD (UTC)."},"filters":{"type":"object","description":"The filters Scout applied.","properties":{"range":{"type":"string","enum":["24h","3d","7d","all"]},"sort":{"type":"string","enum":["newest","growth"]},"query":{"type":"string"},"sector":{"type":["string","null"]}}}}},"SectorList":{"type":"object","required":["sectors"],"properties":{"sectors":{"type":"array","items":{"type":"object","required":["slug","label"],"properties":{"slug":{"type":"string","enum":["ai","quantum","hardware","robotics","biotech_health","space_defense","climate_energy","crypto","fintech","dev_tools_infra","consumer","other"]},"label":{"type":"string"}}}}}},"DiscoveryStats":{"type":"object","description":"Companies found per day over the last week.","required":["foundPerDay"],"properties":{"sector":{"type":["string","null"]},"total":{"type":["integer","null"],"description":"All listed companies (in the sector, if given)."},"foundPerDay":{"type":"array","description":"Newest first; daysAgo 0 is today (UTC).","items":{"type":"object","required":["daysAgo","count"],"properties":{"date":{"type":["string","null"],"format":"date","description":"Calendar day, YYYY-MM-DD (UTC)."},"daysAgo":{"type":"integer"},"count":{"type":"integer"}}}},"updatedAt":{"type":["string","null"],"format":"date-time"}}},"Error":{"type":"object","description":"RFC 9457 problem details with a machine-readable code and a hint for fixing the request.","required":["type","title","status","code","detail"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string","enum":["invalid_parameter","unknown_parameter","invalid_cursor","company_not_found","not_found","rate_limited","upstream_unavailable","internal_error"]},"detail":{"type":"string"},"hint":{"type":"string"}}}}}}