Instagram General Search

4.13 credits/call
ae_instagram_general_search

Search Instagram across multiple result types with a keyword. Provide `keyword` to start a search, and optionally provide `pagination_token` from a previous response to retrieve the next page. The response includes general results in `data.items` and may provide another `pagination_token` for continued paging.

Social
4.13 credits/call

Pricing

4.13 credits/call
ConditionCharge
Each call4.13 credits/call

A fixed fee of 4.13 credits is charged per call. Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
keywordstringYes搜索关键词/Search keyword—
pagination_tokenstringNo分页token/Pagination token—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_instagram_general_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "keyword": "Triton",
    "pagination_token": "GU1VCxopAAdzLB4TBl5bRQRFMEUyRB0VAA4Cb1FcSEpGDg8UMGctVhhDF1waAEZfV1ZRTg9FMGotWBsBFUNJFWVDHkIUEAJZA20WVQJPB0pNUDsqEBNCHQYwDAVTCg1HRUdQUDo-FxUMBxgFBgc9TVleQRATHxU6RREVGlwdVwZrZUFNFBADHVoBVxsMERYCBx59ZVAUBwgLUgYDO1UIQAg"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "data": {
      "count": 20,
      "items": [
        {
          "$canonical_discriminator_to_delete_is__TOnXDTMediaDict__141": "XDTMediaDict",
          "_is__TOnXDTMediaDict__141": "XDTMediaDict",
          "ai_label_info": {
            "attribution_label_text": "AI content",
            "gen_ai_detection_method": "AI_CREATED",
            "should_read_attribution_label": true,
            "subtitle_text": "AI content"
          },
          "are_remixes_crosspostable": true,
          "can_reshare": true,
          "can_save": true
        }
      ]
    }
  },
  "docs": "https://api.tikhub.io/#/Instagram-V2-API/general_search_api_v1_instagram_v2_general_search_get",
  "message": "Request successful. This request will incur a charge."
}

This example shows part of the response. Copied content is valid JSON.