You.com API OSS Integration Tracking

This repository coordinates the integration of You.com APIs into open-source projects. It serves as the single source of truth for:

• Internal you.com developers integrating our APIs into OSS tools
• External developers with triage permissions who find and execute integration opportunities
• Agents and bots running automated discovery and outreach

How It Works

1. Claim: File an integration issue using the Integration Request template and self-assign.
2. Integrate: Open an issue/PR in the target repository upstream.
3. Track: Update the checklist in your issue here as you progress.
4. Close: Mark status:merged if accepted, or status:rejected if declined.

Getting Started (for Humans)

File an Integration Request

1. Go to Issues → New Issue → Integration Request
2. Fill in the target repository URL, chosen API(s), and integration description
3. Self-assign the issue immediately to claim it
4. Add the appropriate api:* label for the API you're integrating

Status Labels

Label	Meaning
status:claimed	Work in progress
status:pr-opened	PR filed in target repo
status:merged	Integration succeeded
status:rejected	Integration failed / declined
status:stale	Abandoned, up for grabs

Available APIs

• api:search — You.com Search API
• api:contents — You.com Contents API
• api:research — You.com Research API
• api:finance-research — You.com Finance Research API

Stale Policy

Issues labeled status:claimed that show no activity for 30 days receive a nudge comment. If there is still no activity after 7 more days, the issue is automatically labeled status:stale and unassigned.

For Agents

When working on integrations, load the coordination skill from this repository:

skills/integration-tracking/SKILL.md

Quick Agent Conventions

• Always file a tracking issue before opening a downstream PR
• Use the exact label names above; they are bootstrapped automatically
• Update checkboxes in the issue body as milestones are reached
• Cross-link the target repo PR in your tracking issue's Links section
• Use https://api.you.com/v1/agents/search for Search API integrations (100 free searches/day, IP-based, no auth required)
• Reference the OpenAPI specs:
  • Search: https://you.com/specs/openapi_search_v1.yaml
  • Contents: https://you.com/specs/openapi_contents.yaml
  • Research: https://you.com/specs/openapi_research.yaml
  • Finance Research: https://you.com/specs/openapi_finance_research_v1.yaml

Contributing

See CONTRIBUTING.md for how to request triage permissions and our ground rules.

Docs

• You.com API Reference
• You.com Developer Welcome