DataForSEO · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for DataForSEO Content Analysis API

12 actions 12 updates phrasing extends openapi/dataforseo-content-analysis-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for DataForSEO's API. It is a proposal applied on top of the contract, not a document DataForSEO publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 12

$.info
$.paths['/v3/content_analysis/id_list'].post
$.paths['/v3/content_analysis/available_filters'].get
$.paths['/v3/content_analysis/locations'].get
$.paths['/v3/content_analysis/languages'].get
$.paths['/v3/content_analysis/categories'].get
$.paths['/v3/content_analysis/search/live'].post
$.paths['/v3/content_analysis/summary/live'].post
$.paths['/v3/content_analysis/sentiment_analysis/live'].post
$.paths['/v3/content_analysis/rating_distribution/live'].post
$.paths['/v3/content_analysis/phrase_trends/live'].post
$.paths['/v3/content_analysis/category_trends/live'].post

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for DataForSEO Content Analysis API
  version: 1.0.0
extends: openapi/dataforseo-content-analysis-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 11
- target: $.paths['/v3/content_analysis/id_list'].post
  update:
    x-apievangelist-phrasing:
      intent: List my Content Analysis task IDs for a period
      effect: read
      questions:
      - Can I see the IDs of all Content Analysis tasks I created in a time window?
      - Which citation or sentiment lookups did I run recently?
      instructions:
      - text: List the IDs and metadata of my Content Analysis tasks for a chosen period.
      - text: Show every Content Analysis task I created this week.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/content_analysis/available_filters'].get
  update:
    x-apievangelist-phrasing:
      intent: List filters for content analysis
      effect: read
      questions:
      - What filters can I apply to citation and sentiment queries?
      - Which fields can I filter on in Content Analysis?
      instructions:
      - text: List the available filters for Content Analysis endpoints.
      - text: Show which citation fields I can filter by.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/content_analysis/locations'].get
  update:
    x-apievangelist-phrasing:
      intent: List locations for content analysis
      effect: read
      questions:
      - Which locations can I scope content citation data to?
      - What location values are supported for brand mention analysis?
      instructions:
      - text: List locations supported by Content Analysis.
      - text: Get the location codes for citation data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/content_analysis/languages'].get
  update:
    x-apievangelist-phrasing:
      intent: List languages for content analysis
      effect: read
      questions:
      - Which languages are covered for content citation analysis?
      - What language codes can I use for brand mention lookups?
      instructions:
      - text: List languages supported by Content Analysis.
      - text: Get the language codes for citation data.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/content_analysis/categories'].get
  update:
    x-apievangelist-phrasing:
      intent: List content categories
      effect: read
      questions:
      - Which product and service categories can I analyze citations for?
      - Is there a list of category codes for content trend queries?
      instructions:
      - text: List all content analysis categories.
      - text: Get the Google product and service category codes used for citations.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/content_analysis/search/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Find detailed citations of a keyword
      effect: read
      questions:
      - Where on the web is my brand or keyword being mentioned?
      - Can I get each individual citation of a keyword with its source page?
      instructions:
      - text: Find detailed web citations of the keyword my brand name.
      - text: List pages that mention this product, with citation details.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/content_analysis/summary/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize citations of a keyword
      effect: read
      questions:
      - What's the overall picture of mentions for a keyword, without listing each one?
      - Can I get aggregate citation counts and top domains for a brand?
      instructions:
      - text: Summarize the citation data for this keyword.
      - text: Give me an overview of how often my brand is mentioned online.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/content_analysis/sentiment_analysis/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Analyze sentiment of keyword citations
      effect: read
      questions:
      - Are mentions of my brand mostly positive or negative?
      - What emotions show up in content citing a keyword?
      instructions:
      - text: Analyze the sentiment of citations for my brand.
      - text: Show the positive, negative and neutral split of mentions of this product.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/content_analysis/rating_distribution/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Get rating distribution for keyword citations
      effect: read
      questions:
      - How are review ratings distributed across content mentioning a keyword?
      - Can I see what share of mentions come with 1 to 5 star ratings?
      instructions:
      - text: Get the rating distribution for citations of this keyword.
      - text: Show how ratings spread across mentions of my product.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/content_analysis/phrase_trends/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Track keyword citations over a date range
      effect: read
      questions:
      - How have mentions of a keyword changed over a period of time?
      - Can I see citation volume for a phrase day by day?
      instructions:
      - text: Show citation trends for this keyword over the last three months.
      - text: Track mentions of my brand name between two dates.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v3/content_analysis/category_trends/live'].post
  update:
    x-apievangelist-phrasing:
      intent: Track citations in a category over a date range
      effect: read
      questions:
      - How have mentions within a product category trended over time?
      - Can I see citation activity for an entire industry category between two dates?
      instructions:
      - text: Show citation trends for a product category over the last quarter.
      - text: Track mentions in the consumer electronics category this year.
      method: generated
      generated: '2026-10-01'