API Documentation

Attribution and License Terms

GET /api/v1/terms

â„šī¸ No API Key Required
This endpoint is publicly accessible without authentication to ensure license terms are always available.

Get full Creative Commons BY 4.0 attribution requirements and usage guidelines for the Web of Trust Map data. This endpoint provides comprehensive information about how to properly use and attribute the data.

Why This Endpoint Matters

  • Ensures compliance with CC BY 4.0 license requirements
  • Provides proper attribution text for your use case
  • Clarifies commercial and non-commercial usage rights
  • Documents API-specific requirements and rate limits
  • Always accessible to verify current terms

Request

No Parameters Required

This endpoint accepts no query or path parameters.

Example Request

bash
# Get license terms (no API key needed)
curl -X GET "https://www.weboftrust.org/api/v1/terms"

# Save terms to a file for reference
curl -X GET "https://www.weboftrust.org/api/v1/terms" \
  -o wot-terms.json

Response

Success Response (200 OK)

Response Schema

typescript
interface TermsResponse {
  license: {
    name: string;      // Full license name
    url: string;       // License URL
    spdx_id: string;   // SPDX identifier
  };
  
  attribution: {
    required: boolean;
    text: string;      // Complete attribution text to use
    components: {
      credit: string;
      links: {
        web_of_trust: string;
        key_state: string;
        license: string;
      };
      indicate_changes: string;
    };
  };
  
  usage_guidelines: {
    commercial_use: string;
    distribution: string;
    modification: string;
    private_use: string;
    requirements: string[];
  };
  
  examples?: {
    minimal: string;
    standard: string;
    full: string;
    with_modifications: string;
  };
  
  api_specific: {
    rate_limits: {
      general: string;
      search: string;
      graph: string;
    };
    headers: {
      "X-License": string;
      "X-Attribution": string;
    };
    fair_use: string;
  };
  
  contact: {
    questions: string;
    website: string;
    issues: string;
  };
  
  disclaimer: string;
  last_updated: string;  // ISO 8601 timestamp
}

Example Response

json
{
  "license": {
    "name": "Creative Commons Attribution 4.0 International (CC BY 4.0)",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "spdx_id": "CC-BY-4.0"
  },
  "attribution": {
    "required": true,
    "text": "Data from Web of Trust Map (weboftrust.org) by Key State Capital (keystate.capital), licensed under CC BY 4.0",
    "components": {
      "credit": "Web of Trust Map and Key State Capital",
      "links": {
        "web_of_trust": "https://weboftrust.org",
        "key_state": "https://keystate.capital",
        "license": "https://creativecommons.org/licenses/by/4.0/"
      },
      "indicate_changes": "You must indicate if changes were made to the data"
    }
  },
  "usage_guidelines": {
    "commercial_use": "Allowed",
    "distribution": "Allowed",
    "modification": "Allowed with attribution",
    "private_use": "Allowed",
    "requirements": [
      "Give appropriate credit to Web of Trust Map and Key State Capital",
      "Provide links to weboftrust.org and keystate.capital",
      "Provide a link to the CC BY 4.0 license",
      "Indicate if any changes were made to the data",
      "Do not suggest endorsement by Web of Trust Map or Key State Capital"
    ]
  },
  "examples": {
    "minimal": "Data: Web of Trust Map (CC BY 4.0)",
    "standard": "Data from Web of Trust Map (weboftrust.org) by Key State Capital (keystate.capital), licensed under CC BY 4.0",
    "full": "This project uses data from the Web of Trust Map (https://weboftrust.org) created by Key State Capital (https://keystate.capital), licensed under Creative Commons Attribution 4.0 International License (https://creativecommons.org/licenses/by/4.0/)",
    "with_modifications": "Based on data from Web of Trust Map (weboftrust.org) by Key State Capital (keystate.capital), licensed under CC BY 4.0. The original data has been filtered and restructured for this application."
  },
  "api_specific": {
    "rate_limits": {
      "general": "60-120 requests/minute/IP",
      "search": "30 requests/minute/IP",
      "graph": "10 requests/minute/IP"
    },
    "headers": {
      "X-License": "CC-BY-4.0",
      "X-Attribution": "Web of Trust Map - Key State Capital"
    },
    "fair_use": "Please cache responses appropriately and avoid unnecessary repeated requests"
  },
  "contact": {
    "questions": "[email protected]",
    "website": "https://weboftrust.org",
    "issues": "https://github.com/weboftrust/api-docs/issues"
  },
  "disclaimer": "The data is provided 'as is' without warranty of any kind. Web of Trust Map and Key State Capital make no representations about the suitability, reliability, availability, timeliness, or accuracy of the data.",
  "last_updated": "2025-09-09T15:32:54.168Z"
}

Attribution Requirements

What You Must Do

  1. Give Credit: Mention both Web of Trust Map and Key State Capital
  2. Provide Links: Include links to weboftrust.org and keystate.capital
  3. License Link: Link to the CC BY 4.0 license
  4. Indicate Changes: Note if you've modified the data
  5. No False Endorsement: Don't imply endorsement by WoT or KSC

Attribution Examples

html
<footer>
  <p>
    Data from <a href="https://weboftrust.org">Web of Trust Map</a> 
    by <a href="https://keystate.capital">Key State Capital</a>, 
    licensed under <a href="https://creativecommons.org/licenses/by/4.0/">CC BY 4.0</a>
  </p>
</footer>

Academic Paper

text
This research uses data from the Web of Trust Map (https://weboftrust.org) 
created by Key State Capital (https://keystate.capital), made available under 
the Creative Commons Attribution 4.0 International License.

Mobile App

text
Settings > About > Data Sources:
"Web of Trust Map data by Key State Capital (CC BY 4.0)
weboftrust.org | keystate.capital"

Commercial Use

Yes, you can use Web of Trust Map data commercially! The CC BY 4.0 license allows:

  • ✅ Building commercial products
  • ✅ Selling services based on the data
  • ✅ Including in paid reports
  • ✅ Using in proprietary software

Just remember to provide proper attribution as described above.

Contact Information