aid: sylvia-api
url: https://raw.githubusercontent.com/api-evangelist/sylvia-api/refs/heads/main/apis.yml
name: Sylvia API
description: 'Sylvia API is a third-party Reddit data API that serves Reddit content as JSON — posts,
  comments with full recursive threads, subreddit and user surfaces, global search, and a live comment
  stream. Thirty-six operations across twelve tags cover the read surface (posts, comments, subreddits,
  users, search, domains, discovery and live feeds) plus account self-service: API key issue and revoke,
  response-format templates, usage history and crypto billing. Authentication is an API key for data endpoints
  and a separate account token for account operations. It occupies the gap left by Pushshift, giving researchers
  and developers queryable Reddit history without going through OAuth on the first-party API.'
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - rate-limits
  generated: '2026-09-03'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/sylvia-api.png
created: '2026-08-04'
modified: '2026-08-20'
specificationVersion: '0.23'
type: Index
position: Producing
access: 3rd-Party
kind: contract
tags:
- Reddit
- Social
- Data
- Search
- Comments
- Research
- Content
- Datasets
- A2A
apis:
- aid: sylvia-api:sylvia-api-live-api
  name: Sylvia API Live API
  description: The Live API from Sylvia API — 1 operation(s) for live.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Live
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-live-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-subreddits-api
  name: Sylvia API Subreddits API
  description: The Subreddits API from Sylvia API — 2 operation(s) for subreddits.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Subreddits
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-subreddits-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-users-api
  name: Sylvia API Users API
  description: The Users API from Sylvia API — 3 operation(s) for users.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - User
  tags_raw:
  - Users
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-users-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-account-api
  name: Sylvia API Account API
  description: The Account API from Sylvia API — 5 operation(s) for account.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Account
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-account-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-billing-api
  name: Sylvia API Billing API
  description: The Billing API from Sylvia API — 2 operation(s) for billing.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Billing
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-billing-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-discovery-api
  name: Sylvia API Discovery API
  description: The Discovery API from Sylvia API — 3 operation(s) for discovery.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Discovery
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-discovery-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-domains-api
  name: Sylvia API Domains API
  description: The Domains API from Sylvia API — 2 operation(s) for domains.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Domains
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-domains-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-health-api
  name: Sylvia API Health API
  description: The Health API from Sylvia API — 1 operation(s) for health.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Health
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-health-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-keys-api
  name: Sylvia API Keys API
  description: The Keys API from Sylvia API — 2 operation(s) for keys.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Keys
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-keys-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-posts-comments-api
  name: Sylvia API Posts & Comments API
  description: The Posts & Comments API from Sylvia API — 6 operation(s) for posts & comments.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Posts & Comments
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-posts-comments-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-search-api
  name: Sylvia API Search API
  description: The Search API from Sylvia API — 1 operation(s) for search.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-search-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-templates-api
  name: Sylvia API Templates API
  description: The Templates API from Sylvia API — 2 operation(s) for templates.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Templates
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-templates-api-openapi.yml
  - type: X-OpenAPI-Source
    url: https://sylvia-api.com/openapi.json
  - type: Website
    url: https://sylvia-api.com/
  - type: Authentication
    url: authentication/sylvia-api-authentication.yml
  - type: LlmsText
    url: https://sylvia-api.com/llms.txt
- aid: sylvia-api:sylvia-api-comments-api
  name: Sylvia API Comments API
  description: The Comments API from Sylvia API — 2 operation(s) for comments.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Comments
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-comments-api-openapi.yml
- aid: sylvia-api:sylvia-api-datasets-api
  name: Sylvia API Datasets API
  description: The Datasets API from Sylvia API — 1 operation(s) for datasets.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Datasets
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-datasets-api-openapi.yml
- aid: sylvia-api:sylvia-api-posts-api
  name: Sylvia API Posts API
  description: The Posts API from Sylvia API — 2 operation(s) for posts.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Posts
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-posts-api-openapi.yml
- aid: sylvia-api:sylvia-api-usage-api
  name: Sylvia API Usage API
  description: The Usage API from Sylvia API — 1 operation(s) for usage.
  humanURL: https://sylvia-api.com/
  baseURL: https://api.sylvia-api.com/v1
  tags:
  - Usage
  properties:
  - type: OpenAPI
    url: openapi/sylvia-api-usage-api-openapi.yml
common:
- type: CapabilityMap
  url: capabilities/sylvia-api-capability-edges.yml
  name: Sylvia API Business Capability Map
- url: https://sylvia-api.com/
  type: Website
- url: https://sylvia-api.com/llms.txt
  type: LlmsText
- url: authentication/sylvia-api-authentication.yml
  type: Authentication
- type: DeveloperPortal
  url: https://sylvia-api.com/
- type: Documentation
  url: https://sylvia-api.com/docs/
- type: APIReference
  url: https://sylvia-api.com/docs/
- type: Pricing
  url: https://sylvia-api.com/pricing/
- type: Plans
  url: plans/sylvia-api-plans-pricing.yml
- type: RateLimits
  url: rate-limits/sylvia-api-rate-limits.yml
- type: FinOps
  url: finops/sylvia-api-finops.yml
- type: StatusPage
  url: https://sylvia-api.instatus.com/
- type: Lifecycle
  url: lifecycle/sylvia-api-lifecycle.yml
- type: ChangeLog
  url: https://sylvia-api.com/changelog/
- type: Security
  url: https://sylvia-api.com/security/
- type: SecurityTxt
  url: well-known/sylvia-api-security.txt
- type: VulnerabilityDisclosure
  url: https://sylvia-api.com/.well-known/security.txt
- type: PrivacyPolicy
  url: https://sylvia-api.com/privacy/
- type: Blog
  url: https://sylvia-api.com/blog/
- type: SDK
  url: https://sylvia-api.com/sdk/
- type: Packages
  url: https://pypi.org/project/sylvia-api/
- type: MCPServer
  url: https://api.sylvia-api.com/mcp
- type: AgentCard
  url: a2a/sylvia-api-agent-card.json
- type: APICatalog
  url: well-known/sylvia-api-api-catalog.json
- type: WellKnown
  url: well-known/sylvia-api-well-known.yml
- type: APIsJSON
  url: https://sylvia-api.com/apis.json
- type: OpenAPI
  url: https://sylvia-api.com/openapi.json
- type: AgenticAccess
  url: agentic-access/sylvia-api-agentic-access-contract.json
- type: Postman
  url: postman/sylvia-api.postman_collection.json
- type: Conformance
  url: conformance/sylvia-api-conformance.yml
- type: Compliance
  url: conformance/sylvia-api-conformance.yml
- type: Overlay
  url: overlays/sylvia-api-overlay.json
- type: Deprecation
  url: lifecycle/sylvia-api-deprecation.md
- type: AgentSkill
  url: skills/_index.yml
- type: ErrorCatalog
  url: errors/sylvia-api-error-codes.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
X-Discovery:
  date: '2026-08-04'
  method: probed
  note: Submitted through the Add-API pipeline and PARKED as low_confidence. Reviewed by hand and approved
    — the pipeline was misled by a site-wide HTML catch-all.
  findings:
  - surface: OpenAPI
    url: https://sylvia-api.com/openapi.json
    http_status: 200
    real: true
    note: OpenAPI 3.0.3, 12 paths, 12 operations, 8 schemas, ApiKeyAuth, server api.sylvia-api.com/v1.
      All 12 operations carry an operationId.
  - surface: LlmsTxt
    url: https://sylvia-api.com/llms.txt
    http_status: 200
    real: true
    note: 3,558 bytes, distinct from the catch-all body.
  - surface: Control
    url: https://sylvia-api.com/zzz-control
    http_status: 200
    real: false
    note: CATCH-ALL CONFIRMED — /, /apis.json, /docs and this control path all return the same 3,122 bytes
      (md5 65bd0d3b). That is why the submission scored low confidence. The OpenAPI and llms.txt above
      return DIFFERENT bytes and different checksums, which is what distinguishes a real artifact from
      the catch-all.
x-evidence:
  round: '2026-08-18'
  trigger: 'Provider request — api-evangelist/sylvia-api issue #1 (c1nn3r), fixes applied, re-score asked'
  openapi_source:
    url: https://sylvia-api.com/openapi.json
    fetched: '2026-08-18'
    bytes: 115852
    paths: 34
    operations: 36
    schemas: 21
    upstream_tags: 12
    archived_to: openapi/_original/sylvia-api-openapi-2026-08-18.json
    supersedes:
      file: openapi/_original/sylvia-api-openapi-2026-08-04.json
      fetched: '2026-08-04'
      bytes: 22328
      paths: 12
      operations: 12
      schemas: 8
      upstream_tags: 0
      note: Every operation was untagged; refine derived tags from path segments.
  catch_all_fixed:
    probe: https://sylvia-api.com/definitely-not-a-real-path-xyz
    status: 404
    content_type: text/plain
    bytes: 10
    note: The site-wide HTML catch-all flagged on 2026-08-04 is genuinely gone.
  not_wired:
    TermsOfService: /terms/ returns 200 but is byte-identical to /login/ (md5 3f9a0a11, 135b of text)
      — the SPA fallback shell carrying the homepage title, not a terms document.
    SignUp: /login/ same shell as above. The route is real in a browser but serves no content to a non-JS
      client.
    Deprecation: No deprecation or sunset policy published as of 2026-08-18.
    CLI: Mentioned in prose on /sdk/ but no install command, package or repository given.
    Postman: collections/ holds 14 files generated from the superseded 12-operation spec and naming retired
      tags; moved aside this round pending regeneration.
  second_round_2026_08_20:
    trigger: 'api-evangelist/sylvia-api issue #2 — c1nn3r shipped a second round after the 0.12.0 follow-up
      named the exact gaps.'
    verified_live:
      agent-card.json: '200 application/json 4,147b — A2A shape confirmed: supportedInterfaces, securitySchemes
        (apiKey + accountToken), securityRequirements, and 6 real skills (reddit-search, subreddit-listings,
        full-threads, user-content, live-comment-streams, account-self-service).'
      agentic-access-contract.json: 200 application/json 2,522b
      api-catalog: 200 3,116b, expanded from 1,035b
      postman collection: 200 application/json 31,950b
      conformance.yml: 200 1,505b — real standards list with evidence
      overlay.json: 200 792b
      deprecation.md: 200 text/markdown 732b
      openapi.json: '200 116,679b — ErrorResponse.code now enumerates all 9 stable codes: BAD_REQUEST,
        UNAUTHORIZED, FORBIDDEN, NOT_FOUND, LOW_BALANCE, RATE_LIMITED, FEATURE_LOCKED, TIER_EXPIRED, REQUEST_FAILED.'
      negative_control: /zzz-not-real-9137 -> 404 text/plain 10b, so every 200 above is genuine.
    note: They addressed every dimension named in the 0.12.0 follow-up — agent_card, agentic_access, error_semantics,
      well_known_catalog, agent_skills, plus the contract_governance block (ruleset, vocabulary, conformance,
      overlay).
x-a2a:
  verified: true
  probed: '2026-09-26'
  url: "https://sylvia-api.com/.well-known/agent-card.json"
  grade: "flavored"
  protocol_version: "1.0"
  control: 200