Extraction

Video scraping

Analyzes a video with an AI model and extracts a transcript and data. The analysis takes one to three minutes.

apihttps://api.ideardev.com/api/v1api3https://api3.ideardev.com/api/v1

Models available for the analysis.

api.ideardev.com

curl "https://api.ideardev.com/api/v1/video_scraping_models" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

GET/video_scrapings

Paginated list.

api.ideardev.com

curl "https://api.ideardev.com/api/v1/video_scrapings" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

GET/video_scrapings/{id}

Details and status. This is the polling endpoint.

api.ideardev.com

idpath

curl "https://api.ideardev.com/api/v1/video_scrapings/44" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

POST/video_scrapings

Creates a video scraping.

api.ideardev.com

urlbody

promptbody

curl -X POST "https://api.ideardev.com/api/v1/video_scrapings" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://youtube.com/watch?v=…",
  "prompt": "products mentioned"
}'

PUT/video_scrapings/{id}

Updates the configuration.

api.ideardev.com

idpath

curl -X PUT "https://api.ideardev.com/api/v1/video_scrapings/44" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

DELETE/video_scrapings/{id}

Deletes the video scraping.

api.ideardev.com

idpath

curl -X DELETE "https://api.ideardev.com/api/v1/video_scrapings/44" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

POST/video_scraping_run

Queues the analysis. Poll /video_scrapings/{id} until it finishes.

api3.ideardev.com · runs

idbody

curl -X POST "https://api3.ideardev.com/api/v1/video_scraping_run" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "id": 8
}'

Response

{
  "message": "queued",
  "video_scraping": {
    "id": 8,
    "status": "running"
  }
}

POST/video_scraping_start

Tests the analysis before saving.

api3.ideardev.com · runs

curl -X POST "https://api3.ideardev.com/api/v1/video_scraping_start" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

GET/video_scraping_transcript/{id}

Video transcript.

api.ideardev.com

idpath

curl "https://api.ideardev.com/api/v1/video_scraping_transcript/44" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

POST/video_scraping_chat/{id}

Asks about the video using the conversation history.

api.ideardev.com

idpath

messagebody

historybody

curl -X POST "https://api.ideardev.com/api/v1/video_scraping_chat/44" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "message": "Which prices appear?",
  "history": []
}'

GET/data_video_scrapings/by_video_scraping_id/{id}

Data extracted from the video.

api.ideardev.com

idpath

curl "https://api.ideardev.com/api/v1/data_video_scrapings/by_video_scraping_id/44" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

GET/video_scraping_export/{id}/{type}

Downloads as csv or json.

api.ideardev.com

idpath

typepath

curl "https://api.ideardev.com/api/v1/video_scraping_export/44/json" \
  -H "Authorization: Bearer $IDEARDEV_TOKEN"

curl -X POST "https://api.ideardev.com/api/v1/video_scrapings" \ -H "Authorization: Bearer $IDEARDEV_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "url": "https://youtube.com/watch?v=…", "prompt": "products mentioned" }'

curl -X POST "https://api.ideardev.com/api/v1/video_scraping_chat/44" \ -H "Authorization: Bearer $IDEARDEV_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "message": "Which prices appear?", "history": [] }'