Skip to content
nData
nData API v1 · public beta

Social media data extraction API.

Turn a public post URL into structured JSON. Ask a question, extract specific fields, or define the response with a custom JSON Schema.

Read the integration guide Explore a static sample

How it works

  1. Send a permitted public post URL to POST /v1/extractions, with an API key and a unique idempotency key.
  2. Optionally add an extraction prompt and output.schema for JSON, or output.template for Markdown.
  3. Save the accepted job ID. Poll its resource URL or use a signed webhook to receive the terminal result.

Shape the output for your application

The default JSON response includes acquired source metadata, a summary, key points and an answer when requested. Custom JSON schemas replace that default shape. Successful custom JSON output is validated against your supported schema before credits settle.

{
  "url": "PUBLIC_POST_URL",
  "prompt": "What are the main steps?",
  "output": {
    "format": "json",
    "schema": {
      "type": "object",
      "properties": {
        "steps": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "required": [
        "steps"
      ],
      "additionalProperties": false
    }
  }
}

These are illustrative request bodies. Replace the placeholder with a supported URL. Read the full contract and error cases.

Supported sources and limits

Individual public posts on YouTube, Instagram, TikTok, LinkedIn, Reddit, X and Threads. Profiles, feeds, search results and private sources are outside the beta. Source and caption availability can vary.

Configurable defaults allow videos up to 3 hours, aggregate selected media up to 500 MB per post and batches up to 1,000 URLs. Credits and daily processing quotas also apply. These are limits, not completion-time or availability guarantees.

Beta credits and data handling

The default starter grant is 100 one-time credits for an eligible verified personal workspace. Extraction reserves 5 credits and transcription reserves 2. Successful jobs settle once; failed jobs release their reservation. Rates are provisional and the workspace balance is authoritative.

Read beta credits and limits and data handling and source retention. The anonymous playground uses static fixtures and never fetches your URL.

Keep exploring