Skip to main content
POST
/
v1
/
audience_dimensions
Dimensions
curl --request POST \
  --url https://api.upriver.ai/v1/audience_dimensions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "brand_url": "<string>",
  "response_config": {
    "include_rollup": false,
    "verbosity": "standard",
    "metadata_mode": "basic",
    "max_results": 5,
    "min_confidence": 0.55,
    "max_facts": 25,
    "min_fact_confidence": 0.3,
    "include_evidence_snippets": true,
    "max_snippets_per_fact": 3
  }
}
'
{
  "meta": {
    "generated_at": "2023-11-07T05:31:56Z",
    "industries": [
      "<string>"
    ],
    "continuation_token": "<string>",
    "counts": {
      "total": 123,
      "by_scope": {
        "general": 0,
        "multi_platform": 0,
        "platform_specific": 0
      }
    },
    "source_filters": {
      "platforms": [
        "<string>"
      ],
      "source_names": [
        "<string>"
      ],
      "source_urls": [
        "<string>"
      ],
      "restriction": "none"
    },
    "debug_info": {
      "duration_ms": 123,
      "candidates_before_filter": 123,
      "applied_filters": [
        {
          "name": "<string>",
          "value": "<unknown>",
          "reason": "<string>"
        }
      ]
    },
    "sources_analyzed": [
      "<string>"
    ],
    "content_analyzed_count": 0,
    "pipeline_version": "<string>"
  },
  "brand_name": "<string>",
  "facts": [
    {
      "fact": "<string>",
      "dimension": "behavior",
      "confidence": 0.5,
      "source_count": 2,
      "example_sources": [
        "<string>"
      ],
      "tier": "long_tail",
      "evidence_snippets": [
        {
          "source_id": "<string>",
          "source": "<string>",
          "title": "<string>",
          "text_snippet": "<string>",
          "url": "<string>"
        }
      ]
    }
  ],
  "brand_url": "<string>"
}

Authorizations

X-API-Key
string
header
required

Body

application/json

Input model for audience dimensions extraction.

brand_url
string
required

Brand website URL to analyze

Examples:

"https://drinkolipop.com"

"https://nike.com"

response_config
AudienceDimensionsResponseConfig · object

Output configuration

Response

Successful Response

Response model for audience dimensions extraction.

meta
AudienceDimensionsMeta · object
required

Metadata about sources analyzed

brand_name
string
required

The brand that was analyzed

facts
AudienceFact · object[]
required

Granular audience facts derived from online discussions, sorted by confidence (highest first). Each fact is suitable for embedding-based matching with user facts.

brand_url
string | null

Brand website URL if available